Guide Dokploy VPS : Plateforme de Déploiement Auto-Hébergée

Dokploy est un PaaS open source qui simplifie le déploiement d’applications au maximum. Pensez-y comme votre Vercel/Railway personnel qui fonctionne sur n’importe quel VPS.

Qu’est-ce que Dokploy ?

Dokploy prend en charge les aspects rébarbatifs du déploiement :

• Déploiements basés sur Git — Pusher pour déployer
• SSL automatique — Intégration Let’s Encrypt
• Docker natif — Faites tourner n’importe quelle application conteneurisée
• Templates de bases de données — PostgreSQL, MySQL, Redis en un clic
• Routage Traefik — Gestion automatique des domaines
• Logs en temps réel — Surveillez les déploiements en direct

Dokploy vs Autres Plateformes

Fonctionnalité	Dokploy	Coolify	Vercel
Prix	Gratuit (coût VPS)	Gratuit (coût VPS)	20$+/mois
Auto-hébergé	✅	✅	❌
Docker Compose	✅	✅	❌
Multi-serveur	✅	✅	❌
Simplicité UI	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐⭐
Fonctionnalités	En croissance	Mature	Le plus complet

Dokploy est plus récent mais dispose d’une interface plus épurée et d’une installation plus rapide.

Configuration Requise pour le VPS

Minimum :

• 1 vCPU, 2 Go RAM
• 25 Go de stockage
• Ubuntu 22.04+

Recommandé :

• 2 vCPU, 4 Go RAM
• 50 Go de stockage
• Ubuntu 22.04 ou Debian 12

Meilleur VPS pour Dokploy

Fournisseur	Plan	Caractéristiques	Prix
Hostinger	KVM1	1 vCPU, 4 Go RAM	4,99$/mois
Hetzner	CX21	2 vCPU, 4 Go RAM	5,39€/mois
Vultr	VC2	1 vCPU, 2 Go RAM	12$/mois

Installation

Étape 1 : Créer le VPS

1. Inscrivez-vous chez Hetzner ou Hostinger
2. Créez un serveur Ubuntu 22.04
3. Ajoutez une clé SSH
4. Notez l’adresse IP

Étape 2 : Configuration DNS

Faites pointer votre domaine avant l’installation :

A    dokploy.votredomaine.com      → votre-ip-serveur
A    *.dokploy.votredomaine.com    → votre-ip-serveur

Le joker permet à chaque application d’obtenir un sous-domaine.

Étape 3 : Connexion au Serveur

ssh root@your-server-ip

# Update system
apt update && apt upgrade -y

Étape 4 : Installer Dokploy

Une seule commande fait tout :

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

Cela installe :

• Docker
• L’application Dokploy
• Le reverse proxy Traefik
• PostgreSQL (pour les données Dokploy)

Cela prend environ 3 à 5 minutes.

Étape 5 : Accéder au Tableau de Bord

http://your-server-ip:3000

Créez votre compte administrateur. Utilisez un mot de passe fort.

Étape 6 : Configurer le Domaine et le SSL

1. Allez dans Settings
2. Définissez le Server Domain : dokploy.votredomaine.com
3. Activez SSL/TLS
4. Entrez votre email pour Let’s Encrypt
5. Sauvegardez

Accédez maintenant via https://dokploy.votredomaine.com

Déploiement d’Applications

Déployer depuis GitHub

1. Projects → New Project
2. Ajoutez une Application
3. Sélectionnez la source : GitHub
4. Autorisez l’accès GitHub
5. Choisissez le dépôt
6. Cliquez sur Deploy

Dokploy détecte automatiquement :

• Node.js (package.json)
• Python (requirements.txt)
• Go (go.mod)
• Dockerfile

Déployer avec Docker Compose

Pour des projets compose existants :

1. Créez une Application → Docker Compose
2. Collez votre fichier compose ou sélectionnez-le depuis le dépôt
3. Déployez

Exemple de compose :

version: '3.8'
services:
  web:
    image: nginx:alpine
    ports:
      - "80:80"

Déployer via Dockerfile

1. Créez une Application → Dockerfile
2. Pointez vers le dépôt contenant le Dockerfile
3. Dokploy compile et déploie

Configuration des Bases de Données

PostgreSQL

1. Projects → Sélectionnez le projet
2. Ajoutez un Service → PostgreSQL
3. Définissez le nom et le mot de passe de la base de données
4. Déployez

La chaîne de connexion s’affiche dans le tableau de bord :

postgresql://postgres:password@postgres-xxx:5432/dbname

MySQL

Même procédure :

1. Ajoutez un Service → MySQL
2. Configurez les identifiants
3. Déployez

Redis

1. Ajoutez un Service → Redis
2. Déployez
3. Utilisez redis://redis-xxx:6379

Domaines Personnalisés

Ajouter un Domaine à une Application

1. Sélectionnez l’application
2. Onglet Domains
3. Ajoutez : app.votredomaine.com
4. Le SSL est provisionné automatiquement

Rediriger www vers non-www

Ajoutez les deux domaines, Dokploy gère les redirections :

votredomaine.com
www.votredomaine.com

Variables d’Environnement

Variables d’Application

1. Sélectionnez l’application → Environment
2. Ajoutez des variables :

DATABASE_URL=postgresql://...
SECRET_KEY=your-secret
NODE_ENV=production

Secrets (Chiffrés)

Pour les données sensibles :

