Recovery¶
Objectif¶
Ce document décrit la procédure complète permettant de reconstruire le homelab sur un nouveau serveur.
Prérequis¶
- Ubuntu LTS installé
- Accès SSH
- Utilisateur disposant des droits Docker
- Nom de domaine configuré
- Dépôt Git disponible
Installation des dépendances¶
Installer :
- Docker
- Docker Compose
Vérifier :
docker version
docker compose version
Récupération du dépôt¶
Créer le dossier :
mkdir -p /opt
Cloner le dépôt :
cd /opt
git clone <repository>
cd homelab
Restaurer les variables d'environnement¶
Copier les fichiers .env dans :
env/
Restaurer également :
secrets/
si nécessaire.
Restaurer les données¶
Restaurer le contenu du dossier :
data/
à partir d'une sauvegarde.
Si une archive existe :
./scripts/restore.sh backups/<archive>.tar.gz
Reconstruction¶
Lancer :
./scripts/install.sh
Le script :
- vérifie Docker ;
- crée le réseau Docker si nécessaire ;
- démarre tous les services ;
- exécute un diagnostic complet.
Vérification¶
Contrôler le résultat :
./scripts/doctor.sh
Le résultat attendu est :
OK : XX
WARN : 0
FAIL : 0
[ OK ] Homelab en bonne santé.
Vérifications fonctionnelles¶
Contrôler l'accès aux applications :
- Homepage
- Authentik
- Forgejo
- Vaultwarden
- Uptime Kuma
Contrôler également :
- Reverse proxy Caddy
- Certificats TLS
- SMTP
- Sauvegardes
En cas de problème¶
Consulter les journaux :
docker compose logs
ou pour un service :
docker compose \
-f compose/<service>/compose.yaml \
logs
Puis relancer le diagnostic :
./scripts/doctor.sh
Validation¶
Le homelab est considéré comme restauré lorsque :
- tous les conteneurs sont démarrés ;
- tous les healthchecks sont valides ;
doctor.shne retourne aucune erreur ;- les applications sont accessibles ;
- les données sont présentes ;
- les sauvegardes fonctionnent.