Skip to content

Avvia palaia

palaia vive su una macchina sempre accesa che i tuoi strumenti AI raggiungono da ovunque — un piccolo server cloud, un NAS, un mini-PC che ti avanza. Il modo più semplice per configurarlo è farlo fare a un assistente AI; qui sotto trovi tutti i percorsi fai-da-te.

Fallo configurare dalla tua AI

Non devi toccare nessun terminale. Copia il testo qui sotto, incollalo in un assistente AI che già usi, e lui legge la guida di configurazione e ti accompagna passo dopo passo, in parole semplici — un passaggio alla volta.

Incolla questo nel tuo assistente AI

Configura palaia per me. Prima leggi get.palaia.ai/skill per intero — se puoi eseguire comandi, usa curl, perché un recupero web potrebbe darti solo un riassunto. Poi guidami passo dopo passo — non sono un tecnico, quindi spiega tutto in modo semplice.

Funziona conClaudeChatGPTGemini

L'assistente ti chiede dove far girare palaia e fa tutto il resto.

Preferisci configurarlo da solo?

Tutti questi percorsi arrivano allo stesso hub. Quello con il server cloud non richiede alcun terminale; gli altri sono per chi si trova a suo agio con la riga di comando o con Docker.

Un server cloud in tre passaggi

Niente terminale, niente SSH. Incolli un file quando crei il server e questo si configura da solo. Va bene qualsiasi piccolo provider — Hetzner Cloud e DigitalOcean sono scelte valide ed economiche; la taglia più piccola è più che sufficiente.

  1. Inizia a creare un server

    Accedi al tuo provider e inizia a creare un nuovo server (un "Cloud Server" o un "Droplet"). Scegli una qualsiasi immagine recente di Ubuntu o Debian e la taglia più piccola — lascia la pagina aperta al punto in cui ti offre un campo Cloud config o User data. In quel campo va il file del passaggio 3.

  2. Inventa un codice di configurazione

    palaia entra in una tailnet, una piccola rete privata fatta solo dei tuoi dispositivi (tramite Tailscale, gratuito per uso personale): il tuo hub è raggiungibile da telefono e portatile, ma mai dall'internet aperto. Ti servono un account Tailscale gratuito e l'app Tailscale sul dispositivo che userai. Nessuna chiave da creare: inventa un codice di 12 lettere e cifre, per esempio K7QM-R2XD-9FTP. Lo digiterai una sola volta, nella pagina di configurazione di palaia.

  3. Incolla questo file, inserisci il tuo codice, crea il server

    Copia il file qui sotto nel campo Cloud config / User data del tuo provider. Modifica l'unica riga indicata — PALAIA_SETUP_CODE="setup-code-REPLACE_ME", verso l'inizio — con il tuo codice del passo 2. Nient'altro da modificare. Poi crea il server.

    #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]

    Qualche minuto dopo l'avvio del server, apri http://<indirizzo-del-server>:8420/, inserisci il tuo codice, fai clic su Connect with Tailscale e accedi. La pagina mostra l'indirizzo privato del tuo hub — di solito http://palaia/ — e poi si chiude per sempre. Se non parte, il file /var/log/cloud-init-output.log sul server contiene il registro completo.

Hai già un server? Un comando via SSH

Il file qui sopra viene eseguito solo al primo avvio di un server: incollarlo in una macchina già in funzione non fa nulla. Per un server che hai già, accedi via SSH ed esegui questa riga: l'installer configura Docker, Tailscale, il firewall solo-tailnet e l'hub protetto, poi apre la stessa pagina di configurazione monouso e ne mostra indirizzo e codice:

curl -fsSL https://get.palaia.ai | sh

Oppure una macchina che possiedi già

Le opzioni per sviluppatori qui sotto installano lo stesso hub su una qualsiasi di queste:

  • Raspberry Pi o un'altra piccola macchina sempre accesa — funziona già oggi con Raspberry Pi OS a 64 bit e Docker installato, poi il comando Docker qui sotto. Un'immagine per scheda pronta all'uso che salta anche questi passaggi è pianificata e tracciata in modo aperto.
  • Synology NAS — il suo Container Manager esegue un file Compose come "progetto"; nessun terminale sul NAS stesso. Vedi la guida Synology passo dopo passo.
  • Mac o Windows — installa Docker Desktop una volta, poi il comando Docker Desktop qui sotto è tutta l'installazione. (Ideale per provare palaia — per l'uso di tutti i giorni conviene una macchina che resta accesa.)

Per sviluppatori: Docker & Compose

Fai già girare container? Installa l'hub direttamente dall'immagine.

Un comando

Su una macchina Linux con Docker Engine (un server di casa, un NAS, un Raspberry Pi), questa è tutta l'installazione — poi palaia risponde a http://palaia.local:8420/ da ogni dispositivo della tua rete:

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:stable

Con Docker Desktop su macOS o Windows, usa invece questo e apri http://localhost:8420/ su quel computer — da dentro Docker Desktop un nome come palaia.local non raggiunge la tua rete:

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:stable

Vuoi uno script che installi Docker e Tailscale al posto tuo e stampi l'indirizzo alla fine? È il comando un comando via SSH qui sopra — curl … get.palaia.ai | sh.

Un file che conservi

Preferisci un file di configurazione che puoi modificare e mettere sotto controllo di versione, oppure fai già girare altri container in questo modo? Clona il repository e avvialo con Compose:

git clone https://github.com/byte5ai/palaia.git
cd v3/deploy && docker compose up -d

Un docker-compose.yml pronto all'uso è incluso in quel repository in v3/deploy/ — non devi scrivere nulla da solo.

App store self-hosted

I pacchetti per queste piattaforme vengono costruiti e mantenuti aggiornati nel repository, ma nessuno è ancora presente in un catalogo di app ufficiale — manca ancora un passaggio di invio, tracciato in modo aperto. Finché una voce non sarà pubblicata, Docker o Compose qui sopra installano la stessa immagine su una qualsiasi di esse, dato che tutte fanno girare container sotto il cofano.

Poi apri il tuo hub

Con una configurazione su cloud o via SSH, apri l'indirizzo che la configurazione stampa alla fine — di solito http://palaia/ — da un qualsiasi dispositivo sulla tua tailnet. Su una macchina Linux nella tua rete, apri http://palaia.local:8420/ da un qualsiasi dispositivo di quella rete — oppure, se quel nome non si risolve (alcune reti lo bloccano; vedi Installalo), l'indirizzo http://<host>:8420 stampato nel log del container stesso, che funziona sempre. Con Docker Desktop, apri http://localhost:8420/.

La procedura guidata prende il comando

Da lì la configurazione di palaia si apre da sola nel browser: come userai palaia, la tua prima memoria, il tuo account, l'accesso cloud per ChatGPT e Claude se lo vuoi, e la tua prima app di AI — nessun file da modificare, nessun comando aggiuntivo. Vedi La tua prima memoria condivisa per capire com'è dall'inizio alla fine, oppure Installalo per la versione più estesa di tutto ciò che c'è in questa pagina.