Accueil > Productivité > Paperless-ngx : numériser et classer tous vos documents avec OCR (Docker)

Paperless-ngx : numériser et classer tous vos documents avec OCR (Docker)

Alimenter Paperless

Tout fichier déposé dans le dossier consume est traité puis déplacé dans la base. Les approches courantes :

  • un scanner réseau qui dépose directement en SFTP/SMB dans consume ;
  • une synchronisation depuis un cloud personnel vers un dossier local, puis copie dans consume (traitez les gros lots par paquets de quelques centaines de fichiers pour ne pas saturer le CPU) ;
  • l’application mobile de votre choix compatible avec l’API Paperless.

Activez le suivi par inotify (par défaut) ; si consume est un partage réseau, passez en sondage : PAPERLESS_CONSUMER_POLLING=30.

Déporter les documents sur un partage réseau

Pour ne pas saturer le disque du serveur, vous pouvez placer le dossier media (les originaux et archives PDF) sur un NAS, en gardant la base et les données en local :

sudo apt install cifs-utils
sudo mkdir -p /mnt/nas/paperless
sudo install -m 600 /dev/null /root/.nas-creds
printf 'username=paperless\npassword=MOT_DE_PASSE\n' | sudo tee /root/.nas-creds
echo '//IP_DU_NAS/paperless /mnt/nas/paperless cifs credentials=/root/.nas-creds,uid=1000,gid=1000,_netdev,nofail 0 0' | sudo tee -a /etc/fstab
sudo mount -a

Arrêtez la pile, copiez media avec rsync -a, puis remplacez dans le compose ./media par /mnt/nas/paperless/media. Gardez l’ancien dossier quelques jours avant de le supprimer.

Utilisez un compte dédié sur le NAS, limité à ce seul partage.

Envoyer des documents par mail

Ajoutez dans .env (exemple avec un compte Gmail et un mot de passe d’application) :

PAPERLESS_EMAIL_HOST=smtp.gmail.com
PAPERLESS_EMAIL_PORT=587
[email protected]
PAPERLESS_EMAIL_HOST_PASSWORD=mot-de-passe-application
[email protected]
PAPERLESS_EMAIL_USE_TLS=true

Puis docker compose up -d pour relire la configuration.

Mise à jour et sauvegarde

  • Mise à jour : docker compose pull && docker compose up -d. Lisez les notes de version avant un changement de version majeure de PostgreSQL.
  • Sauvegarde : l’export intégré produit une copie portable (documents + métadonnées) : docker compose exec webserver document_exporter ../export. Sauvegardez aussi le dump PostgreSQL et le dossier media.

Dépannage

  • Erreur CSRF à la connexion : PAPERLESS_URL et l’en-tête X-Forwarded-Proto doivent correspondre à l’adresse saisie dans le navigateur.
  • Fichier Excel importé mais pas lisible : vérifiez la version de Tika et les logs docker compose logs tika.
  • OCR lent : limitez PAPERLESS_TASK_WORKERS et PAPERLESS_THREADS_PER_WORKER si le serveur est modeste.
Lire aussi:  Portainer : gérer tous vos conteneurs Docker depuis une interface web

Pages : ⬅ Page précédente

Les commentaires sont fermés.