Dokploy : installer et configurer sur un VPS

Ce guide suit la documentation d'installation de Dokploy, consultée le 14 octobre 2026.

Ce qu'il faut avant de commencer

• Un serveur Linux avec un accès SSH et les droits sudo. La documentation liste les systèmes testés : Ubuntu 18.04 à 24.04, Debian 10 à 12, Fedora 40, CentOS 8 et 9.
• Au moins 2 Go de mémoire et 30 Go de disque, pour que la construction des images ne bloque pas le serveur.
• Les ports 80, 443 et 3000 libres sur le serveur : l'installation échoue si l'un d'eux est déjà occupé.
• Un nom de domaine dont vous gérez les enregistrements DNS. La documentation précise que les domaines gratuits fournis pour l'essai ne servent qu'en HTTP.

Les ports utilisés

Installer Dokploy

La commande officielle :

curl -sSL https://dokploy.com/install.sh | sudo sh

1. Connectez-vous au serveur en SSH avec un compte qui a les droits sudo.
2. Lancez la commande ci-dessus. Le script installe Docker s'il manque, initialise Docker Swarm et démarre les conteneurs de Dokploy, de sa base de données et de Traefik.
3. Notez l'adresse affichée à la fin, de la forme http://<adresse-du-serveur>:3000.

Si vous passez des variables au script avec sudo, écrivez-les sur la même ligne que sh (par exemple sudo ADVERTISE_ADDR=… sh) : sudo remet l'environnement à zéro.

Créer le compte administrateur sans exposer l'interface

Le premier compte créé sur l'interface en devient l'administrateur. Ouvrir le port 3000 à tout Internet pendant cette étape laisse une fenêtre à n'importe qui.

Le plus sûr est un tunnel SSH. Depuis votre poste :

ssh -L 3000:localhost:3000 utilisateur@adresse-du-serveur

Ouvrez http://localhost:3000 dans votre navigateur et créez le compte administrateur. La page vous parvient à travers la connexion SSH chiffrée, sans que le port soit ouvert sur Internet.

Servir l'interface sur votre domaine en HTTPS

1. Créez un enregistrement DNS de type A, par exemple dokploy.votre-domaine.fr, qui pointe vers l'adresse IP du serveur.
2. Dans Dokploy, ouvrez Settings, puis Web Server. Le panneau du domaine du serveur s'y trouve.
3. Remplissez le domaine, votre adresse pour les avis de Let's Encrypt, activez HTTPS et choisissez Let's Encrypt comme fournisseur de certificat, puis enregistrez.
4. Ouvrez l'interface à sa nouvelle adresse en HTTPS et vérifiez que la connexion fonctionne.
5. Retirez l'accès direct au port 3000, une fois le domaine vérifié et seulement alors, avec la commande donnée par la documentation :

docker service update --publish-rm "published=3000,target=3000,mode=host" dokploy

Lancée trop tôt, cette commande vous coupe de l'interface. Les noms des menus peuvent changer d'une version à l'autre : en cas de doute, la page sur les domaines de la documentation fait foi.

Déployer une première application

Dans un projet, créez une application ou un service Docker Compose, indiquez le dépôt Git ou l'image, puis ajoutez un domaine dans son onglet Domains : hôte, port du conteneur, HTTPS activé et certificat Let's Encrypt. Traefik redirige alors HTTP vers HTTPS et renouvelle le certificat seul. Si un domaine ne répond pas, les journaux de Traefik donnent la raison.

Sur un VPS Hubspace

• Docker est déjà installé depuis le dépôt officiel de Docker, et le compte admin a les droits sudo sans mot de passe : la commande d'installation fonctionne telle quelle. Rien d'autre n'occupe les ports 80 et 443 sur un serveur neuf.
• Les systèmes proposés sont Ubuntu 26.04 LTS et Debian 13, plus récents que les versions que la documentation de Dokploy déclare avoir testées.
• Seuls les ports 22, 80 et 443 sont ouverts depuis Internet : le port 3000 est fermé d'office. Le tunnel SSH ci-dessus suffit pour créer le compte et régler le domaine. Si vous voulez ouvrir le port 3000 un moment, ajoutez une règle dans votre espace client, onglet « Firewalls » de votre VPS, et retirez-la ensuite (voir ouvrir un port).
• Les ports 25 et 465 sortants sont bloqués : pour les courriels de vos applications, passez par un service d'envoi externe.
• Pour Dokploy et quelques applications, une taille Essentiel M (4 vCPU, 8 Go) laisse de la marge aux constructions. Comparez les tailles sur la page des serveurs VPS.

Pour une alternative au fonctionnement voisin, voir Coolify : installer et configurer.

Questions fréquentes