Installer Paperless-ngx avec Docker

zarev 12 janv. 2024 5 min de lecture

Table des matières

✅ Mis à jour le 23/07/2026

Vous est-il déjà arrivé de vous demander où était tel ou tel papier? Avez-vous un jour rêvé de pouvoir faire une recherche dans votre tiroir comme dans un moteur de recherche en tapant un mot clé? Voir encore, de tout numériser? Si la réponse est oui, alors cet article pourrait vous plaire!

Paperless-ngx est un système de gestion de documents open source qui transforme vos documents physiques en une archive en ligne consultable afin que vous puissiez conserver moins de papier.

⚡ Caractéristiques

Organisez et indexez vos documents numérisés avec des balises, des correspondants, des types, etc.
Vos données sont stockées localement sur votre serveur et ne sont jamais transmises ou partagées de quelque manière que ce soit.
Effectue une recherche OCR sur vos documents, en ajoutant du texte consultable et sélectionnable, même aux documents numérisés avec uniquement des images.
Utilise le moteur open source Tesseract pour reconnaître plus de 100 langues.
Les documents sont enregistrés au format PDF/A, conçu pour un stockage à long terme, aux côtés des originaux non modifiés.
Utilise l'apprentissage automatique pour ajouter automatiquement des balises, des correspondants et des types de documents à vos documents.
Prend en charge les documents PDF, les images, les fichiers texte brut, les documents Office (équivalents Word, Excel, Powerpoint et LibreOffice) et plus encore.
Paperless stocke vos documents directement sur disque.
Les noms de fichiers et les dossiers sont gérés sans papier et leur format peut être configuré librement avec différentes configurations attribuées à différents documents
Application Web belle et moderne qui comprend un tableau de bord personnalisable avec statistiques.
Filtrage par balises, correspondants, types, etc.
Édition en masse de balises, correspondants, types et plus encore.
Téléchargement de documents par glisser-déposer dans l'application.
Des vues personnalisables peuvent être enregistrées et affichées sur le tableau de bord et/ou la barre latérale.
Prise en charge des champs personnalisés de différents types de données.
Liens publics partageables avec expiration facultative.
La recherche en texte intégral vous aide à trouver ce dont vous avez besoin :
la saisie semi-automatique suggère des mots pertinents de vos documents.
Les résultats sont triés par pertinence par rapport à votre requête de recherche.
La surbrillance vous montre quelles parties du document correspondent à la requête.
Recherche de documents similaires.
Importez des documents depuis vos comptes de messagerie.
Configurez plusieurs comptes et règles pour chaque compte.
Après le traitement, le système sans papier peut effectuer des actions sur les messages telles que le marquage comme lu, la suppression, etc.
Un système d'autorisations multi-utilisateurs robuste et intégré qui prend en charge les autorisations « globales » ainsi que par document ou objet.
Un système de flux de travail puissant qui vous donne encore plus de contrôle.
Le vérificateur d'intégrité intégré garantit que vos archives de documents sont en bonne santé.

💾 L'installation

Avec Cosmos Cloud

Cette application peut-être installée en un clic sur votre Cosmos Cloud en cliquant sur l'image ci-dessous:

Avec docker-compose

Pour commencer il va falloir générer une clé avec cette commande, mettez ensuite cette clé de côté pour après :

python3 -c "import secrets; print(secrets.token_urlsafe(64))"

Créez votre fichier .env :

nano .env

Collez ça dedans :

###############################################################################
# Paperless-ngx settings                                                      #
###############################################################################

# See http://docs.paperless-ngx.com/configuration/ for all available options.

# The UID and GID of the user used to run paperless in the container. Set this
# to your UID and GID on the host so that you have write access to the
# consumption directory.
#USERMAP_UID=1000
#USERMAP_GID=1000

# See the documentation linked above for all options. A few commonly adjusted settings
# are provided below.

# This is required if you will be exposing Paperless-ngx on a public domain
# (if doing so please consider security measures such as reverse proxy)
#PAPERLESS_URL=https://paperless.example.com

# Required. A unique secret key for session tokens and signing.
# Generate with: python3 -c "import secrets; print(secrets.token_urlsafe(64))"
PAPERLESS_SECRET_KEY=Votre_clé_générée_ici

