Sommaire11 parties
paperless-ngx est un système open source de gestion de documents qui transforme tes papiers en archive consultable en ligne, hébergée sur ton propre serveur. Il lit le texte des documents scannés, les range avec des étiquettes et te laisse les retrouver par une recherche. Cet article détaille son fonctionnement, son installation et les précautions à prendre avant de lui confier des documents sensibles.
En bref
- Archive consultable de tes documents scannés, avec reconnaissance du texte (OCR).
- Données stockées sur ton serveur, sans transmission sauf si tu le choisis.
- Installation la plus simple avec docker compose ou un script fourni.
- Une démo en ligne existe (login demo / demo), réinitialisée souvent.
- Données stockées en clair : à faire tourner sur un hôte de confiance.
Qu’est-ce que paperless-ngx ?
paperless-ngx sert à garder moins de papier chez soi. Tu scannes tes factures, courriers ou contrats, et le logiciel les range dans une archive où tu peux faire des recherches. Selon sa documentation, tes données sont stockées localement sur ton serveur et ne sont jamais transmises ni partagées, sauf si tu le décides.
Le projet est le successeur officiel de Paperless et de Paperless-ng. Il est soutenu par une communauté, avec l’idée de répartir la responsabilité du développement entre plusieurs personnes. Son code est publié sous licence GPL-3.0.
Comment fonctionne paperless-ngx
Le logiciel se compose de deux parties. Le « consumer » surveille un dossier et ajoute à paperless tous les documents qui s’y trouvent. Le serveur web fournit l’interface dans laquelle tu gères et cherches tes documents. Tu peux aussi envoyer un fichier par glisser-déposer n’importe où dans l’application.
À l’ajout d’un document, paperless applique une reconnaissance de texte (OCR) si le fichier n’en contient pas. Il crée ensuite une version PDF/A, pensée pour la conservation longue durée, et garde l’original intact à côté. Enfin, il associe automatiquement des étiquettes, un correspondant et un type avant d’enregistrer le document en base. L’OCR s’appuie sur le moteur libre Tesseract, qui reconnaît plus de 100 langues.
Ce que sait faire paperless-ngx
Chaque document reçoit des champs pour le classer : un correspondant (la personne ou l’entreprise d’où vient le courrier), un type (facture, contrat, relevé), des étiquettes, une date de création et des champs personnalisés. Les étiquettes remplacent les dossiers : un document peut en porter plusieurs. Depuis la version 2.19, elles peuvent être imbriquées sur 5 niveaux au maximum.
Un apprentissage automatique propose ces étiquettes, correspondants et types. La recherche en texte intégral offre l’autocomplétion, un tri par pertinence, la mise en évidence des passages trouvés et la recherche de documents similaires.
Les autres fonctions utiles
Plusieurs outils complètent la base. Le projet gère aussi plusieurs versions du fichier d’un même document, qui partagent les mêmes métadonnées. Les fonctions d’IA sont facultatives et désactivées par défaut. La documentation ne détaille pas ici leur configuration.
- Import de documents depuis des comptes e-mail, avec des règles par compte (les e-mails et les fichiers Office passent par Apache Tika, facultatif).
- Système de permissions multi-utilisateurs, global ou par document.
- Workflows pour automatiser des actions.
- Liens de partage publics, avec expiration possible.
- Prise en charge des PDF, images, fichiers texte et documents Office.
- Fonctions d’IA facultatives : suggestions, discussion avec ses documents, documents similaires.
Installer paperless-ngx
La méthode la plus simple est docker compose. Les fichiers du dossier docker/compose du dépôt sont réglés pour récupérer l’image depuis le registre de conteneurs de GitHub. Un script d’installation prépare l’environnement pour toi :
Pour d’autres méthodes d’installation, le projet renvoie à sa documentation. La migration depuis Paperless-ng se fait en remplaçant l’image Docker. Le fichier docker-compose.env sert à la configuration sous Docker. La base par défaut est SQLite ; PostgreSQL (recommandé) ou MariaDB sont possibles. Un courtier de messages compatible Redis est requis, Valkey dans les fichiers fournis. Le projet ne donne pas de configuration matérielle minimale dans ces textes.
Où en est paperless-ngx
Au 5 novembre 2026, le dépôt compte 47 731 étoiles, 3 347 forks et 464 contributeurs, pour 11 tickets et demandes de fusion ouverts. Il a été créé le 12 février 2022. Le code est écrit à 63 % en Python et à 28 % en TypeScript.
La dernière version, la v3.4.2, date du 3 novembre 2026. Elle corrige surtout des bogues d’interface mobile et met à jour des dépendances. La v3.4.0, du 29 octobre 2026, a notamment apporté la prise en charge des champs personnalisés dans les titres de workflow, des requêtes de dates relatives et la génération de miniatures PDF via poppler.
Précautions avant de se lancer
Le projet est clair : ne jamais faire tourner paperless-ngx sur un hôte non fiable. Les informations sont stockées en clair, sans chiffrement, et aucune garantie de sécurité n’est donnée. Chacun l’utilise à ses risques.
Le projet recommande de l’installer sur un serveur local, chez soi, avec des sauvegardes. Une démo existe, avec le login demo / demo, mais son contenu est réinitialisé souvent : n’y envoie aucun document confidentiel.
Quelques repères
- OCR : Reconnaissance optique de caractères : une technique qui lit le texte présent dans une image ou un scan pour le transformer en texte que l’on peut chercher et copier.
- PDF/A : Variante du format PDF conçue pour la conservation des documents sur le long terme.
Questions fréquentes
paperless-ngx est-il gratuit ?
Oui, paperless-ngx est un projet open source publié sous licence GPL-3.0. Les textes consultés ne mentionnent aucun prix.
Comment installer paperless-ngx ?
La méthode la plus simple est docker compose, avec les fichiers du dépôt ou le script d’installation fourni. La documentation décrit aussi d’autres méthodes.
paperless-ngx envoie-t-il mes documents sur internet ?
Non, sauf si tu le choisis. Selon la documentation, tes données restent sur ton serveur. La reconnaissance de texte à distance avec Azure AI et les fonctions d’IA sont des options à activer.
Peut-on essayer paperless-ngx sans l’installer ?
Oui, une démo en ligne est accessible avec le login demo / demo. Son contenu est réinitialisé fréquemment et il ne faut pas y déposer d’informations confidentielles.
À retenir
paperless-ngx numérise, indexe et archive tes documents papier sur ton propre serveur, avec OCR, étiquettes et recherche en texte intégral. Les données y sont stockées en clair : le projet recommande un serveur local chez soi, avec des sauvegardes.
Sources
- paperless-ngxREADME
- docs/index.mddocumentation officielle
- docs/usage.mddocumentation officielle
- docs/configuration.mddocumentation officielle
- GitHubnotes de version






