Paperless-ngx mange vos papiers et les rend plus utiles que jamais

Mars 2026. Paperless-ngx franchit le cap des 43 000 étoiles sur GitHub pour 3 000 forks. La v2.20.13, publiée le 21 mars, stabilise une base logicielle déjà rodée. Mais c’est la v3.0.0, sortie en release candidate quelques semaines plus tard, qui fait basculer le projet dans une autre catégorie : elle embarque un classifieur par LLM capable de trier vos documents sans avoir besoin d’apprendre vos habitudes pendant des semaines.

Pendant ce temps, Evernote facture 15 $/mois pour une recherche qui plafonne, Adobe Acrobat verrouille l’OCR derrière un abonnement, et votre classeur à anneaux continue de prendre la poussière. Il est temps d’arrêter.

Ce que fait Paperless-ngx — et ce qu’il ne fait pas

Paperless-ngx est un système de gestion documentaire auto-hébergé sous licence GPL-3.0. Il ne se contente pas de stocker des PDF — il les dévore, les lit, les trie et les indexe. Le cœur du workflow tient en quatre étapes :

1. Import — vous déposez un PDF ou une image dans un dossier consume, vous l’envoyez par email, vous le glissez dans l’interface web, ou vous appelez l’API REST.
2. OCR — Tesseract extrait le texte de chaque page. Le résultat est stocké dans une couche texte superposée au PDF original.
3. Classification — le moteur ML attribue automatiquement des tags, un correspondant (l’émetteur du document) et un type de document (facture, contrat, relevé bancaire…).
4. Recherche plein texte — chaque mot devient interrogeable. Vous cherchez « assurance habitation 2024 » et le document apparaît en moins de 200 millisecondes.

Ce que Paperless-ngx ne fait pas : éditer des PDF (utilisez Stirling-PDF pour ça), signer électroniquement, ou gérer des workflows de validation multi-utilisateurs complexes. Ce n’est pas un ECM d’entreprise — c’est le meilleur archiveur documentaire personnel et TPE du marché self-hosted.

Pourquoi le self-hosting change tout

Confier ses relevés bancaires, ses contrats d’assurance et ses feuilles de soins à un cloud tiers n’est pas anodin. Google Drive scanne vos fichiers pour le ciblage publicitaire. Dropbox a déjà partagé des données avec des partenaires commerciaux. Et migrer 8 000 documents hors d’Evernote relève du chemin de croix — l’export est volontairement limité.

Avec Paperless-ngx, vos documents ne quittent jamais votre infrastructure. Le stockage est en PDF + métadonnées JSON, un format ouvert que vous pourrez relire dans vingt ans. L’export intégré (document_exporter) produit une archive zip complète — documents originaux, versions OCRisées et base de données. Pas de vendor lock-in, pas d’abonnement qui double sans prévenir.

Et le coût ? Zéro euro de licence. Un Raspberry Pi 4 à 45 € fait tourner l’application pour un usage personnel. Pour une famille ou une TPE avec 10 000 documents, un N100 à 150 € ou un NAS Synology d’entrée de gamme suffisent largement.

Le Docker Compose qui avale tout

L’installation tient en trois services Docker — c’est le minimum viable, et il tourne déjà sur un serveur 2 Go de RAM :

services:
  paperless:
    image: ghcr.io/paperless-ngx/paperless-ngx:2.20.13
    container_name: paperless
    restart: unless-stopped
    ports:
      - "8000:8000"
    environment:
      PAPERLESS_REDIS: "redis://paperless_redis:6379"
      PAPERLESS_DBHOST: "paperless_db"
      PAPERLESS_DBNAME: "paperless"
      PAPERLESS_DBUSER: "paperless"
      PAPERLESS_DBPASS: "change_this"
      PAPERLESS_SECRET_KEY: "change_this_to_a_long_random_string"
      PAPERLESS_URL: "https://docs.mondomaine.fr"
      PAPERLESS_TIME_ZONE: "Europe/Paris"
      PAPERLESS_OCR_LANGUAGE: "fra+eng"
      PAPERLESS_ADMIN_USER: "admin"
      PAPERLESS_ADMIN_PASSWORD: "change_this"
      PAPERLESS_ADMIN_MAIL: "[email protected]"
    volumes:
      - paperless_data:/usr/src/paperless/data
      - paperless_media:/usr/src/paperless/media
      - paperless_export:/usr/src/paperless/export
      - ./consume:/usr/src/paperless/consume
    depends_on:
      paperless_db:
        condition: service_healthy
      paperless_redis:
        condition: service_healthy

  paperless_db:
    image: postgres:16-alpine
    container_name: paperless_db
    restart: unless-stopped
    environment:
      POSTGRES_USER: paperless
      POSTGRES_PASSWORD: change_this
      POSTGRES_DB: paperless
    volumes:
      - paperless_pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U paperless"]
      interval: 10s
      timeout: 5s
      retries: 5

  paperless_redis:
    image: redis:7-alpine
    container_name: paperless_redis
    restart: unless-stopped
    volumes:
      - paperless_redis:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  paperless_data:
  paperless_media:
  paperless_export:
  paperless_pgdata:
  paperless_redis:

Trois commandes suffisent pour démarrer :

mkdir -p consume
docker compose up -d

Trente secondes plus tard, l’interface est accessible sur http://localhost:8000. Pour le HTTPS, placez un reverse proxy (Nginx, Caddy, Traefik) devant le service et mettez à jour PAPERLESS_URL.

Si vous traitez des fichiers Office (.docx, .xlsx, .odt), ajoutez Tika et Gotenberg au Compose — deux conteneurs supplémentaires qui transforment ces formats en PDF avant OCR. L’install script officiel propose l’option en une question : bash -c "$(curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)".

