Auto-hébergez votre infrastructure Docker avec Arcane — Une interface Docker moderne

Gérer les conteneurs Docker en ligne de commande est puissant, mais quand votre homelab grandit — avec des dizaines de conteneurs, réseaux, volumes et stacks compose — vous commencez à rêver d'un tableau de bord visuel. Voici Arcane : une interface de gestion Docker moderne, auto-hébergée, construite avec un frontend SvelteKit et un backend Go.

Arcane (5 400+ ⭐ sur GitHub) est conçu pour être l'alternative open-source à Portainer, moderne, rapide et conviviale pour les développeurs. Il gère les conteneurs, les stacks compose, les images, les volumes, les déploiements Git, Docker Swarm, et même la gestion d'hôtes distants via des agents — le tout dans un magnifique tableau de bord sombre.

Pourquoi Arcane est tendance

L'écosystème auto-hébergé a longtemps utilisé Portainer pour la gestion Docker, mais Arcane apporte un regard neuf :

• Stack technique moderne — Frontend SvelteKit (comme ce blog !), backend Go, SQLite (via Turso/LibSQL)
• Interface magnifique — Thème sombre, layout épuré, design responsive
• Prêt pour le GitOps — Déployez des stacks compose directement depuis des dépôts Git avec synchronisation automatique
• Support Docker Swarm — Gérez les stacks et services Swarm aux côtés des conteneurs classiques
• Mode Agent — Gérez à distance plusieurs hôtes Docker via un agent léger
• Sécurité avant tout — Support du Docker Socket Proxy, authentification JWT, clés de chiffrement
• Développement actif — v1.18.x avec des versions toutes les deux semaines, 50+ contributeurs

Architecture

Arcane suit une architecture client-serveur classique. Le backend Go sert de passerelle API, interagissant directement avec le démon Docker via sa socket (ou un proxy TCP). Il maintient sa propre base de données SQLite pour les comptes utilisateurs, les préférences et les configurations de projet. Le frontend SvelteKit communique avec le backend via une API REST, offrant le tableau de bord de gestion dans votre navigateur. Pour les configurations multi-hôtes, des Agents Arcane peuvent être déployés sur des hôtes Docker distants, se connectant à l'instance Arcane principale.

Prérequis

Avant de commencer, assurez-vous d'avoir :

• Un serveur Linux (ou VM) avec Docker installé (v24.0+)
• Docker Compose (v2.0+)
• Un nom de domaine pointant vers votre serveur (optionnel mais recommandé pour HTTPS)
• Une familiarité de base avec Docker et le terminal

Étape 1 — Générer les clés secrètes

Arcane nécessite deux secrets : une ENCRYPTION_KEY et un JWT_SECRET. Générez-les avec OpenSSL :

openssl rand -base64 32
# Copiez la sortie — c'est votre ENCRYPTION_KEY

openssl rand -base64 32
# Copiez la sortie — c'est votre JWT_SECRET

Conservez ces valeurs précieusement — elles servent à chiffrer les données sensibles et signer les jetons d'authentification.

Étape 2 — Déployer Arcane avec Docker Compose

Créez un répertoire pour Arcane et un fichier docker-compose.yml :

mkdir -p ~/arcane && cd ~/arcane

Créez le docker-compose.yml :

services:
  arcane:
    image: ghcr.io/getarcaneapp/arcane:latest
    container_name: arcane
    ports:
      - "3552:3552"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - arcane-data:/app/data
      - ~/arcane-projects:/app/data/projects
    environment:
      - ENCRYPTION_KEY=votre-clé-de-chiffrement-32-caractères
      - JWT_SECRET=votre-super-secret-jwt-a-changer
      - TZ=Europe/Paris
    cgroup: host
    healthcheck:
      test: ["CMD-SHELL", "curl -fsS http://localhost:3552/api/health >/dev/null || exit 1"]
      interval: 10s
      timeout: 3s
      retries: 5
      start_period: 15s
    restart: unless-stopped

volumes:
  arcane-data:

Conseil sécurité : En production, utilisez un Docker Socket Proxy au lieu de monter directement la socket Docker. Voir l'exemple proxy dans le dépôt GitHub d'Arcane.

Lancez Arcane :

docker compose up -d

Attendez quelques secondes, puis vérifiez les logs :

docker compose logs arcane

Vous devriez voir une sortie indiquant que le serveur a démarré sur le port 3552.

Étape 3 — Créer votre premier compte administrateur

Ouvrez votre navigateur et allez sur http://votre-serveur-ip:3552. L'assistant de configuration d'Arcane vous accueillera :

1. Créez votre compte administrateur — nom d'utilisateur, email et mot de passe
2. Explorez le tableau de bord — vos conteneurs, images, volumes et réseaux Docker apparaîtront automatiquement
3. Configurez les paramètres — optionnel : définissez une APP_URL personnalisée, configurez les sauvegardes

Étape 4 — Déployer votre première stack

Arcane rend le déploiement de stacks compose trivial :

1. Cliquez sur Stacks dans la barre latérale
2. Cliquez sur Créer une Stack
3. Donnez-lui un nom (ex : nginx-test)
4. Collez votre YAML compose ou choisissez un dépôt Git
5. Cliquez sur Déployer

Arcane analysera le fichier compose, créera les ressources et affichera les logs de déploiement en direct.

Étape 5 — Configurer le déploiement GitOps

Pour les workflows de production, connectez Arcane à un dépôt Git :

1. Allez dans Paramètres → Synchronisation Git
2. Ajoutez l'URL de votre dépôt et vos identifiants
3. Sélectionnez la branche et le chemin du fichier compose
4. Activez la Synchro Auto — Arcane redéploiera automatiquement lors des pushs

Étape 6 — Sécuriser avec un proxy inverse (Optionnel)

En production, exposez Arcane derrière un proxy inverse avec terminaison SSL :

services:
nginx:
  image: nginx:alpine
  container_name: arcane-proxy
  ports:
    - "80:80"
    - "443:443"
  volumes:
    - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
    - ./ssl:/etc/nginx/ssl:ro
  depends_on:
    - arcane

Définissez ensuite APP_URL=https://arcane.votredomaine.com dans les variables d'environnement d'Arcane.

Comparaison des fonctionnalités

Ressources

• Dépôt GitHub : https://github.com/getarcaneapp/arcane
• Documentation officielle : https://getarcane.app
• Images Docker : ghcr.io/getarcaneapp/arcane
• Licence : BSD-3-Clause

Arcane rend la gestion Docker moderne et accessible. Que vous utilisiez un Raspberry Pi ou un cluster complet, c'est un excellent ajout à votre boîte à outils auto-hébergée.