From df3219c3bad833c6b9bc84d17bcbeb5d7761b5f3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?C=C3=A9dric=20FAMIBELLE-PRONZOLA?= <c.pronzola@tuta.io>
Date: Fri, 23 Jan 2026 23:23:21 +0400
Subject: [PATCH] =?UTF-8?q?docs:=20ajout=20de=20la=20documentation=20pour?=
 =?UTF-8?q?=20le=20d=C3=A9ploiement?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 DEPLOYMENT.md | 171 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 171 insertions(+)
 create mode 100644 DEPLOYMENT.md

diff --git a/DEPLOYMENT.md b/DEPLOYMENT.md
new file mode 100644
index 0000000..e091a55
--- /dev/null
+++ b/DEPLOYMENT.md
@@ -0,0 +1,171 @@
+# Deploiement Backend Directus
+
+Guide de deploiement du backend Directus sur un serveur Ubuntu.
+
+## Prerequis
+
+- Ubuntu 20.04+ / Debian 11+
+- Acces root ou sudo
+- Docker (ou Node.js 22+ pour une installation sans Docker)
+- Nom de domaine configure (ex: `api.exemple.com`)
+
+## 1. Installation des dependances
+
+```bash
+sudo apt update && sudo apt upgrade -y
+
+# Docker
+sudo apt install -y docker.io docker-compose-v2
+sudo usermod -aG docker $USER
+newgrp docker
+
+# Nginx et Certbot
+sudo apt install -y nginx certbot python3-certbot-nginx
+```
+
+## 2. Configuration du projet
+
+```bash
+# Cloner le projet
+git clone <URL_DU_REPO> backend
+cd backend
+
+# Configurer l'environnement
+cp .env.sample .env
+nano .env
+```
+
+Variables a modifier dans `.env`:
+
+```env
+PUBLIC_URL="https://api.exemple.com"
+KEY="<openssl rand -hex 32>"
+SECRET="<openssl rand -hex 32>"
+```
+
+## 3. Preparation des volumes
+
+```bash
+mkdir -p database uploads extensions
+chmod 755 database uploads extensions
+```
+
+## 4. Demarrage de Directus
+
+```bash
+docker compose up -d
+docker compose ps
+curl http://localhost:8055/server/health
+```
+
+## 5. Configuration Nginx
+
+```bash
+sudo nano /etc/nginx/sites-available/api.exemple.com
+```
+
+```nginx
+server {
+    listen 80;
+    listen [::]:80;
+    server_name api.exemple.com;
+
+    client_max_body_size 100M;
+
+    access_log /var/log/nginx/api.exemple.com.access.log;
+    error_log /var/log/nginx/api.exemple.com.error.log;
+
+    location / {
+        proxy_pass http://127.0.0.1:8055;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection 'upgrade';
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_cache_bypass $http_upgrade;
+        proxy_connect_timeout 600;
+        proxy_send_timeout 600;
+        proxy_read_timeout 600;
+    }
+
+    location /websocket {
+        proxy_pass http://127.0.0.1:8055;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "Upgrade";
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    }
+}
+```
+
+Activer le site:
+
+```bash
+sudo ln -s /etc/nginx/sites-available/api.exemple.com /etc/nginx/sites-enabled/
+sudo nginx -t && sudo systemctl reload nginx
+```
+
+## 6. Certificat SSL
+
+Verifier le DNS:
+
+```bash
+dig +short api.exemple.com
+curl -4 ifconfig.me
+```
+
+Obtenir le certificat:
+
+```bash
+sudo certbot --nginx -d api.exemple.com
+```
+
+## 7. Verification
+
+```bash
+curl https://api.exemple.com/server/health
+```
+
+Acces admin: `https://api.exemple.com/admin`
+
+## Commandes utiles
+
+```bash
+# Logs
+docker compose logs -f
+
+# Redemarrer
+docker compose restart
+
+# Mise a jour
+git pull origin main
+docker compose down && docker compose up -d
+
+# Backup base de donnees
+cp database/data.db database/data.db.backup-$(date +%Y%m%d)
+
+# Backup uploads
+tar -czf uploads-backup-$(date +%Y%m%d).tar.gz uploads/
+```
+
+## Troubleshooting
+
+### Erreur 502
+
+```bash
+docker compose ps
+curl http://localhost:8055/server/health
+sudo tail -20 /var/log/nginx/api.exemple.com.error.log
+```
+
+### Erreur SSL
+
+```bash
+dig +short api.exemple.com
+sudo certbot certificates
+sudo certbot renew --force-renewal
+```