Documentation du serveur maison

Cette page explique a quoi servent les pages du serveur, comment l'administrer, comment ajouter un service Docker et quelles commandes utiliser sans casser l'installation.

Accueil Homepage Tableau de bord public du serveur. Page statique Ancienne page de secours, toujours disponible. Coolify Plateforme de deploiement sur le reseau local. Portainer Administration Docker en local uniquement.

Pages disponibles

https://cundo.duckdns.org/ Accueil principal. C'est la porte d'entree du serveur pour voir les services.
https://cundo.duckdns.org/docs/ Documentation d'utilisation et guide de deploiement.
https://cundo.duckdns.org/legacy/ Page statique de secours. Utile si Homepage est indisponible.
https://localhost:9443 Portainer. A ouvrir seulement depuis cette machine.
http://192.168.1.26:8000 Coolify. Interface de deploiement depuis le reseau local.
http://127.0.0.1:3001 Uptime Kuma en local. Sert a la supervision et aux tests d'etat.
Regle simple: le public passe par le domaine cundo.duckdns.org. L'administration sensible reste en local.
Cible recommandee: transformer ce serveur en petite plateforme de deploiement. Les applications deviennent publiques via Caddy, mais l'administration doit rester privee.

A quoi sert ce serveur

  • Homepage donne une page d'accueil propre pour retrouver tes services.
  • Caddy gere le HTTPS et redirige les URL vers les bons conteneurs.
  • Coolify sert a deployer des projets via une interface graphique proche d'une petite plateforme PaaS.
  • Portainer sert a voir, demarrer, arreter ou recreer les conteneurs.
  • Uptime Kuma sert a surveiller si un service repond encore.
  • Docker sert a lancer les services dans des conteneurs separes.

Base plateforme a construire

Coolify ou Portainer

Comment deployer un nouveau service

  1. Choisir un service simple et leger. Exemple: Vaultwarden, Gitea plus tard, un wiki, ou un outil perso.
  2. Ajouter le service dans docker-compose.yml ou dans un compose separe si tu veux isoler.
  3. Attacher un volume pour les donnees persistantes.
  4. Publier le port seulement en local, par exemple 127.0.0.1:8080:8080, sauf si le service doit etre expose directement.
  5. Ajouter une route dans caddy/Caddyfile si le service doit etre visible via le domaine public.
  6. Redemarrer seulement le service concerne avec Docker.
  7. Tester localement, puis tester publiquement.
  8. Mettre Homepage et la documentation a jour.
cd ~/Desktop/projet-serveur-maison
docker compose up -d nom-du-service
docker compose ps
docker compose logs -f nom-du-service

Comment utiliser Coolify

  1. Ouvrir http://192.168.1.26:8000 depuis le reseau local.
  2. Creer le compte administrateur lors du premier acces.
  3. Connecter un depot Git si tu veux un deploiement plus proche d'une plateforme moderne.
  4. Definir les variables d'environnement dans l'interface.
  5. Lancer le deploiement et surveiller les logs dans Coolify.
  6. Utiliser ensuite `Caddy` si tu veux exposer l'application sur ton domaine principal.

Deployer avec Coolify pas a pas

  1. Ouvrir Coolify sur http://192.168.1.26:8000 ou via Tailscale.
  2. Verifier que le serveur localhost est valide et utilisable.
  3. Aller dans Projects puis creer un projet.
  4. Ajouter une application dans ce projet.
  5. Connecter le depot Git et choisir la branche a deployer.
  6. Verifier le port interne, les variables d'environnement et les volumes.
  7. Lancer le deploiement et suivre les logs.
  8. Tester l'application avant toute exposition publique.
  9. Ajouter une route dans Caddy seulement si l'application doit etre publique.
  10. Ajouter ensuite le lien dans Homepage.
Regle simple: Coolify deploie, Caddy publie, Homepage reference.

Deployer depuis une autre machine

Oui, c'est le role de Coolify: deployer sur ce serveur depuis une autre machine via une interface web, sans refaire toutes les manipulations en SSH.

Dans l'etat actuel, Coolify est accessible en local sur http://192.168.1.26:8000. Il n'est pas encore expose publiquement via Caddy.
  1. Depuis une autre machine du meme reseau, ouvrir http://192.168.1.26:8000.
  2. Se connecter a Coolify.
  3. Ajouter un depot Git.
  4. Choisir la branche a deployer.
  5. Definir le port interne, les volumes et les variables d'environnement.
  6. Lancer le build et le deploiement.
  7. Verifier les logs et tester le service localement.
  8. Exposer le service publiquement seulement apres validation.

Si tu veux deployer depuis l'exterieur de la maison, la methode recommandee est de passer par un VPN prive comme Tailscale ou WireGuard. Cela permet d'ouvrir l'interface d'admin sans la rendre publique sur Internet.

Regle pratique: Coolify sert a deployer, Caddy sert a publier, et Homepage sert a centraliser les liens.

Schema de deploiement recommande

Internet -> Freebox -> Caddy -> service Docker

Exemple:
https://cundo.duckdns.org/ -> Homepage
https://cundo.duckdns.org/docs/ -> documentation statique
https://localhost:9443 -> Portainer local

Commandes utiles

cd ~/Desktop/projet-serveur-maison

# Voir l'etat de la stack
docker compose ps

# Voir les logs d'un service
docker compose logs -f caddy
docker compose logs -f homepage

# Redemarrer un service
docker compose restart caddy

# Lancer une sauvegarde
bash scripts/backup.sh

# Restaurer une sauvegarde
bash scripts/restore.sh backups/AAAA-MM-JJ_HH-MM-SS
docker compose up -d

Quand un service ne marche pas

  1. Verifier docker compose ps.
  2. Lire les logs du service concerne.
  3. Verifier si l'URL passe bien par Caddy ou si elle doit rester locale.
  4. Verifier le DNS et la Freebox seulement si le probleme est public.
  5. Faire une sauvegarde avant les grosses modifications.