Arcane : première connexion et accès sécurisé
Installer Arcane 3.x sur un VPS : où trouver le mot de passe initial, et pourquoi lier le port 3552 à 127.0.0.1 avant d'y accéder par Tailscale.
Arcane : la réponse courte
Arcane est une interface web open source pour gérer Docker sur un serveur : conteneurs, images, volumes, réseaux et projets Compose. À la première connexion, l'identifiant est arcane et le mot de passe est aléatoire. Arcane l'écrit au premier démarrage dans le fichier /app/data/initial-admin-password, puis vous oblige à le changer.
Sur un VPS exposé à Internet, ne publiez jamais le port 3552 tel quel. Liez-le à 127.0.0.1, puis ouvrez Arcane par Tailscale ou derrière un reverse proxy en HTTPS. La raison est simple : Arcane pilote le socket Docker, et ce socket donne un contrôle équivalent à root sur la machine.
Le projet est sous licence BSD-3-Clause. Son dépôt GitHub, getarcaneapp/arcane, a été créé le 19 avril 2025. Au 20 novembre 2026, la dernière version publiée est la v3.1.1, sortie le 19 novembre 2026. Ce guide épingle cette version.
Toutes les commandes ci-dessous sont à lancer vous-même, sur un VPS où Docker et le plugin Compose sont déjà installés. Si ce n'est pas encore le cas, commencez par les bases de Docker Compose sur un VPS.
Pourquoi les tutoriels Arcane se contredisent
Arcane 3.0 est sortie le 14 novembre 2026. Ses notes de version annoncent des changements incompatibles sur les anciens protocoles et sur la configuration. Or beaucoup d'articles bien classés ont été écrits pour la branche 2.x. Ils décrivent donc un logiciel différent, sur quatre points.
- Les noms de variables. La 3.0 ajoute le préfixe
ARCANE_et ne lit plus les anciens noms.APP_URLdevientARCANE_APP_URL,ENCRYPTION_KEYdevientARCANE_ENCRYPTION_KEY,PROJECTS_DIRECTORYdevientARCANE_PROJECTS_DIRECTORY.ANALYTICS_DISABLED=truedevientARCANE_ANALYTICS_ENABLED=false, etUPDATE_CHECK_DISABLED=truedevientARCANE_UPDATE_CHECK_ENABLED=false.PUID,PGID,TZetDOCKER_HOSTne changent pas.JWT_SECRETest à supprimer. - Les images. Le gestionnaire s'appelle
ghcr.io/getarcaneapp/manageret l'agentghcr.io/getarcaneapp/agent. L'ancien aliasghcr.io/getarcaneapp/arcane-headlessn'est plus publié. - Les agents. Les agents « directs » ont disparu. Chaque hôte distant est maintenant un agent qui se connecte lui-même au gestionnaire. Le port 3553 des anciens guides ne sert plus : la page de migration demande de supprimer les contrôles de santé (health checks) sur ce port.
- Le mot de passe. Des guides 2.x donnent un couple fixe
arcane/arcane-admin. La documentation 3.x ne mentionne plus ce mot de passe. Le mot de passe initial est généré au hasard.
Le premier point a une conséquence directe. Un docker-compose.yml copié d'un guide 2.x ne démarre pas, car la page de migration précise qu'Arcane 3.0 refuse de démarrer si vous gardez un ancien nom de variable sans son remplaçant ARCANE_. Si un tutoriel écrit APP_URL= ou ENCRYPTION_KEY=, il date d'avant la 3.0.
Le tag v3.1.1 existe-t-il sur ghcr.io ?
Oui. Au 20 novembre 2026, la page des versions du paquet manager sur GitHub liste un tag v3.1.1, avec le v. Il pointe vers le même condensé (digest) que les tags v3.1, v3 et latest.
La documentation d'installation utilise :latest, et la page de migration montre :v3. Épingler v3.1.1 est notre choix, pas une consigne de la documentation. Avec un tag précis, une mise à jour devient une ligne modifiée dans votre fichier, au moment que vous choisissez. Avec latest, un simple docker compose pull peut vous faire passer à une nouvelle version sans que vous ayez lu ses notes.
Vérifiez le tag depuis votre serveur avant de l'écrire dans le fichier :
docker manifest inspect ghcr.io/getarcaneapp/manager:v3.1.1Une sortie JSON signifie que le tag existe. Une erreur signifie que le nom n'existe pas sous cette forme : vérifiez d'abord que vous avez bien écrit le v.
Préparer la clé de chiffrement
Arcane a besoin d'une clé, ARCANE_ENCRYPTION_KEY. La documentation demande une phrase secrète d'au moins 32 caractères. Arcane sait la générer avec une commande ponctuelle :
mkdir -p ~/arcane && cd ~/arcane
docker run --rm ghcr.io/getarcaneapp/manager:v3.1.1 /app/arcane generate secretLa documentation lance cette commande avec :latest. Nous gardons le tag du service, ce qui évite de télécharger une deuxième image. Créez ensuite un fichier .env lisible par vous seul, et collez-y la valeur affichée :
touch .env && chmod 600 .env
nano .envLe fichier contient une seule ligne : ARCANE_ENCRYPTION_KEY= suivi de la valeur générée. Docker Compose lit ce fichier tout seul quand il se trouve à côté de compose.yaml, ce qui garde la clé hors du fichier que vous partagez ou versionnez. Le détail de ce mécanisme est dans notre guide pour garder les secrets d'un projet Compose dans un fichier .env. Gardez aussi une copie de la clé dans votre gestionnaire de mots de passe. Si vous préférez un fichier de secret, la variable ARCANE_ENCRYPTION_KEY_FILE existe aussi.
Le fichier compose.yaml, port fermé au public
Voici le fichier officiel de la documentation, avec trois changements : le tag épinglé, le port lié à 127.0.0.1, et la clé lue depuis .env.
services:
arcane:
image: ghcr.io/getarcaneapp/manager:v3.1.1
container_name: arcane
ports:
- "127.0.0.1:3552:3552"
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- arcane-data:/app/data
- /opt/docker:/opt/docker
environment:
- ARCANE_APP_URL=http://localhost:3552
- PUID=1000
- PGID=1000
- ARCANE_ENCRYPTION_KEY=${ARCANE_ENCRYPTION_KEY}
- ARCANE_PROJECTS_DIRECTORY=/opt/docker
cgroup: host
restart: unless-stopped
volumes:
arcane-data:Ce que font les lignes importantes :
/var/run/docker.sockrelie Arcane au démon Docker. C'est la ligne la plus sensible du fichier, et elle a sa propre section plus bas.arcane-data:/app/dataest le volume qui garde la base de données d'Arcane. C'est aussi là qu'il écrit le mot de passe initial./opt/docker:/opt/dockerest le dossier de vos projets Compose. Le chemin doit être le même des deux côtés. Si vos projets vivent ailleurs, la documentation demande de remplacer les trois valeurs/opt/docker, y compris celle deARCANE_PROJECTS_DIRECTORY. Sans cette variable, Arcane utilise/app/data/projects.PUIDetPGIDfixent l'utilisateur et le groupe du processus. Sans eux, Arcane prend65532:65532. Notre article sur ce que font PUID et PGID dans une image Docker explique comment choisir les bonnes valeurs.ARCANE_APP_URLest l'adresse que vous ouvrirez dans le navigateur. La documentation dit de garderhttp://localhost:3552si vous n'utilisez Arcane que depuis l'hôte Docker. Vous la changerez en passant par Tailscale ou par un proxy.
Faut-il garder cgroup: host ?
La documentation ne dit ni qu'il est obligatoire, ni qu'il est facultatif. La ligne figure dans le fichier officiel, sans explication. L'exemple compose.basic.yaml du dépôt commente la ligne cgroup: host comme une aide pour qu'Arcane détecte son propre conteneur, et la page Podman dit la même chose de cette ligne. Nous l'avons gardée, et nous n'avons pas testé ce qui casse sans elle.
Démarrer et vérifier la liaison du port
sudo mkdir -p /opt/docker
docker compose up -d
docker compose ps
docker compose port arcane 3552docker compose ps doit montrer le service arcane en cours d'exécution. La dernière commande doit afficher 127.0.0.1:3552. Si elle affiche 0.0.0.0:3552, le port est ouvert sur toutes les adresses du serveur.
La syntaxe "127.0.0.1:3552:3552" est la forme Compose de l'exemple docker run -p 127.0.0.1:8080:80 de la documentation Docker, et la documentation Podman d'Arcane l'utilise telle quelle. Faites tout de même un test depuis votre ordinateur, pas depuis le VPS : curl -m 5 http://IP_DU_VPS:3552 doit échouer. S'il renvoie une page, le port est public.
Première connexion : l'utilisateur arcane et le mot de passe généré
Le port n'écoute que sur 127.0.0.1, donc votre navigateur ne peut pas l'atteindre directement. Pour la première connexion, un tunnel SSH suffit. Lancez cette commande sur votre ordinateur :
ssh -L 3552:127.0.0.1:3552 utilisateur@IP_DU_VPSTant que cette session SSH reste ouverte, http://localhost:3552 sur votre ordinateur arrive sur Arcane. C'est aussi l'adresse inscrite dans ARCANE_APP_URL, donc rien d'autre à changer pour l'instant. Sur le VPS, dans le dossier du projet, récupérez le mot de passe :
docker compose cp arcane:/app/data/initial-admin-password .
cat initial-admin-passwordConnectez-vous avec l'utilisateur arcane et ce mot de passe. Arcane vous demande aussitôt d'en choisir un nouveau. Tant que ce n'est pas fait, le serveur répond 403 password change required. Une fois le nouveau mot de passe enregistré, supprimez la copie locale avec rm initial-admin-password.
Le fichier n'existe pas ? La documentation précise qu'Arcane crée l'administrateur au premier démarrage avec une base de données vide. Si le volume arcane-data contient déjà une base, parce que vous avez fait un essai avant, aucun nouvel administrateur n'est créé et aucun fichier n'est écrit. Pour repartir de zéro sur une installation de test, supprimez le volume avec docker compose down -v. Cette commande efface toutes les données d'Arcane, donc ne la lancez jamais sur une instance que vous utilisez déjà.
Fixer le mot de passe dès l'installation
Si vous déployez Arcane de façon automatisée, ARCANE_DEFAULT_ADMIN_PASSWORD fixe le mot de passe initial. Dans ce cas, Arcane ne l'écrit pas dans le fichier et ne demande pas de changement. La valeur doit respecter la politique de mots de passe. Sinon, Arcane écrit un avertissement dans ses journaux et ne crée aucun administrateur tant que vous n'avez pas corrigé la valeur et redémarré. ARCANE_DEFAULT_ADMIN_PASSWORD_FILE lit le mot de passe depuis un fichier, ce qui évite de le laisser dans l'environnement. ARCANE_DEFAULT_ADMIN_USERNAME change le nom, arcane par défaut.
Ces variables ne sont lues qu'à la création de l'administrateur. Elles ne modifient jamais un compte existant. Les ajouter après coup ne réinitialise donc pas un mot de passe oublié. Pour cela, la documentation a une page dédiée à la récupération de compte.
Quels identifiants garde une installation mise à jour depuis la 2.x ?
La documentation ne le dit pas. La page de migration indique seulement que les rôles et les clés d'API sont migrés au démarrage. Elle ne dit rien des utilisateurs, des comptes administrateur ou des mots de passe. Nous ne pouvons donc pas vous promettre que votre ancien mot de passe fonctionne encore, ni le contraire.
Ce qui est documenté : il faut passer par la 2.17.3 avant de monter en 3.0, et la 3.0 ne démarre pas sur une base plus ancienne. Avant la mise à jour, sauvegardez le volume arcane-data. Après, testez votre connexion avant de supprimer cette sauvegarde.
Le socket Docker donne à Arcane le contrôle de la machine
La documentation Docker est claire sur deux points. Le démon Docker tourne toujours en root. Et le groupe docker, qui donne accès au socket, accorde des privilèges de niveau root. La page sécurité de Docker montre aussi qu'un conteneur peut monter le / de l'hôte. Elle en conclut que seuls des utilisateurs de confiance doivent contrôler le démon.
Arcane parle au démon par ce même socket. Quelqu'un qui obtient une session Arcane peut donc lancer un conteneur qui monte la racine du serveur. En pratique, la page de connexion d'Arcane protège votre serveur entier, au même titre que votre accès SSH.
La documentation d'installation d'Arcane le dit en une ligne, à côté du montage du socket : utilisez un proxy de socket pour restreindre l'accès. Un proxy de socket est un petit conteneur placé entre Arcane et /var/run/docker.sock. Il ne laisse passer que les appels d'API qu'une liste autorise.
La page dédiée recommande wollomatic/socket-proxy, qui est aussi ce que produit le générateur d'instance (Instance Generator) d'Arcane. Elle ne conseille Tecnativa que si vous l'utilisez déjà, et précise que cette variante bloque Swarm. L'exemple wollomatic épingle l'image en version 1.13.1 et la durcit : système de fichiers en lecture seule (read_only: true), toutes les capacités Linux retirées (cap_drop: ALL) et no-new-privileges. Le proxy n'accepte que les conteneurs arcane et arcane-upgrader, sur un réseau privé nommé arcane-internal.
Côté Arcane, deux choses changent. La ligne du socket disparaît des volumes, et une variable indique où joindre le proxy :
environment:
- DOCKER_HOST=tcp://docker-socket-proxy:2375Ne recopiez pas la liste d'autorisations à la main. Elle compte des dizaines de chemins d'API écrits en expressions régulières, et une faute de frappe suffit à bloquer une fonction d'Arcane. Copiez l'exemple complet depuis la page « Socket proxy » de la documentation d'Arcane. Faites ensuite deux retouches. Dans le service arcane de cet exemple, remplacez "3552:3552" par "127.0.0.1:3552:3552". Et ne publiez jamais le port 2375 du proxy : sans section ports:, il reste joignable uniquement depuis les réseaux Docker auxquels il est attaché.
Gardez une limite en tête. La page d'Arcane précise que le :ro sur le montage du socket ne rend pas les appels d'API en lecture seule. Il empêche seulement le proxy de modifier le fichier du socket. Elle rappelle aussi que la liste minimale autorise à créer et démarrer des conteneurs, et à lancer exec dedans. Or quiconque peut créer un conteneur peut monter la racine de l'hôte ou lancer un conteneur privilégié. Le proxy réduit la surface d'attaque. Il ne remplace pas un accès bien fermé à l'interface.
Pourquoi un port 3552 publié contourne UFW
C'est l'erreur la plus courante sur un VPS. Vous activez UFW, vous n'autorisez que le port 22, et Arcane reste joignable depuis Internet. La documentation Docker l'explique : les paquets destinés à un port publié sont routés avant que les règles du pare-feu s'appliquent, donc UFW ne les filtre pas. Elle ajoute qu'un port publié sans adresse d'hôte est exposé sur toutes les adresses, 0.0.0.0 et [::].
Un ufw deny 3552 ne change donc rien. La correction se fait dans le fichier Compose, avec l'adresse 127.0.0.1 vue plus haut. Notre article sur les ports Docker qui contournent UFW détaille le mécanisme et les autres façons de le corriger.
Accéder à Arcane par Tailscale
Le tunnel SSH suffit pour un essai. Pour un usage quotidien, Tailscale est plus pratique : seuls vos appareils, connectés au même réseau privé (le tailnet), atteignent l'interface. Le port public reste fermé.
La commande tailscale serve relaie un service local vers votre tailnet, en HTTPS, avec un certificat TLS (transport layer security) fourni automatiquement. Sa syntaxe documentée est tailscale serve --https=<port> <cible>, et seules les cibles http://127.0.0.1 sont acceptées pour un proxy. C'est justement l'adresse où écoute Arcane. Appliquée au port 3552, elle donne :
sudo tailscale serve --bg --https=443 http://127.0.0.1:3552
tailscale serve status--bg laisse le relais actif en arrière-plan. tailscale serve status affiche l'adresse HTTPS à ouvrir. Reportez cette adresse dans ARCANE_APP_URL, puis relancez docker compose up -d pour que le conteneur prenne la nouvelle valeur. Pour arrêter le relais, reprenez la même commande en ajoutant off à la fin.
Une autre méthode existe : publier le port sur l'adresse Tailscale du serveur, donnée par tailscale ip -4, au lieu de 127.0.0.1. Elle n'apporte pas de HTTPS, et la publication peut échouer si cette adresse n'existe pas encore au moment où Docker démarre le conteneur. Si vous la choisissez, redémarrez le VPS une fois et vérifiez docker compose ps. Nous préférons serve, qui garde Arcane sur 127.0.0.1 en toutes circonstances.
Pour un usage personnel, le plan gratuit Personal de Tailscale suffit. Au 20 novembre 2026, sa page de tarifs le donne gratuit, jusqu'à 6 utilisateurs, avec des appareils illimités, pour un usage non commercial. Pour une entreprise, regardez les offres payantes. Si vous vous demandez ce que le service de coordination voit de votre trafic, lisez ce que Tailscale peut voir, et ce qu'il ne voit pas.
Ou derrière un reverse proxy en HTTPS
Si plusieurs personnes doivent accéder à Arcane sans installer Tailscale, un reverse proxy est l'autre voie documentée. La page TLS d'Arcane recommande ce choix pour la plupart des installations : le proxy gère HTTPS, et ARCANE_TLS_ENABLED reste à false. L'exemple nginx de la documentation transmet les requêtes à http://127.0.0.1:3552, ce qui fonctionne avec notre liaison locale.
Mettez alors dans ARCANE_APP_URL l'adresse publique que les utilisateurs ouvrent, par exemple https://arcane.example.com, sans le port interne :3552. Le TLS intégré existe aussi, mais Arcane refuse de démarrer avec ARCANE_TLS_ENABLED=true si le certificat et la clé ne sont pas tous deux définis.
La documentation propose aussi ARCANE_LISTEN=127.0.0.1 pour un proxy sur le même hôte. Dans un conteneur, cette variable agit à l'intérieur du conteneur, pas sur l'hôte. Son interaction avec un port publié n'est pas documentée, et nous ne l'avons pas testée. Gardez la liaison côté Compose, qui se vérifie en une commande.
Attention : avec un reverse proxy, votre page de connexion est sur Internet, et elle protège un accès équivalent à root. Ajoutez au minimum une restriction par adresse IP dans le proxy, ou passez par l'authentification unique décrite ci-dessous.
Remplacer le mot de passe local par l'OIDC
Arcane accepte tout fournisseur OpenID Connect (OIDC). La documentation cite Authentik, Keycloak, Pocket ID et Azure AD. La configuration passe par les variables ARCANE_OIDC_ENABLED, ARCANE_OIDC_CLIENT_ID, ARCANE_OIDC_CLIENT_SECRET, ARCANE_OIDC_ISSUER_URL, ARCANE_OIDC_SCOPES et ARCANE_OIDC_GROUPS_CLAIM.
Dans votre fournisseur, l'URI de redirection est https://<adresse-arcane>/auth/oidc/callback. Écrivez ARCANE_OIDC_ISSUER_URL sans barre oblique finale. Les groupes arrivent par la revendication (claim) groups. Avec Keycloak, il faut un mapper « Group Membership » avec l'option « Full group path » désactivée. Derrière un proxy, ce sont les en-têtes transmis par le proxy qui décident de l'URI de redirection. Si la connexion revient sur une adresse en http:// ou avec :3552, vérifiez la configuration du proxy avant celle d'Arcane.
Sur une installation neuve, ARCANE_DEFAULT_ADMIN_DISABLED=true empêche la création du compte arcane. Ne l'activez que si la connexion OIDC fonctionne déjà, sinon vous n'aurez aucun compte pour entrer.
Gérer un deuxième VPS avec un agent, sans ouvrir de port
Pour gérer un autre serveur, n'exposez pas son socket Docker et n'ouvrez aucun port. En 3.x, le serveur distant fait tourner un agent, avec l'image ghcr.io/getarcaneapp/agent. C'est l'agent qui se connecte au gestionnaire, et il n'écoute sur aucun port. Le serveur distant peut donc rester derrière un NAT (network address translation) ou un pare-feu fermé.
Quand vous ajoutez l'hôte dans Arcane, le gestionnaire émet un jeton d'inscription à usage unique, lié à cet agent, et génère le Compose de l'agent. L'agent ne démarre pas sans ARCANE_MANAGER_API_URL et ARCANE_AGENT_TOKEN. Gardez son /app/data sur un volume persistant. Sans lui, l'agent s'inscrit de nouveau à chaque redémarrage, et le jeton déjà utilisé est refusé. Le transport par défaut est ARCANE_AGENT_TRANSPORT=auto. Les autres valeurs possibles sont websocket et grpc.
Quelques points pratiques :
- L'agent doit joindre l'adresse du gestionnaire. Si votre Arcane n'est accessible que par Tailscale, mettez aussi le deuxième VPS dans le tailnet.
- Le Compose généré monte
/var/run/docker.sockdirectement. Le raisonnement sur le socket vaut donc aussi pour ce serveur. - Derrière Traefik, la documentation prévient que le point d'entrée HTTPS coupe les connexions après 60 secondes par défaut, ce qui interrompt le flux gRPC de l'agent.
- Un ancien contrôle comme
curl http://localhost:3553/api/healthne peut plus réussir, puisque l'agent n'écoute sur aucun port. Supprimez-le de vos scripts de supervision.
Arcane gère aussi Podman. Il le détecte seul et ajoute une section Podman à l'interface. La documentation Podman monte le socket Podman à l'emplacement /var/run/docker.sock du conteneur, et rappelle qu'il donne à Arcane le contrôle de tous les conteneurs de l'utilisateur Linux concerné. Si vous hésitez encore entre Arcane et une plateforme plus complète, notre comparatif de Cloudron, CasaOS et Coolify couvre cette autre famille d'outils.
FAQ
Quel est le mot de passe par défaut d'Arcane ?
En version 3.x, il n'y a pas de mot de passe fixe. L'utilisateur est arcane, et Arcane génère un mot de passe aléatoire au premier démarrage avec une base vide. Il l'écrit dans /app/data/initial-admin-password, que vous copiez avec docker compose cp arcane:/app/data/initial-admin-password .. Arcane vous oblige ensuite à le changer. Le couple arcane / arcane-admin vient de guides écrits pour la 2.x.
Pourquoi mon ancien fichier Compose d'Arcane ne démarre plus ?
La 3.0 a renommé les variables avec le préfixe ARCANE_ et ne lit plus les anciens noms. Elle refuse de démarrer si une ancienne variable reste sans son remplaçant. Remplacez APP_URL, ENCRYPTION_KEY et PROJECTS_DIRECTORY par leurs versions ARCANE_, supprimez JWT_SECRET, et utilisez l'image ghcr.io/getarcaneapp/manager. Pour une mise à jour, passez aussi par la 2.17.3 avant de monter en 3.0.
Arcane est-il sûr sur un VPS exposé à Internet ?
Oui, à condition que l'interface ne soit pas publique. Arcane contrôle le socket Docker, qui donne un accès équivalent à root. Publiez le port sur 127.0.0.1:3552 plutôt que sur 3552, car un port publié par Docker contourne UFW. Ouvrez ensuite Arcane par Tailscale, ou derrière un reverse proxy HTTPS avec OIDC, et ajoutez le proxy de socket recommandé par la documentation.
Faut-il ouvrir le port 3553 pour les agents Arcane ?
Non. Le port 3553 servait aux agents directs des versions 2.x, qui ont disparu en 3.0. Un agent 3.x, image ghcr.io/getarcaneapp/agent, se connecte lui-même au gestionnaire avec un jeton d'inscription à usage unique et n'écoute sur aucun port. Le serveur distant n'a besoin d'aucune règle entrante. Il doit seulement pouvoir joindre l'adresse du gestionnaire.