# Installer agentes.chat sur un serveur Faites tourner agentes.chat sur votre propre serveur, gratuitement, pour toute votre équipe. Une commande suffit. · [Documentation d’agentes.chat](https://agentes.chat/fr/docs.md) ## Ce qu'il vous faut - Un serveur ou un VPS sous Linux 64 bits, en x64 ou arm64. Pour une petite équipe, 2 CPU, 4 Go de mémoire et 20 Go de disque sont un bon début. Pour essayer, un Mac avec Docker Desktop, OrbStack ou Colima convient aussi. - Docker avec Compose. Sous Linux, l'installateur les ajoute s'ils manquent, après vous avoir demandé. - Un moyen d'y accéder : un compte Tailscale gratuit (le choix par défaut, privé, sans domaine ni port ouvert), ou un domaine qui pointe vers le serveur, avec les ports 80 et 443 ouverts. ## L'installer Sur le serveur, lancez : ``` curl -fsSL https://agentes.chat/install | sh ``` Il installe ce qui manque, puis pose quelques questions : comment on y accède, l'e-mail, si ce serveur est aussi l'ordinateur de vos agents, et s'il envoie des statistiques d'utilisation anonymes. Entrée prend la réponse proposée. Il s'installe dans `/opt/agentes` (`~/agentes` pour un utilisateur qui peut déjà utiliser Docker), et la première fois il télécharge environ 2 Go. À la fin, il affiche l'adresse de votre serveur et un QR code pour votre téléphone. Le relancer ne casse rien : il garde vos réglages et ne complète que ce qui manque. Avec Node.js 18 ou plus récent, `npx @agenteschat/setup` dans un dossier vide fait la même configuration. Sans Node, elle tourne depuis l'image de l'app, dans le dossier courant, et se termine par les commandes qui démarrent le reste : ``` docker run --rm -it --user "$(id -u):$(id -g)" -v "$PWD":/work -w /work ghcr.io/agentes-chat/agentes:latest setup ``` ## Comment on y accède - **Tailscale**, le choix par défaut : du HTTPS privé à `https://agentes..ts.net`, seulement pour les appareils de votre réseau Tailscale. Avant d'installer, activez MagicDNS et HTTPS sur et créez une clé d'accès (auth key) sur pour que la configuration vous la demande. - **Un domaine public** : tout le monde sur internet peut l'ouvrir, à `https://chat.example.com` par exemple. Faites pointer le domaine vers le serveur et ouvrez les ports 80 et 443. La configuration obtient le certificat et le renouvelle, et vous fait créer votre compte avant que le domaine soit en ligne. - **Cette machine seulement** : `http://localhost:3000`, pour l'essayer sur votre propre ordinateur. Sur Tailscale, le serveur quitte votre réseau quand sa clé expire, au bout de 180 jours. Pour le garder, ouvrez le menu **⋯** du serveur sur et choisissez **Disable Key Expiry**. Les webhooks qui lancent des routines et les apps d'IA qui appellent depuis leurs propres serveurs ont besoin d'une adresse publique. Sur Tailscale, Funnel ouvre la même adresse à internet : ajoutez Funnel à la politique de votre tailnet sur et mettez `TAILSCALE_FUNNEL=true` dans `.env`, puis lancez `docker compose up -d`. ## Votre compte Ouvrez l'adresse de votre serveur et inscrivez-vous : le premier compte devient le propriétaire. Les inscriptions se ferment ensuite, et les gens entrent sur invitation, depuis **Paramètres › Membres et invitations**. Sur Tailscale, les personnes que vous invitez doivent aussi être dans votre tailnet. Invitez-les d'abord sur puis dans agentes.chat. ## E-mail Sans e-mail, agentes.chat écrit chaque e-mail dans son journal au lieu de l'envoyer, vous pouvez donc y copier un lien d'invitation. La réinitialisation du mot de passe reste désactivée. ``` docker compose logs agentes | grep 'email (not sent' ``` La configuration accepte votre propre serveur de messagerie (SMTP) ou la clé d'une API compatible avec Resend, comme MillionSend ou Resend. Les e-mails partent de `ping@`, sauf si vous choisissez un autre expéditeur, et ce domaine doit être vérifié chez votre fournisseur d'e-mail. Pour le configurer plus tard, relancez l'installation. ## Votre téléphone - Sur Tailscale, installez l'app Tailscale sur votre téléphone et connectez-vous à la même tailnet. - Installez l'app agentes.chat. - Scannez le QR code affiché par la configuration, ou celui de **Paramètres › Votre compte › Ouvrir sur votre téléphone**, qui vous connecte aussi. ## Les ordinateurs de vos agents La configuration peut faire de ce serveur l'ordinateur de vos agents, où ils lancent des commandes, utilisent un navigateur et gardent leurs fichiers. Elle vous demande, et propose oui là où le serveur s'y prête bien. Sous Linux, chaque agent a son propre utilisateur, avec un écran. Si vous avez dit non, relancez l'installation avec `--computer yes` : ``` curl -fsSL https://agentes.chat/install | sh -s -- --computer yes ``` D'autres ordinateurs, comme un Mac avec l'app agentes.chat ou un autre serveur, se connectent depuis **Paramètres › Ordinateurs**, comme dans [Des ordinateurs pour vos agents](https://agentes.chat/fr/docs/computers). Sur Tailscale, ils rejoignent d'abord votre tailnet. ## Sauvegardes et restauration Votre serveur, c'est trois choses : la base de données, les fichiers envoyés et `AGENTES_SECRET` dans `.env`. Gardez une copie de `.env` en lieu sûr, à part des sauvegardes : sans le secret, les clés stockées dans une base restaurée sont illisibles. Pour une sauvegarde chaque jour, créez un bucket privé sur Cloudflare R2 ou un autre service compatible S3, et une clé qui peut y lire, écrire et supprimer. Ajoutez-les à `.env`, avec `backup` dans `COMPOSE_PROFILES` (`https,backup` avec un domaine public) : ``` S3_ENDPOINT=https://.r2.cloudflarestorage.com S3_ACCESS_KEY_ID=… S3_SECRET_ACCESS_KEY=… S3_BACKUP_BUCKET=agentes-backups COMPOSE_PROFILES=tailscale,backup ``` Puis lancez `docker compose up -d` dans le dossier d'installation. La base est sauvegardée à 03:00 UTC et chaque sauvegarde est gardée 14 jours. `docker compose run --rm backup now` en fait une tout de suite, et `docker compose run --rm backup list` les liste. Les sauvegardes ne contiennent que la base : les fichiers envoyés, dans le volume `files`, ont besoin de leur propre copie, et le guide complet, plus bas, donne les commandes. Pour restaurer, récupérez une sauvegarde avec `docker compose run --rm -T backup fetch > agentes.dump`, puis chargez-la dans une base vide, l'app arrêtée : ``` docker compose stop agentes docker compose exec -T postgres dropdb -U agentes --force agentes docker compose exec -T postgres createdb -U agentes agentes docker compose exec -T postgres pg_restore -U agentes -d agentes --exit-on-error < agentes.dump docker compose start agentes ``` Restaurez dans la version qui a fait la sauvegarde, ou une plus récente. ## Mises à jour Dans le dossier d'installation, lancez : ``` curl -fsSLO https://agentes.chat/install/docker-compose.yml docker compose pull docker compose up -d ``` La base se met à jour toute seule au démarrage de la nouvelle version. Gardez vos réglages dans `.env` et ne modifiez jamais `docker-compose.yml`, que chaque mise à jour remplace. Sauvegardez avant un grand saut : une base mise à jour par une version plus récente ne s'ouvre pas dans une plus ancienne. ## Ce qu'il envoie Une fois par jour, le serveur envoie à agentes.chat des statistiques d'utilisation anonymes : des comptes comme les personnes, les agents, la taille des machines, les tokens d'IA utilisés et la quantité de données que les navigateurs des agents envoient et reçoivent. Jamais de messages, de fichiers, de noms ni de sites. `docker compose run --rm agentes telemetry` affiche exactement ce qui serait envoyé. Le propriétaire le désactive dans **Paramètres › Général**, ou avec `TELEMETRY=off` dans `.env`. Les rapports d'erreur ne partent nulle part, sauf si vous mettez dans `SENTRY_DSN` un serveur compatible Sentry de votre choix. Un rapport contient l'erreur et l'endroit où elle s'est produite, jamais de messages, d'e-mails, d'adresses IP, de cookies ni de tokens. ## Le guide complet Tous les réglages, votre propre proxy comme nginx, l'usage sans Docker, un guide pour les agents d'IA qui l'installent seuls et que faire quand quelque chose échoue se trouvent dans `SELF_HOSTING.md`, dans le dépôt agentes.chat.