# Use this variable to set a timezone for the Paperless Docker containers. Defaults to UTC.
#PAPERLESS_TIME_ZONE=America/Los_Angeles

# The default language to use for OCR. Set this to the language most of your
# documents are written in.
#PAPERLESS_OCR_LANGUAGE=eng

# Additional languages to install for text recognition, separated by a whitespace.
# Note that this is different from PAPERLESS_OCR_LANGUAGE (default=eng), which defines
# the language used for OCR.
# The container installs English, German, Italian, Spanish and French by default.
# See https://packages.debian.org/search?keywords=tesseract-ocr-&searchon=names
# for available languages.
#PAPERLESS_OCR_LANGUAGES=tur ces

PAPERLESS_SECRET_KEY=Votre_clé_générée_ici : Remplacez Votre_clé_générée_ici par votre clé générée précedement.

Créez votre compose.yml:

nano compose.yml

Collez ça dedans en prenant soin d'adapter le port et les volumes suivant votre configuration:

version: "3.9"
services:
  redis:
    image: docker.io/library/redis:8
    restart: unless-stopped
    container_name: PaperlessNGX-REDIS
    volumes:
      - /srv/appdata/paperless/redis:/data:rw

  db:
    image: docker.io/library/postgres:18
    restart: unless-stopped
    container_name: PaperlessNGX-DB
    volumes:
      - /srv/appdata/paperless/db:/var/lib/postgresql
    environment:
      POSTGRES_DB: paperless
      POSTGRES_USER: paperless
      POSTGRES_PASSWORD: paperless

  webserver:
    image: ghcr.io/paperless-ngx/paperless-ngx:latest
    restart: unless-stopped
    container_name: PaperlessNGX
    depends_on:
      - db
      - redis
      - gotenberg
      - tika
    ports:
      - 8777:8000
    env_file:
      - .env
    volumes:
      - /srv/appdata/paperless/data:/usr/src/paperless/data
      - /srv/appdata/paperless/media:/usr/src/paperless/media
      - /srv/appdata/paperless/export:/usr/src/paperless/export
      - /srv/appdata/paperless/consume:/usr/src/paperless/consume
    environment:
      PAPERLESS_REDIS: redis://redis:6379
      PAPERLESS_DBHOST: db
      USERMAP_UID: 1000
      USERMAP_GID: 1000
      PAPERLESS_TIME_ZONE: Europe/Brussels
      PAPERLESS_ADMIN_USER: zarev
      PAPERLESS_ADMIN_PASSWORD: CHANGE_MOI!
      PAPERLESS_URL: CHANGE_MOI!
      PAPERLESS_CSRF_TRUSTED_ORIGINS: CHANGE_MOI!
      PAPERLESS_OCR_LANGUAGE: deu+eng
      PAPERLESS_TIKA_ENABLED: 1
      PAPERLESS_TIKA_GOTENBERG_ENDPOINT: http://gotenberg:3000
      PAPERLESS_TIKA_ENDPOINT: http://tika:9998

  gotenberg:
    image: docker.io/gotenberg/gotenberg:8.25
    restart: unless-stopped
    container_name: PaperlessNGX-GOTENBERG
    ports:
      - 3520:3000
    command: 
     - "gotenberg" 
     - "--chromium-disable-javascript=true" 
     - "--chromium-allow-list=file:///tmp/.*"  


  tika:
    image: docker.io/apache/tika:latest
    container_name: PaperlessNGX-TIKA
    ports:
      - 9998:9998
    restart: always

N'oubliez pas de changer ces paramètres:

PAPERLESS_TIME_ZONE: Europe/Brussels => indiquez votre time zone.
PAPERLESS_ADMIN_PASSWORD: CHANGE_MOI! => remplacez CHANGE_MOI! par un mot de passe fort.
PAPERLESS_URL: CHANGE_MOI! => remplacez CHANGE_MOI! par votre URL/IP locale ou votre nom de domaine complet.
PAPERLESS_CSRF_TRUSTED_ORIGINS: CHANGE_MOI! => remplacez CHANGE_MOI! par votre URL/IP locale ou votre nom de domaine complet.