Déployer vos applications avec Dokploy sur un VPS

Les hébergeurs PaaS managés ont popularisé un modèle séduisant : pousser du code, récupérer une URL. Mais ce confort a un prix — littéralement. Dès que le trafic monte ou que les bases de données grossissent, la facture mensuelle s'envole. Dokploy renverse l'équation : installez-le une seule fois sur un VPS à ressources fixes, et vous obtenez la même expérience de déploiement pour un coût prévisible dès 99 DH/mois.

La plateforme repose entièrement sur Docker. Chaque application est encapsulée dans un conteneur ou une stack Compose ; Dokploy orchestre le réseau, les volumes, le reverse proxy Traefik et les certificats Let's Encrypt. L'interface web permet de piloter l'ensemble sans jamais ouvrir un terminal — même si le terminal reste disponible pour les opérations avancées.

Avant d'installer Dokploy, assurez-vous de disposer des éléments suivants :

- Un VPS sous Ubuntu 22.04 LTS ou Debian 12 (recommandés), avec au minimum 2 vCPU et 2 Go de RAM. Pour des stacks complexes (Supabase, n8n avec workers), prévoyez 4 Go.
- Un accès SSH root ou un utilisateur avec les droits sudo.
- Un nom de domaine pointant vers l'IP de votre VPS — ou au minimum l'adresse IP pour un premier test.
- Les ports 80 et 443 ouverts dans votre pare-feu. Dokploy ajoute aussi le port 3000 pour son interface pendant l'installation ; vous pourrez le restreindre ensuite.
- Docker Engine absent du serveur au moment de l'installation (le script de Dokploy l'installe lui-même dans la bonne version).

La vraie puissance de Dokploy apparaît avec les stacks multi-services. Voici comment déployer n8n (automatisation de workflows) avec sa base PostgreSQL.

Dans Dokploy, créez un nouveau service de type Docker Compose et collez directement votre fichier docker-compose.yml. Un exemple minimal : services:, n8n:, image: n8nio/n8n, environment:, DB_TYPE=postgresdb, DB_POSTGRESDB_HOST=postgres — et le service postgres: avec son volume persistant.

Dokploy crée un réseau Docker interne isolé pour votre stack. Les services communiquent entre eux par leur nom (postgres, n8n) sans exposer les ports internes. Seul le port de l'interface n8n (par défaut 5678) est déclaré comme port d'entrée, et Traefik gère le routage HTTPS vers lui.

Pour Supabase, la démarche est identique : le dépôt officiel supabase/supabase fournit un docker-compose.yml prêt à l'emploi. Importez-le, adaptez les variables d'environnement dans l'onglet dédié, et déployez. Dokploy orchestre les quinze services de la stack sans intervention supplémentaire.

Dokploy supporte plusieurs domaines par service — utile pour exposer une API et un dashboard sous des sous-domaines distincts avec le même conteneur. Chaque domaine dispose de sa propre règle de routage Traefik et de son certificat SSL indépendant.

Pour un wildcard (*.mondomaine.com), Traefik nécessite un challenge DNS-01 plutôt que HTTP-01. Dokploy expose les options de configuration Traefik avancées dans Paramètres → Proxy ; vous pouvez y injecter des fichiers de configuration TOML personnalisés.

Les variables d'environnement méritent une attention particulière : ne stockez jamais de secrets dans votre docker-compose.yml versionné. Utilisez systématiquement l'onglet Environnement de Dokploy, qui chiffre les valeurs au repos. Pour les secrets partagés entre plusieurs services d'une même stack (clé de chiffrement, token API), définissez-les une seule fois au niveau du projet et référencez-les dans chaque service.

Dokploy peut provisionner directement des instances PostgreSQL, MySQL, MongoDB, Redis et MariaDB sur votre VPS, sans passer par Docker Compose manuellement. Dans Nouveau service → Base de données, choisissez le moteur, définissez le nom, l'utilisateur et le mot de passe — Dokploy crée le conteneur, le volume persistant et l'expose uniquement sur le réseau interne.

Pour les sauvegardes, rendez-vous dans l'onglet Sauvegardes du service base de données. Configurez une destination S3 (AWS, Scaleway Object Storage, Backblaze B2 — tout fournisseur compatible S3). Définissez une planification cron (0 3 * * * pour chaque nuit à 3 h), une rétention en jours, et Dokploy dump la base, la compresse et l'envoie vers le stockage objet.

Pour les volumes applicatifs (fichiers uploadés, assets générés), la sauvegarde suit la même logique : Dokploy archive le contenu du volume et l'envoie vers la même destination. Testez régulièrement la restauration — une sauvegarde non testée n'est pas une sauvegarde.

Voici les messages d'erreur les plus courants et leur résolution.

1. Error response from daemon: pull access denied — L'image Docker est privée ou le nom est incorrect. Vérifiez l'orthographe exacte de l'image et, si elle est privée, ajoutez vos identifiants Docker Hub dans Paramètres → Docker Registries.

2. Certificate not found for domain — Le défi HTTP-01 de Let's Encrypt a échoué. Causes fréquentes : le DNS ne pointe pas encore vers le serveur (attendez la propagation), ou le port 80 est bloqué par le pare-feu du VPS. Vérifiez avec curl -I http://votre-domaine depuis une machine externe.

3. Container exited with code 1 au démarrage — L'application plante immédiatement. Ouvrez l'onglet Logs du service pour lire le stderr du conteneur. La cause est presque toujours une variable d'environnement manquante ou une connexion à la base de données refusée (mauvais hostname, port, credentials).

4. bind: address already in use — Un autre processus occupe le port que votre service tente d'ouvrir. Sur le serveur, ss -tlnp | grep :PORT identifie le processus fautif. Si c'est un autre service Dokploy, vérifiez que les ports internes ne sont pas déclarés identiques dans deux services différents.