palaia zum Laufen bringen
palaia lebt auf einer Kiste, die immer läuft und die Deine KI-Tools von überall erreichen — ein kleiner Cloud-Server, ein NAS, ein übriger Mini-PC. Am einfachsten richtest Du es ein, indem Du es einen KI-Assistenten für Dich machen lässt; jeden Selbermach-Weg findest Du weiter unten.
Lass Deine KI es einrichten
Du musst kein Terminal anfassen. Kopier den Prompt unten, füg ihn in einen KI-Assistenten ein, den Du schon nutzt, und er liest die Anleitung und führt Dich durch — Schritt für Schritt, in einfacher Sprache.
Richte palaia für mich ein. Lies zuerst get.palaia.ai/skill vollständig — wenn du Befehle ausführen kannst, mit curl, denn ein Web-Abruf liefert dir womöglich nur eine Zusammenfassung. Führ mich dann Schritt für Schritt durch — ich bin kein Techniker, erklär mir alles einfach.
Funktioniert inClaudeChatGPTGemini
Der Assistent fragt, wo palaia laufen soll, und macht den Rest.
Lieber selbst einrichten?
Alle diese Wege enden beim selben hub. Der Cloud-Server-Weg braucht kein Terminal; die anderen sind für Leute, die mit einer Kommandozeile oder Docker vertraut sind.
Ein Cloud-Server in drei Schritten
Kein Terminal, kein SSH. Du fügst eine Datei ein, während Du den Server erstellst, und er richtet sich selbst ein. Jeder kleine Anbieter geht — Hetzner Cloud und DigitalOcean sind gute, günstige Optionen; die kleinste Größe reicht dicke.
Beginn, einen Server zu erstellen
Melde Dich bei Deinem Anbieter an und beginn, einen neuen Server zu erstellen (einen "Cloud Server" oder ein "Droplet"). Wähl irgendein aktuelles Ubuntu- oder Debian-Image und die kleinste Größe — lass die Seite an dem Schritt offen, an dem sie ein Feld Cloud config oder User data anbietet. In dieses Feld kommt die Datei aus Schritt 3.
Denk Dir einen Setup-Code aus
palaia tritt einem Tailnet bei — einem kleinen privaten Netz nur aus Deinen eigenen Geräten (über Tailscale, für private Nutzung kostenlos). So ist Dein Hub von Handy und Laptop erreichbar, aber nie aus dem offenen Internet. Du brauchst ein kostenloses Tailscale-Konto und die Tailscale-App auf dem Gerät, das Du benutzt. Einen Schlüssel musst Du nicht erzeugen: Denk Dir einfach einen Setup-Code aus 12 Buchstaben und Ziffern aus, etwa
K7QM-R2XD-9FTP. Du tippst ihn einmal ein, auf palaias Einrichtungsseite.Diese Datei einfügen, Deinen Code eintragen, den Server erstellen
Kopiere die Datei unten in das Feld Cloud config / User data Deines Anbieters. Ändere die eine markierte Zeile —
PALAIA_SETUP_CODE="setup-code-REPLACE_ME"weit oben — auf Deinen Code aus Schritt 2. Sonst musst Du nichts ändern. Dann erstelle den 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]#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]Ein paar Minuten nach dem Start öffnest Du
http://<Server-Adresse>:8420/, gibst Deinen Code ein, klickst auf Connect with Tailscale und meldest Dich an. Die Seite zeigt die private Adresse Deines Hubs — meisthttp://palaia/— und schließt sich dann endgültig. Kommt er nicht hoch, steht in/var/log/cloud-init-output.logauf dem Server das vollständige Protokoll.
Schon einen Server? Ein Befehl über SSH
Die Datei oben läuft nur beim ersten Start eines Servers — in einen Server, der schon läuft, einzufügen, bewirkt nichts. Für einen Server, den Du schon hast, melde Dich per SSH an und führe diese eine Zeile aus. Der Installer richtet Docker, Tailscale, die Tailnet-only-Firewall und den gehärteten Hub ein, öffnet dann dieselbe einmalige Einrichtungsseite und zeigt ihre Adresse und den Code an:
curl -fsSL https://get.palaia.ai | shcurl -fsSL https://get.palaia.ai | shOder eine Maschine, die Du schon hast
Die Entwickler-Optionen unten installieren denselben hub auf jeder davon:
- Raspberry Pi oder eine andere kleine Kiste, die immer läuft — geht heute mit installiertem 64-Bit Raspberry Pi OS und Docker, dann folgt der Docker-Befehl unten. Ein Karten-Image zum Aufspielen und Starten, das sogar diese Schritte spart, ist geplant und wird öffentlich verfolgt.
- Synology NAS — sein Container Manager führt eine Compose-Datei als "Projekt" aus; kein Terminal auf dem NAS selbst. Siehe die Schritt-für-Schritt-Anleitung für Synology.
- Mac oder Windows — installier einmal Docker Desktop, dann ist der Docker-Desktop-Befehl unten die ganze Installation. (Am besten, um palaia auszuprobieren — für den täglichen Gebrauch gewinnt eine Kiste, die durchläuft.)
Für Entwickler: Docker & Compose
Betreibst Du schon Container? Installier den hub direkt aus dem Image.
Ein Befehl
Auf einer Linux-Maschine mit Docker Engine (ein Heimserver, ein NAS, ein Raspberry Pi) ist das die ganze Installation — palaia antwortet dann unter http://palaia.local:8420/ auf jedem Gerät in Deinem Netzwerk:
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:stableMit Docker Desktop unter macOS oder Windows nimm stattdessen diesen Befehl und öffne http://localhost:8420/ auf diesem Rechner — aus Docker Desktop heraus erreicht ein Name wie palaia.local Dein Netzwerk nicht:
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:stableWillst Du ein Skript, das Docker und Tailscale für Dich installiert und am Ende die Adresse ausgibt? Das ist der eine Befehl über SSH oben — curl … get.palaia.ai | sh.
Eine Datei, die Du behältst
Lieber eine Konfigurationsdatei, die Du bearbeiten und einchecken kannst, oder betreibst Du schon andere Container so? Klon das Repository und starte es mit 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 -dEine fertige docker-compose.yml liegt in diesem Repository unter v3/deploy/ — Du musst nichts selbst schreiben.
App-Stores selbst hosten
Pakete für diese Plattformen werden im Repository gebaut und aktuell gehalten, aber noch ist keins in einem offiziellen App-Katalog gelistet — ein Einreichungsschritt, der noch aussteht und öffentlich verfolgt wird. Bis ein Listing live geht, installieren Docker oder Compose oben dasselbe Image auf jeder von ihnen, denn unter der Haube laufen sie alle mit Containern.
- Umbrelnoch nicht gelistetPaketquelle
- CasaOSnoch nicht gelistetPaketquelle
- Runtipinoch nicht gelistetPaketquelle
- TrueNAS SCALEnoch nicht gelistetPaketquelle
Dann öffne Deinen hub
Bei einer Cloud- oder SSH-Einrichtung öffne die Adresse, die die Einrichtung am Ende ausgibt — meist http://palaia/ — von einem beliebigen Gerät in Deinem tailnet. Auf einer Linux-Maschine in Deinem eigenen Netzwerk öffne http://palaia.local:8420/ von einem beliebigen Gerät dort — oder, falls dieser Name nicht auflöst (manche Netzwerke blockieren ihn; siehe Installieren), die Adresse http://<host>:8420, die ins eigene Log des Containers geschrieben wird und immer funktioniert. Mit Docker Desktop öffne http://localhost:8420/.
Der Assistent übernimmt
Von da an öffnet sich palaias Einrichtung von selbst im Browser: wie Du palaia nutzt, Deine erste Erinnerung, Dein Konto, auf Wunsch der Cloud-Zugang für ChatGPT und Claude, und Deine erste KI-App — kein Bearbeiten von Dateien, keine zusätzlichen Befehle. Siehe Deine erste geteilte Erinnerung, wie das von Anfang bis Ende aussieht, oder Installieren für die ausführliche Fassung von allem auf dieser Seite.