1. Settings → Secrets
2. Créez un secret
3. Référencez-le dans les applications : {{SECRET_NAME}}

Déploiements et Retours Arrière

Déploiements Automatiques

Activez les webhooks :

1. Paramètres de l’application → Build
2. Activez Auto Deploy
3. Un push sur main déclenche une reconstruction

Déploiement Manuel

Cliquez sur le bouton Deploy à tout moment.

Retour Arrière

1. Onglet Deployments
2. Retrouvez le déploiement précédent
3. Cliquez sur Rollback

Surveillance

Logs en Temps Réel

1. Sélectionnez l’application
2. Onglet Logs
3. Visualisez les logs en temps réel

Utilisation des Ressources

Le tableau de bord affiche :

• Utilisation CPU par application
• Consommation mémoire
• Utilisation du disque
• Trafic réseau

Vérifications de Santé

Configurez dans les paramètres de l’application :

Health Check Path: /health
Interval: 30s
Timeout: 5s

Sauvegardes

Sauvegardes de Bases de Données

1. Sélectionnez la base de données
2. Backups → Activez
3. Définissez la planification
4. Configurez la destination (S3, local)

Sauvegarde Manuelle

# On VPS
docker exec dokploy-postgres pg_dump -U postgres > backup.sql

Sauvegardes de Volumes

Pour les applications avec des données persistantes :

docker run --rm \
  -v app_data:/data \
  -v /backup:/backup \
  alpine tar czf /backup/data.tar.gz /data

Configuration Multi-Serveur

Dokploy supporte plusieurs serveurs :

1. Servers → Add Server
2. Installez l’agent Dokploy sur le nouveau VPS :

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

3. Ajoutez le token du serveur dans Dokploy
4. Déployez les applications sur des serveurs spécifiques

Cas d’usage :

• Séparation staging/production
• Distribution géographique
• Isolation des ressources

Déploiements Courants

Next.js

1. Créez une application → GitHub → Sélectionnez le dépôt
2. Commande de build : npm run build
3. Commande de démarrage : npm start
4. Port : 3000

FastAPI

Dockerfile :

FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

Sites Statiques

1. Créez une application → GitHub
2. Build : npm run build
3. Répertoire de publication : dist ou build
4. Dokploy sert les fichiers statiques

WordPress

1. Ajoutez un Service → WordPress
2. Installation en un clic avec MySQL inclus
3. Configurez le domaine
4. C’est prêt

Dépannage

Échec de Déploiement

Consultez les logs :

1. Application → Deployments → Déploiement échoué
2. Affichez les logs de build
3. Problèmes courants :
   • Dépendances manquantes
   • Mauvaise correspondance de port
   • Commande de build incorrecte

SSL Non Fonctionnel

1. Vérifiez que le DNS pointe vers le serveur
2. Attendez la propagation
3. Vérifiez que les ports 80/443 sont ouverts
4. Redémarrez Traefik :

   docker restart dokploy-traefik

Mémoire Insuffisante

1. Vérifiez avec docker stats
2. Ajoutez du swap :

   fallocate -l 2G /swapfile
   chmod 600 /swapfile
   mkswap /swapfile
   swapon /swapfile

3. Réduisez le nombre d’applications simultanées

Le Conteneur ne Démarre Pas

# Check container logs
docker logs container-name

# Common fixes:
# - Wrong port exposed
# - Missing env variables
# - Healthcheck failing

Optimisation des Performances

Activer le Swap

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile swap swap defaults 0 0' >> /etc/fstab

Nettoyage Docker

# Remove unused images
docker system prune -a

# Schedule weekly cleanup
echo "0 3 * * 0 docker system prune -af" | crontab -

Limites de Ressources

Définissez par application dans le compose :

services:
  app:
    deploy:
      resources:
        limits:
          memory: 512M
          cpus: '0.5'

Accès API

Dokploy dispose d’une API REST :

# Get auth token from settings

# List projects
curl -X GET https://dokploy.yourdomain.com/api/projects \
  -H "Authorization: Bearer YOUR_TOKEN"

# Trigger deployment
curl -X POST https://dokploy.yourdomain.com/api/application/deploy \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"applicationId": "xxx"}'

Questions Fréquentes

Combien d’applications Dokploy peut-il gérer ?

Sur un VPS 4 Go : 5 à 15 applications légères confortablement. Davantage avec des limites de ressources appropriées.

Dokploy est-il prêt pour la production ?

Oui, il est activement maintenu et utilisé en production. La v0.8+ est stable.

Dokploy vs Coolify ?

Les deux sont excellents. Dokploy a une interface plus simple, Coolify a plus de fonctionnalités. Essayez les deux.

Puis-je migrer depuis Heroku ?

Oui ! Ajoutez votre dépôt, configurez les buildpacks ou un Dockerfile, déployez.

Comment mettre à jour Dokploy ?

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

La même commande met à jour vers la dernière version.

Récapitulatif

Dokploy transforme un VPS à 5$ en une puissante plateforme de déploiement :

Ce que vous obtenez	Coût
Applications illimitées	Coût VPS uniquement
SSL automatique	Inclus
Déploiements Git	Inclus
Bases de données	Incluses
Domaines personnalisés	Illimités

Configuration Recommandée :

1. Obtenez un VPS Hostinger (4,99$/mois)
2. Installez Dokploy
3. Connectez GitHub
4. Déployez tout

C’est 5$/mois pour votre propre Vercel. Sans limites, sans dépendance fournisseur, contrôle total.