Retirer une application proprement de son serveur

Une application ne vous sert plus ? Voici comment la retirer sans laisser de traces et sans casser le reste. Exemple avec paperless, à remplacer par le nom du dossier de votre application dans /opt/stacks.

1. Garder une copie de ses données

Même si vous êtes sûr de vous, une dernière archive ne coûte rien :

cd /opt/stacks/paperless
sudo docker compose stop
sudo tar czf /opt/backups/paperless_DERNIERE_$(date +%F).tgz -C /opt/stacks paperless

Certaines applications permettent aussi d’exporter vos données dans un format standard (Paperless : documents PDF, Mealie : recettes, Vaultwarden : export du coffre). Faites-le depuis leur interface si vous pensez y revenir un jour.

2. Arrêter et supprimer les conteneurs

cd /opt/stacks/paperless
sudo docker compose down

down supprime les conteneurs et leur réseau privé, pas les données : elles sont dans les dossiers à côté du compose.yml.

3. Supprimer le dossier

sudo rm -rf /opt/stacks/paperless

Attention : c’est irréversible, et la sauvegarde de la nuit ne contiendra plus cette application. Vérifiez deux fois le chemin avant d’appuyer sur Entrée.

Si l’application utilisait un dossier de médias en dehors de /opt/stacks (/srv/medias pour Jellyfin, /srv/musique pour Navidrome…), il n’est pas supprimé : vos films et votre musique restent là.

4. Récupérer la place des images Docker

Les images téléchargées restent sur le disque tant qu’on ne les supprime pas :

sudo docker image prune -a

Cette commande ne supprime que les images qu’aucun conteneur n’utilise : vos autres applications ne sont pas concernées.

5. Le reverse proxy

Traefik : rien à faire. Il a vu le conteneur disparaître et a retiré l’adresse tout seul.
Caddy : supprimez le bloc de l’application dans /opt/stacks/caddy/conf/Caddyfile, puis rechargez :

sudo docker exec caddy caddy reload --config /etc/caddy/Caddyfile

6. Le DNS et la surveillance

Supprimez l’entrée DNS du sous-domaine chez votre registrar (sauf si vous avez une entrée wildcard).
Retirez l’application d’Uptime Kuma et de Homepage si vous les utilisez, sinon ils signaleront une panne.

7. La prochaine relance du script

Si un jour vous relancez Mon serveur pour ajouter une application, ne recochez pas celle que vous avez retirée, sinon elle sera réinstallée (vide).

Et les anciennes sauvegardes ?

Les archives paperless_*.tgz restent dans /opt/backups et disparaîtront d’elles-mêmes après le nombre de jours choisi (7, 14 ou 30). Pour les supprimer tout de suite :

sudo rm /opt/backups/paperless_*.tgz

Une commande qui ne marche pas, une explication pas claire ? Signaler une erreur dans cette page.