Utiliser le générateur docker-compose pas à pas

Mon serveur installe tout un serveur d’un coup. Le générateur docker-compose, lui, prépare une seule application, pour un serveur qui existe déjà. Ce guide détaille chaque option et la mise en route du résultat.

Débutant ou expert ?

Débutant : chaque ligne du fichier est expliquée par un commentaire en français. Idéal pour apprendre, et sans effet sur le fonctionnement.
Expert : fichier sans commentaires, et réglages Traefik avancés (nom du réseau, entrypoint, resolver de certificats) si les vôtres ne s’appellent pas comme d’habitude.

Choisir l’application et son adresse

Choisissez l’application dans la liste, puis son adresse (vault.mondomaine.fr). Pour les applications de médias (Jellyfin, Navidrome…), indiquez le dossier du serveur où sont vos fichiers : il sera monté en lecture seule.

Astuce : depuis la fiche d’une application du catalogue, le bouton « Générer le docker-compose » ouvre directement le générateur sur la bonne application.

« Comment y accéder ? » : l’option qui compte

Option	Choisissez-la si…	Ce que fait le fichier
Avec Traefik	Traefik tourne déjà (installé par Mon serveur, par exemple)	Ajoute les labels : HTTPS automatique, rien d’autre à faire
Avec Caddy (dans Docker)	Caddy tourne dans un conteneur, sur le réseau `caddy`	Rejoint le réseau ; vous ajoutez une ligne au Caddyfile
Avec Nginx Proxy Manager	Vous utilisez NPM	Rejoint le réseau `npm` ; vous ajoutez l’adresse dans NPM
Derrière Nginx ou Caddy	Nginx ou Caddy est installé sur le système (pas dans Docker)	Publie l’application sur `127.0.0.1:port`, invisible d’Internet
Directement par un port	Pour un test rapide	Publie le port sur Internet, sans HTTPS

« Directement par un port » contourne votre pare-feu : Docker ouvre lui-même le port, même si UFW le bloque (pourquoi). À n’utiliser que pour tester, puis à arrêter.

Les quatre onglets du résultat

docker-compose.yml : le fichier principal.
.env : les mots de passe, générés dans votre navigateur (rien n’est envoyé). Absent si l’application n’en a pas besoin.
Installation : les commandes à lancer, dans l’ordre.
Premiers pas : ce qu’il faut faire après le démarrage (compte administrateur, réglages), avec les avertissements de sécurité.

Installer le résultat

L’onglet Installation donne les commandes adaptées à votre application. Elles suivent toujours ce schéma :

mkdir -p ~/vaultwarden && cd ~/vaultwarden
nano docker-compose.yml        # collez l'onglet docker-compose.yml, Ctrl+O, Entrée, Ctrl+X
nano .env && chmod 600 .env    # collez l'onglet .env (si présent)
docker compose up -d
docker compose logs -f         # Ctrl+C pour quitter

Si vous avez installé votre serveur avec Mon serveur, rangez plutôt l’application avec les autres, dans /opt/stacks/<application>/ : elle profitera alors de la sauvegarde et des mises à jour automatiques.

sudo mkdir -p /opt/stacks/vaultwarden && cd /opt/stacks/vaultwarden
sudo nano compose.yml

Après le démarrage

Traefik : ouvrez l’adresse, le certificat arrive en quelques secondes.
Caddy : ajoutez la ligne donnée dans « Premiers pas » au Caddyfile, puis rechargez Caddy.
Nginx Proxy Manager : ajoutez un « Proxy Host » avec la destination indiquée, et activez le certificat SSL.
Derrière Nginx ou Caddy : créez la configuration avec le générateur Nginx / Caddy, en indiquant 127.0.0.1:port comme adresse de l’application.

Puis suivez l’onglet Premiers pas, en particulier si l’application crée son compte administrateur au premier visiteur.

Ça ne démarre pas ?

docker compose ps
docker compose logs --tail 50

Collez les logs dans le décodeur d’erreurs : il reconnaît les erreurs les plus fréquentes (réseau introuvable, port déjà utilisé, permission refusée…). Pour comprendre chaque ligne du fichier, lisez le docker-compose généré, ligne par ligne.

Une commande qui ne marche pas, une explication pas claire ? Signaler une erreur dans cette page.