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.