Paperless-ngx

Benoit Anastay Addon : Paperless-ngx

Celà fait maintenant plus d’un an que je fais la maintenance d’un addon pour Paperless-ngx, ma base d’utilisateur est principalement allemande.

Paperless est une application qui gère vos documents personnels. Avec l’aide d’un scanner de documents, Paperless transforme vos volumineux classeurs de documents physiques en une archive consultable et fournit de nombreuses utilités pour trouver et gérer vos documents.

La dernière version de mon addon intègre Tika et Gotenberg qui permet l’archivage des documents sous d’autres formats que le PDF.


L.jpeg)

Installation

L’installation de ce module complémentaire est assez simple et ne diffère pas de l’installation de tout autre module complémentaire de Home Assistant.

  1. Cliquez sur le bouton Home Assistant My ci-dessous pour ouvrir le module complémentaire sur votre instance Home Assistant.

    Ouvrez cet addon dans votre instance Home Assistant.

  2. Cliquez sur le bouton « Installer » pour installer le module complémentaire.

  3. Démarrez le module complémentaire « Paperless-ngx ».

  4. Configurez le module complémentaire
    (paperless-home-assistant-addon/paperless-ngx/DOCS.md at e8e07c0b719f8e74a604b34a821c8ff37194c619 · BenoitAnastay/paperless-home-assistant-addon · GitHub)

  5. Consultez les journaux du module complémentaire « Paperless-ngx » pour le voir en action.

Obtenir de l’aide

N’hésitez pas à demander de l’aide dans ce fil de discussion, vous pouvez également ouvrir un ticket si vous rencontrez un bug ou si vous avez besoin de nouvelles fonctionnalités.

1 « J'aime »

Bonjour.

Merci pour la découverte. N’étant pas utilisateur de paperless, j’ai du mal à voir concrètement quels sont les cas d’utilisation dans Home Assistant. Tu aurais des exemple ?
Des fonctions de notifications en lien avec la domotique ? Du dashboard ?

2 « J'aime »

C’est un addon, ca permet d’héberger Paperless sur un machine avec Home Assistant Operating System ou Supervisé.
J’ai integré les fonctions ingress, l’identification avec le compte home assistant, il est possible de stoquer ses fichiers sur un partage réseau configuré dans Home Assistant Operating System ect…

Le but est d’éviter de devoir dépendre de container non géré par home assistant ou de virtualisation.

Personellement j’aime bien avoir tout mon « Home Lab » sur Home Assistant ca facilite beaucoup la maintenance.

Hier ma Freebox s’est mise a déconner avec mes VMs et j’avais plus accès au disque virtuel, elle s’est vraiment mise a bugger lourdement.

J’ai pu simplement restaurer un backup de Home Assistant et j’ai récupéré l’intégralité de mon installation avec tous les fichiers.

En dehors de l’integration Ingress l’addon n’apporte pas grands chose de plus que le lancement bare-metal ou avec docker, c’est juste plus pratique, plus simple, en quelques cliques une installation de Paperless fonctionne dans Home Assistant.

Il est effectivement possible de mettre des notifications avec un capteur rest api mais c’est aussi faisable en bare-metal

Donc le principal intérêt c’est que ton archivage de document est hébergé / backupé avec ton HA c’est ça?

Merci pour les infos, je comprend un peu mieux l’interet.

Personnellement l’intérêt c’est que je n’exécute que Home Assistant OS donc je depends d’un add-on pour lancer paperless

Salut,

Ça a l’air super comme outil ! Je l’ai découvert car il est cité dans la release de 2025.07

Faut que je teste ça car je m’étais fais des raccourcis iOS pour scanner tous mes courriers/documents importants mais pas simple à l’utilisation :sweat_smile:

Merci, je vais tester ça !

C’est un super outil, je l’utilise pour tout scanner sans avoir a trier mes papiers depuis quelques temps, l’application est top. Je l’ais installer sur un lxc spécifique, je n’aime pas mélanger les choses.

Salut,
Tu as appliqué des paramètres spécifiques pour que ça trie automatiquement ? Je sais jamais trop comment trier et ranger mes papiers :sweat_smile:
Est-ce qu’il est capable d’appliquer un tag ou autre pour indiquer la durée de conservation recommandée ? Ça serait une fonctionnalité intéressante !

Bonne soirée

Pour le moment j’ai une erreur 503 dans l’ihm de Paperless donc je pense que je vais aller faire un LXC ça serait sans plus simple mais je sais pas si je pourrais le relier à HA :thinking:

Non rien la recherche fonctionne super

Tiens un script tout fait :

1 « J'aime »

Il faut paramétrer des règles pour que ça tri enfin que ça applique des « tags » :
Tu as des étiquettes, des correspondants et des types de document.

Tu peux créer des règles qui vont automatiquement affecter ces trois éléments via des règles dédiées.

Ça me fait penser que j’ai un bon gros mois de retard :sweat_smile:

Alors la aussi tu peux créer une règles qui affectera une étiquettes « Conservation 10 ans » pour tous les documents que tu entreras dans les filtres, mais ce sera à toi de faire ces filtres.
Tu as plusieurs possibilités :

Voilà les écran de création des trois types :



Attention, par défaut le nom du fichier dans le stockage est une chaîne aléatoire.
Perso j’ai changé ça pour que ça conserve le nom du fichier original via une variable d’environnement dans le docker-compose.yaml :

PAPERLESS_FILENAME_FORMAT={correspondent}/{created_year}/{created_year}-{created_month}-{created_day} - {title}

C’est une bonne application web en tout cas.
Mais il faut consacrer du temps aux filtres pour identifier les documents.

1 « J'aime »

Nickel merci pour vos retours :ok_hand:

Bonjour,

Bon j’ai installé Paperless dans un LXC sans souci. Maintenant, je peine à l’associer à l’Addon, il faut mettre quoi dans les paramètres ?

Merci à vous !