From 13b7e2147aeff9dec52b8d2d3792b594705f738b Mon Sep 17 00:00:00 2001
From: Olivier <olivier@raspot.in>
Date: Sun, 31 May 2026 07:48:17 +0200
Subject: [PATCH] Document application update procedure

---
 README.fr.md | 25 +++++++++++++++++++++++++
 README.md    | 25 +++++++++++++++++++++++++
 2 files changed, 50 insertions(+)

diff --git a/README.fr.md b/README.fr.md
index 570865f..8fd846c 100644
--- a/README.fr.md
+++ b/README.fr.md
@@ -132,6 +132,31 @@ PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
 
 Adapter `/srv/pve-backup-report` au chemin réel du dépôt. Le `cd` est important : Docker Compose y trouve `compose.yaml` et l'application y charge `.env`.
 
+### 🔄 Mise à jour de l'application
+
+Avant une mise à jour, conserver le fichier `.env` et le répertoire `reports/` sur un stockage persistant. Ils ne doivent pas être remplacés par l'image Docker.
+
+Depuis le répertoire du dépôt :
+
+```sh
+git pull
+docker compose build
+docker compose run --rm pve-backup-report --check-config
+docker compose run --rm pve-backup-report --check-api
+```
+
+Si les vérifications passent, relancer ensuite la génération normale du rapport ou attendre la prochaine exécution planifiée.
+
+Pour une installation locale sans Docker, mettre à jour le dépôt puis réinstaller l'application dans l'environnement virtuel :
+
+```sh
+git pull
+. .venv/bin/activate
+pip install -r requirements.txt
+pip install -e .
+pve-backup-report --check-config
+```
+
 ## 💻 Utilisation directe en ligne de commande
 
 Ce mode est utile pour le développement ou le diagnostic hors conteneur. L'hôte doit disposer de Python, des dépendances Python du projet et des bibliothèques système requises par WeasyPrint.
diff --git a/README.md b/README.md
index a98dd38..9c33890 100644
--- a/README.md
+++ b/README.md
@@ -132,6 +132,31 @@ PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
 
 Replace `/srv/pve-backup-report` with the actual path to the repository. The `cd` is important: Docker Compose finds `compose.yaml` there and the application loads `.env` from it.
 
+### 🔄 Updating the application
+
+Before updating, keep the `.env` file and the `reports/` directory on persistent storage. They must not be replaced by the Docker image.
+
+From the repository directory:
+
+```sh
+git pull
+docker compose build
+docker compose run --rm pve-backup-report --check-config
+docker compose run --rm pve-backup-report --check-api
+```
+
+If the checks pass, run the normal report generation again or wait for the next scheduled execution.
+
+For a local installation without Docker, update the repository and reinstall the application in the virtual environment:
+
+```sh
+git pull
+. .venv/bin/activate
+pip install -r requirements.txt
+pip install -e .
+pve-backup-report --check-config
+```
+
 ## 💻 Direct command-line usage
 
 This mode is useful for development or diagnostics outside a container. The host must have Python, the project's Python dependencies and the system libraries required by WeasyPrint.