Skip to content

Mettre palaia en route

palaia vit sur un appareil toujours allumé que vos outils IA peuvent atteindre depuis n'importe où — un petit serveur cloud, un NAS, un mini-PC inutilisé. Le plus simple pour l'installer, c'est de laisser un assistant IA le faire pour vous ; toutes les méthodes à faire soi-même sont plus bas.

Laissez votre IA l'installer

Vous n'avez pas besoin de toucher à un terminal. Copiez l'instruction ci-dessous, collez-la dans un assistant IA que vous utilisez déjà, et il lit le guide d'installation et vous accompagne — une étape à la fois, en langage simple.

Collez ceci dans votre assistant IA

Installe palaia pour moi. Lis d'abord get.palaia.ai/skill en entier — si tu peux exécuter des commandes, utilise curl, car une récupération web ne te donnera peut-être qu'un résumé. Puis guide-moi étape par étape — je ne suis pas technique, alors explique-moi tout simplement.

Fonctionne dansClaudeChatGPTGemini

L'assistant vous demande où palaia doit tourner et fait le reste.

Vous préférez l'installer vous-même ?

Toutes ces méthodes aboutissent au même hub. La méthode serveur cloud ne demande aucun terminal ; les autres s'adressent aux personnes à l'aise avec une ligne de commande ou Docker.

Un serveur cloud en trois étapes

Aucun terminal, aucun SSH. Vous collez un fichier au moment de créer le serveur et il s'installe tout seul. N'importe quel petit fournisseur convient — Hetzner Cloud et DigitalOcean sont de bons choix, peu coûteux ; la plus petite taille suffit amplement.

  1. Commencez à créer un serveur

    Connectez-vous à votre fournisseur et commencez à créer un nouveau serveur (un « Cloud Server » ou un « Droplet »). Choisissez une image Ubuntu ou Debian récente et la plus petite taille — laissez la page ouverte à l'étape où elle propose un champ Cloud config ou User data. C'est dans ce champ que va le fichier de l'étape 3.

  2. Inventez un code de configuration

    palaia rejoint un tailnet — un petit réseau privé composé uniquement de vos propres appareils (via Tailscale, gratuit pour un usage personnel) : votre hub est joignable depuis votre téléphone et votre ordinateur, jamais depuis l'internet ouvert. Il vous faut un compte Tailscale gratuit et l'application Tailscale sur l'appareil que vous utiliserez. Aucune clé à créer : inventez simplement un code de 12 lettres et chiffres, par exemple K7QM-R2XD-9FTP. Vous le saisirez une seule fois, sur la page de configuration de palaia.

  3. Collez ce fichier, saisissez votre code, créez le serveur

    Copiez le fichier ci-dessous dans le champ Cloud config / User data de votre fournisseur. Modifiez la seule ligne indiquée — PALAIA_SETUP_CODE="setup-code-REPLACE_ME", vers le haut — avec votre code de l'étape 2. Rien d'autre à modifier. Puis créez le serveur.

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

    Quelques minutes après le démarrage du serveur, ouvrez http://<adresse-du-serveur>:8420/, saisissez votre code, cliquez sur Connect with Tailscale et connectez-vous. La page affiche l'adresse privée de votre hub — en général http://palaia/ — puis se ferme définitivement. S'il ne démarre pas, le fichier /var/log/cloud-init-output.log du serveur contient le journal complet.

Vous avez déjà un serveur ? Une commande via SSH

Le fichier ci-dessus ne s'exécute qu'au premier démarrage d'un serveur : le coller dans une machine déjà en marche ne fait rien. Pour un serveur existant, connectez-vous en SSH et lancez cette ligne — l'installateur met en place Docker, Tailscale, le pare-feu limité au tailnet et le hub durci, puis ouvre la même page de configuration à usage unique et affiche son adresse et son code :

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

Ou une machine que vous possédez déjà

Les options pour développeurs ci-dessous installent le même hub sur chacune d'elles :

  • Raspberry Pi ou un autre petit appareil toujours allumé — fonctionne dès aujourd'hui avec Raspberry Pi OS 64 bits et Docker installés, puis la commande Docker ci-dessous. Une image de carte à flasher et démarrer, qui éviterait même ces étapes, est prévue et suivie publiquement.
  • Synology NAS — son Container Manager exécute un fichier Compose sous forme de « projet » ; aucun terminal sur le NAS lui-même. Consultez le guide pas à pas pour Synology.
  • Mac ou Windows — installez Docker Desktop une fois, puis la commande Docker Desktop ci-dessous constitue toute l'installation. (Idéal pour essayer palaia — pour un usage quotidien, un appareil qui reste allumé l'emporte.)

Pour les développeurs : Docker et Compose

Vous faites déjà tourner des conteneurs ? Installez le hub directement depuis l'image.

Une seule commande

Sur une machine Linux avec Docker Engine (un serveur à la maison, un NAS, un Raspberry Pi), voici toute l'installation — palaia répond ensuite à http://palaia.local:8420/ depuis chaque appareil de votre réseau :

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

Avec Docker Desktop sur macOS ou Windows, utilisez plutôt celle-ci et ouvrez http://localhost:8420/ sur cet ordinateur — depuis Docker Desktop, un nom comme palaia.local ne peut pas atteindre votre réseau :

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

Vous voulez un script qui installe Docker et Tailscale pour vous et affiche l'adresse à la fin ? C'est la commande unique via SSH ci-dessus — curl … get.palaia.ai | sh.

Un fichier que vous conservez

Vous préférez un fichier de configuration que vous pouvez modifier et versionner, ou vous faites déjà tourner d'autres conteneurs de cette façon ? Clonez le dépôt et lancez-le avec Compose :

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

Un fichier docker-compose.yml prêt à l'emploi est fourni dans ce dépôt, dans v3/deploy/ — rien à écrire vous-même.

Boutiques d'applications d'auto-hébergement

Les paquets pour ces plateformes sont créés et tenus à jour dans le dépôt, mais aucun n'est encore répertorié dans un catalogue d'applications officiel — une étape de soumission reste à venir, suivie publiquement. En attendant qu'une fiche soit en ligne, Docker ou Compose ci-dessus installent la même image sur chacune d'elles, puisqu'elles font toutes tourner des conteneurs en dessous.

Ouvrez ensuite votre hub

Sur une installation cloud ou SSH, ouvrez l'adresse affichée par l'installation une fois terminée — en général http://palaia/ — depuis n'importe quel appareil de votre tailnet. Sur une machine Linux de votre propre réseau, ouvrez http://palaia.local:8420/ depuis n'importe quel appareil de ce réseau — ou, si ce nom ne se résout pas (certains réseaux le bloquent ; voir Installez-le), l'adresse http://<host>:8420 affichée dans le propre journal du conteneur, qui fonctionne toujours. Avec Docker Desktop, ouvrez http://localhost:8420/.

L'assistant prend le relais

À partir de là, la configuration de palaia s'ouvre d'elle-même dans le navigateur : comment vous utiliserez palaia, votre première mémoire, votre compte, l'accès cloud pour ChatGPT et Claude si vous le souhaitez, et votre première app d'IA — aucune modification de fichier, aucune commande supplémentaire. Consultez Votre première mémoire partagée pour voir à quoi cela ressemble de bout en bout, ou Installez-le pour la version détaillée de tout ce qui figure sur cette page.