Ajouter une application au compose global

  desk:
    build: ./apps/desk.pix-up.com
    restart: always
    labels:
      - traefik.enable=true
      - traefik.http.routers.desk.rule=Host(`desk.pix-up.com`)

Pas de port à publier : la règle Host(...) suffit. Ton domaine pointe sur le VPS, Traefik fait le reste.

cd ~
docker compose up -d --build desk
docker logs --tail=50 desk

Dockerfile d'une app Next.js

Le build a échoué avec « Cannot apply unknown utility class text-white » parce que le Dockerfile faisait npm ci --only=production : Tailwind et Next sont en devDependencies et manquaient au moment du build. Installe tout pour construire, puis ne garde que le nécessaire à l'exécution (build en plusieurs étapes).

RUN npm ci   (étape builder), puis copie du build dans l'image finale

RUN npm ci --only=production   puis   RUN npm run build

• Crée une clé SSH sur le VPS (ssh-keygen -t ed25519).
• Ajoute la clé publique comme clé de déploiement du dépôt Forgejo (lecture suffit, écriture si le VPS pousse).
• Forgejo écoute en SSH sur le port 2222 : l'URL est ssh://git@git.pix-up.com:2222/pix-up/<repo>.git.
• Pour ne pas retaper l'option, déclare un alias dans ~/.ssh/config (c'est le forgejo-pix utilisé dans git clone forgejo-pix:pix-up/logo.git).

GIT_SSH_COMMAND="ssh -i ~/.ssh/id_ed25519 -o IdentitiesOnly=yes -p 2222" \
  git ls-remote ssh://git@git.pix-up.com:2222/pix-up/pix-desk.git

Premier réflexe : ping git.pix-up.com depuis le VPS. « Name or service not known » = le nom n'existe pas encore pour ce serveur. Un enregistrement A créé chez l'hébergeur de domaine ne compte pas si les serveurs de noms sont ceux de Cloudflare : c'est la zone Cloudflare qui fait foi.

docker compose restart
sudo resolvectl flush-caches
nslookup pegasus.pix-up.com 1.1.1.1

# docker-compose.yml, service concerné :
#   dns:
#     - 1.1.1.1
#     - 8.8.8.8

Créer un enregistrement par l'API Cloudflare

curl -X POST "https://api.cloudflare.com/client/v4/zones/ZONE_ID/dns_records" \
  -H "Authorization: Bearer TON_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"type":"A","name":"test.exemple.com","content":"1.2.3.4","ttl":1,"proxied":false}'

• Sur le VPS, Traefik obtient et renouvelle les certificats Let's Encrypt (fichier acme.json).
• curl -Iv https://design.pix-up.com : regarde la ligne issuer. Il doit y avoir Let's Encrypt, pas TRAEFIK DEFAULT CERT.
• « self-signed certificate » juste après un changement = Traefik n'a pas encore émis le certificat (nom pas résolu, port 80 injoignable, règle Host absente).
• Sur un hébergement cPanel / o2switch derrière Cloudflare, la validation automatique échoue souvent (« Error issuing certificate » ou le TXT de vérification) : vérifie que le domaine pointe bien vers ce serveur.

Pour envoyer à cPanel un certificat émis par Traefik, l'idée retenue était de lire acme.json, décoder certificate et key en base64, puis les passer à l'API SSL de cPanel. Si cPanel refuse « le certificat n'a pas pu être analysé », sépare le certificat de sa chaîne.

cd /home/debian && docker run --rm -v n8n_data:/data -v /home/debian:/backup alpine \
  tar czf /backup/n8n_data_backup_$(date +%F_%H-%M).tar.gz -C /data .
ls -lh /home/debian/n8n_data_backup_*.tar.gz
docker compose pull n8n && docker compose up -d n8n

• Aucune sortie pendant 10 à 30 s pendant le tar : normal. Ne coupe pas avec Ctrl+C (tu as annulé le backup juste après le téléchargement d'alpine).
• Sous PowerShell, && n'est pas un séparateur valide : utilise ; ou if ($?) { ... }.
• .dockerignore doit contenir data, .git, node_modules, vendor pour ne pas embarquer des dossiers à droits root dans le build.
• Supabase : si docker compose répond « empty section between colons » sur docker.sock, une ligne de volume du compose a un chemin vide avant :/var/run/docker.sock.

Recommandation donnée : ne pas supprimer le VPS d'abord. Monter la machine locale en parallèle 1 à 2 semaines, y migrer les apps l'une après l'autre, puis décider.