« Trace install tas - Paperless-ngx » : différence entre les versions
Phase 3 : sauvegarde, restauration et persistance |
Documentation maintenance conteneurs enrichie: dépendances, volumes, relance et paramètres |
||
| Ligne 12 : | Ligne 12 : | ||
== Exécution / runtime == | == Exécution / runtime == | ||
Quadlets systemd user : paperless.container et paperless-broker.container ; conteneur principal systemd-paperless | Quadlets systemd user : paperless.container et paperless-broker.container ; conteneur principal systemd-paperless. | ||
Rôle des services : | |||
* `paperless.service` : application Paperless-ngx | |||
* `paperless-broker.service` : Redis utilisé par l'application via `PAPERLESS_REDIS` | |||
== Chemins de configuration == | == Chemins de configuration == | ||
* /home/loic/.config/containers/systemd/paperless.container | * /home/loic/.config/containers/systemd/paperless.container | ||
* /home/loic/.config/containers/systemd/paperless-broker.container | |||
* /home/loic/paperless/consume | * /home/loic/paperless/consume | ||
* /home/loic/paperless/export | * /home/loic/paperless/export | ||
Les quadlets sont les sources de vérité de lancement ; les répertoires `consume` et `export` sont les points d'échange documentaires / entrants-sortants. | |||
== Volumes / persistance == | == Volumes / persistance == | ||
* paperless-data:/usr/src/paperless/data | * `paperless-data:/usr/src/paperless/data` | ||
* paperless-media:/usr/src/paperless/media | * données applicatives et métadonnées internes | ||
* /home/loic/paperless/export -> /usr/src/paperless/export | * `paperless-media:/usr/src/paperless/media` | ||
* /home/loic/paperless/consume -> /usr/src/paperless/consume | * documents importés et fichiers gérés | ||
* `/home/loic/paperless/export -> /usr/src/paperless/export` | |||
* exports produits par l'application | |||
* `/home/loic/paperless/consume -> /usr/src/paperless/consume` | |||
* dossier de dépôt pour ingestion automatique | |||
== Dépendances == | == Dépendances == | ||
| Ligne 30 : | Ligne 41 : | ||
* redis via PAPERLESS_REDIS | * redis via PAPERLESS_REDIS | ||
* Caddy 25694 -> 8094 | * Caddy 25694 -> 8094 | ||
== Procédure de relance / diagnostic == | |||
Ordre recommandé : | |||
* broker Redis | |||
* application Paperless | |||
Commandes utiles : | |||
* `systemctl --user restart paperless-broker.service` | |||
* `systemctl --user restart paperless.service` | |||
* `systemctl --user status paperless.service --no-pager -l` | |||
* `curl -I http://127.0.0.1:8094/` | |||
Explication : | |||
* Paperless dépend du broker Redis pour son fonctionnement normal ; un démarrage applicatif sans broker sain peut produire des erreurs trompeuses. | |||
* `curl -I` permet de valider rapidement l'interface HTTP avant d'accuser Caddy. | |||
* `status --no-pager -l` permet de voir les erreurs de volume, variable ou dépendance. | |||
== Remarques == | == Remarques == | ||
OCR configuré sur fra+eng. Service important pour la persistance documentaire. | OCR configuré sur fra+eng. Service important pour la persistance documentaire. | ||
== Données / emplacements à sauvegarder == | == Données / emplacements à sauvegarder == | ||
| Ligne 39 : | Ligne 65 : | ||
* Documents : volume paperless-media | * Documents : volume paperless-media | ||
* Répertoires locaux : /home/loic/paperless/export et /home/loic/paperless/consume | * Répertoires locaux : /home/loic/paperless/export et /home/loic/paperless/consume | ||
* Quadlets : paperless.container et paperless-broker.container | |||
== Sauvegarde == | == Sauvegarde == | ||
* Sauvegarder les volumes paperless-data, paperless-media, paperless-redis-data. | * Sauvegarder les volumes paperless-data, paperless-media, paperless-redis-data. | ||
* Sauvegarder /home/loic/paperless/export et /home/loic/paperless/consume. | * Sauvegarder /home/loic/paperless/export et /home/loic/paperless/consume. | ||
* Exporter aussi les quadlets si une restauration complète de l'orchestration est visée. | |||
== Restauration == | == Restauration == | ||
* Restaurer les volumes paperless-data, paperless-media, paperless-redis-data. | * Restaurer les volumes paperless-data, paperless-media, paperless-redis-data. | ||
* Restaurer /home/loic/paperless/export et /home/loic/paperless/consume puis relancer | * Restaurer /home/loic/paperless/export et /home/loic/paperless/consume. | ||
* Restaurer les quadlets puis relancer d'abord le broker, ensuite Paperless. | |||
* Vérifier ensuite l'accès HTTP, l'ingestion depuis `consume` et la présence des documents dans l'interface. | |||
== Maintenance documentaire == | == Maintenance documentaire == | ||
Lors d'un changement de répertoires consume/export, OCR, broker Redis ou volumes, mettre à jour cette page. | Lors d'un changement de répertoires consume/export, OCR, broker Redis, variables Paperless ou volumes, mettre à jour cette page. | ||
== Trace documentaire == | == Trace documentaire == | ||
Cette page fait partie de [[Trace install tas]]. | Cette page fait partie de [[Trace install tas]]. | ||
Dernière version du 12 avril 2026 à 19:02
Trace install tas - Paperless-ngx
Rôle
GED / OCR documentaire.
Accès
- Local : http://10.8.0.1:8094
- Public : https://lololand.hopto.org:25694
Ports
8094 local, 25694 public
Exécution / runtime
Quadlets systemd user : paperless.container et paperless-broker.container ; conteneur principal systemd-paperless.
Rôle des services :
- `paperless.service` : application Paperless-ngx
- `paperless-broker.service` : Redis utilisé par l'application via `PAPERLESS_REDIS`
Chemins de configuration
- /home/loic/.config/containers/systemd/paperless.container
- /home/loic/.config/containers/systemd/paperless-broker.container
- /home/loic/paperless/consume
- /home/loic/paperless/export
Les quadlets sont les sources de vérité de lancement ; les répertoires `consume` et `export` sont les points d'échange documentaires / entrants-sortants.
Volumes / persistance
- `paperless-data:/usr/src/paperless/data`
* données applicatives et métadonnées internes
- `paperless-media:/usr/src/paperless/media`
* documents importés et fichiers gérés
- `/home/loic/paperless/export -> /usr/src/paperless/export`
* exports produits par l'application
- `/home/loic/paperless/consume -> /usr/src/paperless/consume`
* dossier de dépôt pour ingestion automatique
Dépendances
- paperless-broker.service
- réseau paperless-net
- redis via PAPERLESS_REDIS
- Caddy 25694 -> 8094
Procédure de relance / diagnostic
Ordre recommandé :
- broker Redis
- application Paperless
Commandes utiles :
- `systemctl --user restart paperless-broker.service`
- `systemctl --user restart paperless.service`
- `systemctl --user status paperless.service --no-pager -l`
- `curl -I http://127.0.0.1:8094/`
Explication :
- Paperless dépend du broker Redis pour son fonctionnement normal ; un démarrage applicatif sans broker sain peut produire des erreurs trompeuses.
- `curl -I` permet de valider rapidement l'interface HTTP avant d'accuser Caddy.
- `status --no-pager -l` permet de voir les erreurs de volume, variable ou dépendance.
Remarques
OCR configuré sur fra+eng. Service important pour la persistance documentaire.
Données / emplacements à sauvegarder
- Métadonnées / application : volume paperless-data
- Documents : volume paperless-media
- Répertoires locaux : /home/loic/paperless/export et /home/loic/paperless/consume
- Quadlets : paperless.container et paperless-broker.container
Sauvegarde
- Sauvegarder les volumes paperless-data, paperless-media, paperless-redis-data.
- Sauvegarder /home/loic/paperless/export et /home/loic/paperless/consume.
- Exporter aussi les quadlets si une restauration complète de l'orchestration est visée.
Restauration
- Restaurer les volumes paperless-data, paperless-media, paperless-redis-data.
- Restaurer /home/loic/paperless/export et /home/loic/paperless/consume.
- Restaurer les quadlets puis relancer d'abord le broker, ensuite Paperless.
- Vérifier ensuite l'accès HTTP, l'ingestion depuis `consume` et la présence des documents dans l'interface.
Maintenance documentaire
Lors d'un changement de répertoires consume/export, OCR, broker Redis, variables Paperless ou volumes, mettre à jour cette page.
Trace documentaire
Cette page fait partie de Trace install tas.