Ce qui rend l’automatisation réelle

La promesse de Paperless-ngx, c’est que vous rangez une fois, le logiciel range tout le reste. La réalité tient en trois mécaniques :

Les correspondants. Chaque document est lié à un émetteur. « EDF », « Amex », « Sécurité sociale ». Après 20 à 30 documents classés manuellement, le classifieur ML commence à suggérer le bon correspondant pour chaque nouveau document. En production, le taux de réussite dépasse 95 % sur les correspondants récurrents.

Les tags. Contrairement aux dossiers, un document peut porter plusieurs tags — « Banque » + « 2025 » + « Impôts ». La recherche combinatoire (tag:impots tag:2025) remplace avantageusement l’arborescence de dossiers qu’on ne retrouve jamais trois mois plus tard.

Les règles de consommation. Dès qu’un document arrive dans le dossier consume, un ensemble de règles déterministes peut lui appliquer tags, correspondant et type en fonction de son nom de fichier, de sa source email ou de son contenu texte. Exemple : tout fichier dont le nom contient EDF_ reçoit automatiquement le tag Énergie et le correspondant EDF.

Pour aller plus loin, l’API REST permet d’intégrer Paperless-ngx à n8n, Node-RED ou Home Assistant. Un exemple concret : scanner un reçu avec l’app mobile Swift Paperless (iOS) → import automatique → le tag Note de frais est appliqué → une notification ntfy vous rappelle de le déclarer.

La v3.0 et le classifieur LLM : ce qui arrive

La v3.0.0 de Paperless-ngx, entrée en release candidate fin mars 2026, introduit un classifieur optionnel basé sur un LLM. Là où le classifieur ML classique nécessite un apprentissage progressif (plusieurs dizaines de documents tagués manuellement), le classifieur LLM peut catégoriser un document dès le premier import, en se basant sur sa compréhension sémantique du contenu.

Concrètement, vous configurez une clé API OpenAI ou un endpoint Ollama local, et Paperless-ngx interroge le modèle pour déterminer les tags, le correspondant et le type de document. Le tout reste optionnel : le classifieur ML classique continue de fonctionner, et les deux peuvent coexister — le LLM pour les nouveaux types de documents, le ML pour les correspondants déjà bien entraînés.

Cette évolution réduit le principal point de friction à l’adoption : le cold start. Avant la v3.0, les premières semaines demandaient un effort de classification manuelle. Avec le LLM, vous pouvez importer 500 documents d’un coup et obtenir une classification pertinente immédiatement.

Ce qu’il faut savoir avant de se lancer

La RAM. En idle, Paperless-ngx consomme ~300 Mo. Pendant l’OCR, chaque worker peut monter à 1-2 Go. Sur une machine à 2 Go, gardez PAPERLESS_TASK_WORKERS à 1. Sur 4 Go, vous pouvez monter à 2.

Le CPU. L’OCR est CPU-bound. Un Intel N100 traite environ 30 pages par minute en français. Un Ryzen 5 en traite 100+. Le premier import massif (1 000 documents) prendra quelques heures sur un petit processeur — c’est normal, le traitement est asynchrone et le service reste utilisable pendant l’OCR.

Le stockage. Comptez 2 à 5 Mo par document (original + version OCRisée + miniature). Pour 10 000 documents, prévoyez 50 Go de stockage. Un SSD est recommandé — la recherche plein texte bénéficie directement de la latence d’un disque rapide.

La sauvegarde. Non négociable. Paperless-ngx propose un exporteur intégré (docker compose exec paperless document_exporter ../export --zip) qui produit une archive complète. Sauvegardez aussi le dump PostgreSQL : docker compose exec paperless_db pg_dump -U paperless paperless > backup.sql. Croisez avec une sauvegarde externe (B2, rsync.net) en suivant la règle 3-2-1.

Verdict

Paperless-ngx est le seul choix rationnel pour la gestion documentaire self-hosted en 2026. Les alternatives existent — Docspell (Scala, plus complexe à déployer), Teedy (plus orienté workflow d’équipe), Mayan EDMS (plus lourd, plus enterprise) — mais aucune n’atteint le même niveau de maturité, de communauté et de simplicité opérationnelle.

Si vous avez moins de 500 documents, déployez sur un Raspberry Pi 4 avec 4 Go de RAM, activez le classifieur LLM dès la v3.0, et vous n’aurez presque rien à taguer manuellement. Si vous gérez un foyer ou une TPE avec 5 000 à 15 000 documents, partez sur un N100 ou un NAS avec 8 Go de RAM, ajoutez Tika+Gotenberg pour les fichiers Office, et configurez une règle de consommation email pour que vos factures s’importent toutes seules.

N’attendez pas la v3.0 stable pour commencer. La v2.20.13 fait déjà 95 % du job. Importez votre première centaine de documents ce week-end — dans six mois, vous vous demanderez comment vous avez pu vivre sans.

Références

• Paperless-ngx Documentation — documentation officielle
• Paperless-ngx GitHub — 43 000 étoiles, 3 000 forks, licence GPL-3.0
• Self-Host Paperless-ngx with Docker — selfhosting.sh — guide détaillé, mis à jour mars 2026
• Paperless-ngx Setup Guide (2026) — Mustafa.net — retour d’expérience avec 8 000 documents
• Paperless-ngx: Scan and Digitize Your Documents — noted.lol — présentation et astuces iOS
• Complete Guide to Paperless-ngx — PiStack — comparaison avec DocuWare, SharePoint, Nextcloud