Trace install tas - Paperless-ngx

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.