Pon palaia en marcha
palaia vive en un equipo siempre encendido al que tus herramientas de IA llegan desde cualquier lugar: un pequeño servidor en la nube, un NAS, un mini-PC que te sobre. La forma más sencilla de configurarlo es dejar que lo haga por ti un asistente de IA; más abajo tienes todas las opciones para hacerlo tú mismo.
Deja que tu IA lo configure
No tienes que tocar ninguna terminal. Copia el mensaje de abajo, pégalo en un asistente de IA que ya uses, y él lee la guía de instalación y te acompaña paso a paso, con palabras sencillas.
Configúrame palaia. Primero lee get.palaia.ai/skill entero; si puedes ejecutar comandos, usa curl, porque una consulta web quizá solo te dé un resumen. Luego guíame paso a paso. No soy una persona técnica, así que explícamelo todo de forma sencilla.
Funciona enClaudeChatGPTGemini
El asistente te pregunta dónde debe funcionar palaia y hace el resto.
¿Prefieres configurarlo tú mismo?
Todas estas opciones terminan en el mismo hub. La opción del servidor en la nube no necesita terminal; las demás son para quienes se manejan con la línea de comandos o con Docker.
Un servidor en la nube en tres pasos
Sin terminal, sin SSH. Pegas un archivo al crear el servidor y él se configura solo. Sirve cualquier proveedor pequeño: Hetzner Cloud y DigitalOcean son buenas opciones y baratas; con el tamaño más pequeño te sobra.
Empieza a crear un servidor
Inicia sesión en tu proveedor y empieza a crear un servidor nuevo (un "Cloud Server" o "Droplet"). Elige cualquier imagen reciente de Ubuntu o Debian y el tamaño más pequeño; deja la página abierta en el paso donde te ofrece un campo Cloud config o User data. Ahí es donde va el archivo del paso 3.
Inventa un código de configuración
palaia se une a una tailnet: una pequeña red privada formada solo por tus propios dispositivos (mediante Tailscale, gratis para uso personal), así que tu hub es accesible desde tu móvil y tu portátil, pero nunca desde el internet abierto. Necesitas una cuenta gratuita de Tailscale y la app de Tailscale en el dispositivo que vayas a usar. No hay que crear ninguna clave: inventa un código de 12 letras y cifras, por ejemplo
K7QM-R2XD-9FTP. Lo escribirás una sola vez, en la página de configuración de palaia.Pega este archivo, pon tu código y crea el servidor
Copia el archivo de abajo en el campo Cloud config / User data de tu proveedor. Cambia la única línea marcada —
PALAIA_SETUP_CODE="setup-code-REPLACE_ME", cerca del principio — por tu código del paso 2. No hay que editar nada más. Después crea el servidor.#cloud-config # palaia v3 — VPS install (SPEC-601). Paste this whole file into your # provider's server-creation user-data field — Hetzner Cloud calls it # "Cloud config", DigitalOcean calls it "User data" — then create # the server. Everything below runs itself: no terminal, no SSH session # needed to finish setup. # # ONE THING TO EDIT — find this line further down and replace the # placeholder with a setup code of your own (12 letters/digits, e.g. # K7QM-R2XD-9FTP; your AI assistant can make one up for you): # # PALAIA_SETUP_CODE="setup-code-REPLACE_ME" # # A few minutes after the server starts, open http://<server-address>:8420/, # enter that code and click "Connect with Tailscale" — the server joins your # private network (tailnet). The same page then offers cloud access for # ChatGPT and Claude, and closes itself (SPEC-605). # # Prefer a key? Instead fill in the TAILSCALE_AUTH_KEY line below with an # auth key from https://login.tailscale.com/admin/settings/keys; then no # setup page is shown. Use a one-time key: it also stays in the provider's # copy of this file. Nothing else in this file needs to change. # # What it does: runs palaia's installer (https://get.palaia.ai/install, the # same script as `curl -fsSL https://get.palaia.ai | sh`), which installs # Docker and Tailscale, joins your tailnet, switches the firewall on (SSH # stays open) and starts the hub bound to the tailnet address only — so the # hub is never reachable from the public internet, only from your own # devices. See v3/deploy/README.md's "Cloud-init" section for what the data # volume holds and how to back it up or move it. # # This runs once per server — cloud-init's own rule. Running it again by # hand (`sudo sh /opt/palaia/cloud-init-setup.sh`) is safe: the installer # keeps your data and changes nothing that is already in place. # # Everything this does is also logged to /var/log/cloud-init-output.log — # check there first if the hub does not come up. package_update: true packages: - ca-certificates - curl - python3 - ufw write_files: - path: /opt/palaia/cloud-init-setup.sh permissions: "0700" owner: root:root content: | #!/bin/sh # Written by cloud-init.yaml — see that file for the one thing to # edit. Safe to run again: the installer keeps what is already done. set -eu log() { echo "palaia cloud-init: $*"; } PALAIA_SETUP_CODE="setup-code-REPLACE_ME" TAILSCALE_AUTH_KEY="tskey-REPLACE_ME" INSTALLER_URL="https://get.palaia.ai/install" # Which way to join the tailnet: a filled-in key wins; otherwise the # setup page with the filled-in code. The checks below look only for # the marker word, so a copy where every placeholder was replaced # still passes them. USE_KEY=1 case "${TAILSCALE_AUTH_KEY}" in *REPLACE_ME*|"") USE_KEY=0 ;; esac if [ "$USE_KEY" = "0" ]; then case "${PALAIA_SETUP_CODE}" in *REPLACE_ME*|"") log "ERROR: edit this file's PALAIA_SETUP_CODE (or TAILSCALE_AUTH_KEY) before pasting it." exit 1 ;; esac fi # --- Run the installer ---------------------------------------------- log "downloading the installer from ${INSTALLER_URL} ..." curl -fsSL --retry 5 --retry-delay 5 "${INSTALLER_URL}" -o /opt/palaia/get-palaia.sh # The key goes into a file only root can read — only now, once the # installer is here to delete it again: it hands the key to Tailscale # as `--auth-key=file:...` (never a command-line argument) and removes # the file however it ends. if [ "$USE_KEY" = "1" ]; then ( umask 077 && printf '%s' "${TAILSCALE_AUTH_KEY}" > /root/.palaia-tskey ) export PALAIA_TSKEY_FILE=/root/.palaia-tskey fi export PALAIA_SETUP_CODE # A server created for palaia: switch ufw on (SSH stays open). export PALAIA_FIREWALL=on log "running the installer ..." sh /opt/palaia/get-palaia.sh </dev/null runcmd: - [sh, /opt/palaia/cloud-init-setup.sh]#cloud-config # palaia v3 — VPS install (SPEC-601). Paste this whole file into your # provider's server-creation user-data field — Hetzner Cloud calls it # "Cloud config", DigitalOcean calls it "User data" — then create # the server. Everything below runs itself: no terminal, no SSH session # needed to finish setup. # # ONE THING TO EDIT — find this line further down and replace the # placeholder with a setup code of your own (12 letters/digits, e.g. # K7QM-R2XD-9FTP; your AI assistant can make one up for you): # # PALAIA_SETUP_CODE="setup-code-REPLACE_ME" # # A few minutes after the server starts, open http://<server-address>:8420/, # enter that code and click "Connect with Tailscale" — the server joins your # private network (tailnet). The same page then offers cloud access for # ChatGPT and Claude, and closes itself (SPEC-605). # # Prefer a key? Instead fill in the TAILSCALE_AUTH_KEY line below with an # auth key from https://login.tailscale.com/admin/settings/keys; then no # setup page is shown. Use a one-time key: it also stays in the provider's # copy of this file. Nothing else in this file needs to change. # # What it does: runs palaia's installer (https://get.palaia.ai/install, the # same script as `curl -fsSL https://get.palaia.ai | sh`), which installs # Docker and Tailscale, joins your tailnet, switches the firewall on (SSH # stays open) and starts the hub bound to the tailnet address only — so the # hub is never reachable from the public internet, only from your own # devices. See v3/deploy/README.md's "Cloud-init" section for what the data # volume holds and how to back it up or move it. # # This runs once per server — cloud-init's own rule. Running it again by # hand (`sudo sh /opt/palaia/cloud-init-setup.sh`) is safe: the installer # keeps your data and changes nothing that is already in place. # # Everything this does is also logged to /var/log/cloud-init-output.log — # check there first if the hub does not come up. package_update: true packages: - ca-certificates - curl - python3 - ufw write_files: - path: /opt/palaia/cloud-init-setup.sh permissions: "0700" owner: root:root content: | #!/bin/sh # Written by cloud-init.yaml — see that file for the one thing to # edit. Safe to run again: the installer keeps what is already done. set -eu log() { echo "palaia cloud-init: $*"; } PALAIA_SETUP_CODE="setup-code-REPLACE_ME" TAILSCALE_AUTH_KEY="tskey-REPLACE_ME" INSTALLER_URL="https://get.palaia.ai/install" # Which way to join the tailnet: a filled-in key wins; otherwise the # setup page with the filled-in code. The checks below look only for # the marker word, so a copy where every placeholder was replaced # still passes them. USE_KEY=1 case "${TAILSCALE_AUTH_KEY}" in *REPLACE_ME*|"") USE_KEY=0 ;; esac if [ "$USE_KEY" = "0" ]; then case "${PALAIA_SETUP_CODE}" in *REPLACE_ME*|"") log "ERROR: edit this file's PALAIA_SETUP_CODE (or TAILSCALE_AUTH_KEY) before pasting it." exit 1 ;; esac fi # --- Run the installer ---------------------------------------------- log "downloading the installer from ${INSTALLER_URL} ..." curl -fsSL --retry 5 --retry-delay 5 "${INSTALLER_URL}" -o /opt/palaia/get-palaia.sh # The key goes into a file only root can read — only now, once the # installer is here to delete it again: it hands the key to Tailscale # as `--auth-key=file:...` (never a command-line argument) and removes # the file however it ends. if [ "$USE_KEY" = "1" ]; then ( umask 077 && printf '%s' "${TAILSCALE_AUTH_KEY}" > /root/.palaia-tskey ) export PALAIA_TSKEY_FILE=/root/.palaia-tskey fi export PALAIA_SETUP_CODE # A server created for palaia: switch ufw on (SSH stays open). export PALAIA_FIREWALL=on log "running the installer ..." sh /opt/palaia/get-palaia.sh </dev/null runcmd: - [sh, /opt/palaia/cloud-init-setup.sh]Unos minutos después de que arranque el servidor, abre
http://<dirección-del-servidor>:8420/, escribe tu código, pulsa Connect with Tailscale e inicia sesión. La página muestra la dirección privada de tu hub (normalmentehttp://palaia/) y luego se cierra para siempre. Si no arranca, el archivo/var/log/cloud-init-output.logdel servidor tiene el registro completo.
¿Ya tienes un servidor? Un comando por SSH
El archivo de arriba solo se ejecuta en el primer arranque de un servidor, así que pegarlo en una máquina que ya está en marcha no hace nada. Para un servidor que ya tienes, entra por SSH y ejecuta esta línea: el instalador configura Docker, Tailscale, el cortafuegos solo para la tailnet y el hub reforzado, y luego abre la misma página de configuración de un solo uso y muestra su dirección y su código:
curl -fsSL https://get.palaia.ai | shcurl -fsSL https://get.palaia.ai | shO una máquina que ya tienes
Las opciones para desarrolladores de abajo instalan el mismo hub en cualquiera de estas:
- Raspberry Pi u otro equipo pequeño siempre encendido: funciona hoy mismo con Raspberry Pi OS de 64 bits y Docker instalados, y luego el comando de Docker de abajo. Ya está planificada y se sigue de forma abierta una imagen de tarjeta lista para grabar y arrancar que se salta incluso esos pasos.
- Synology NAS: su Container Manager ejecuta un archivo de Compose como un "proyecto"; sin terminal en el propio NAS. Consulta la guía paso a paso de Synology.
- Mac o Windows: instala Docker Desktop una vez y, luego, el comando de Docker Desktop de abajo es toda la instalación. (Ideal para probar palaia; para el uso diario, gana un equipo que se quede encendido.)
Para desarrolladores: Docker y Compose
¿Ya ejecutas contenedores? Instala el hub directamente desde la imagen.
Un comando
En una máquina Linux con Docker Engine (un servidor en casa, un NAS, una Raspberry Pi), esta es toda la instalación; después, palaia responde en http://palaia.local:8420/ desde cualquier dispositivo de tu red:
docker run -d --name palaia \
--network host -e PALAIA_CLOUD_BIND=127.0.0.1 \
-v palaia_home:/data \
--restart unless-stopped \
--security-opt no-new-privileges:true --cap-drop ALL \
--read-only --tmpfs /tmp --tmpfs /run \
ghcr.io/byte5ai/palaia:stabledocker run -d --name palaia \
--network host -e PALAIA_CLOUD_BIND=127.0.0.1 \
-v palaia_home:/data \
--restart unless-stopped \
--security-opt no-new-privileges:true --cap-drop ALL \
--read-only --tmpfs /tmp --tmpfs /run \
ghcr.io/byte5ai/palaia:stableCon Docker Desktop en macOS o Windows, usa este otro y abre http://localhost:8420/ en ese ordenador; desde Docker Desktop, un nombre como palaia.local no puede llegar a tu red:
docker run -d --name palaia \
-p 8420:8420 \
-v palaia_home:/data \
--restart unless-stopped \
--security-opt no-new-privileges:true --cap-drop ALL \
--read-only --tmpfs /tmp --tmpfs /run \
ghcr.io/byte5ai/palaia:stabledocker run -d --name palaia \
-p 8420:8420 \
-v palaia_home:/data \
--restart unless-stopped \
--security-opt no-new-privileges:true --cap-drop ALL \
--read-only --tmpfs /tmp --tmpfs /run \
ghcr.io/byte5ai/palaia:stable¿Quieres un script que instale Docker y Tailscale por ti y muestre la dirección al final? Ese es el comando por SSH de arriba: curl … get.palaia.ai | sh.
Un archivo que conservas
¿Prefieres un archivo de configuración que puedas editar y versionar, o ya ejecutas otros contenedores así? Clona el repositorio e inícialo con Compose:
git clone https://github.com/byte5ai/palaia.git
cd v3/deploy && docker compose up -dgit clone https://github.com/byte5ai/palaia.gitcd v3/deploy && docker compose up -dEn ese repositorio, en v3/deploy/, viene un docker-compose.yml listo para usar; no tienes que escribir nada tú.
Tiendas de apps para autoalojamiento
Los paquetes para estas plataformas se compilan y se mantienen al día en el repositorio, pero todavía ninguno figura en un catálogo de apps oficial: falta un paso de envío que se sigue de forma abierta. Hasta que aparezca en el catálogo, Docker o Compose de arriba instalan la misma imagen en cualquiera de ellas, ya que todas ejecutan contenedores por debajo.
- Umbrelaún sin listarcódigo del paquete
- CasaOSaún sin listarcódigo del paquete
- Runtipiaún sin listarcódigo del paquete
- TrueNAS SCALEaún sin listarcódigo del paquete
Luego abre tu hub
En una instalación en la nube o por SSH, abre la dirección que muestra la instalación al terminar (normalmente http://palaia/) desde cualquier dispositivo de tu tailnet. En una máquina Linux de tu propia red, abre http://palaia.local:8420/ desde cualquier dispositivo de esa red; o, si ese nombre no se resuelve (algunas redes lo bloquean; consulta Instálalo), la dirección http://<host>:8420 que se muestra en el propio registro del contenedor, que siempre funciona. Con Docker Desktop, abre http://localhost:8420/.
El asistente toma el control
A partir de ahí, la configuración de palaia se abre sola en el navegador: cómo usarás palaia, tu primera memoria, tu cuenta, el acceso en la nube para ChatGPT y Claude si lo quieres, y tu primera app de IA; sin editar archivos ni comandos adicionales. Consulta Tu primera memoria compartida para ver cómo es todo el proceso de principio a fin, o Instálalo para la versión más extensa de todo lo de esta página.