Paperless-ngx : numériser et classer tous vos documents avec OCR (Docker)
Le fichier docker-compose.yml
Le modèle officiel (variante PostgreSQL) sert de base. Voici la version complétée avec Tika et Gotenberg :

services:
broker:
image: docker.io/valkey/valkey:9-alpine
restart: unless-stopped
volumes:
- redisdata:/data
db:
image: docker.io/library/postgres:18
restart: unless-stopped
volumes:
- pgdata:/var/lib/postgresql
environment:
POSTGRES_DB: paperless
POSTGRES_USER: paperless
POSTGRES_PASSWORD: ${DB_PASSWORD}
webserver:
image: ghcr.io/paperless-ngx/paperless-ngx:latest
restart: unless-stopped
depends_on:
- db
- broker
- gotenberg
- tika
ports:
- "127.0.0.1:8283:8000"
volumes:
- data:/usr/src/paperless/data
- ./media:/usr/src/paperless/media
- ./export:/usr/src/paperless/export
- ./consume:/usr/src/paperless/consume
env_file: .env
environment:
PAPERLESS_REDIS: redis://broker:6379
PAPERLESS_DBHOST: db
PAPERLESS_DBENGINE: postgresql
PAPERLESS_DBPASS: ${DB_PASSWORD}
PAPERLESS_TIKA_ENABLED: 1
PAPERLESS_TIKA_GOTENBERG_ENDPOINT: http://gotenberg:3000
PAPERLESS_TIKA_ENDPOINT: http://tika:9998
gotenberg:
image: docker.io/gotenberg/gotenberg:8
restart: unless-stopped
command:
- "gotenberg"
- "--chromium-disable-javascript=true"
- "--chromium-allow-list=file:///tmp/.*"
tika:
image: docker.io/apache/tika:3.2.3.0
restart: unless-stopped
volumes:
data:
pgdata:
redisdata:
Deux remarques importantes :
- le port est publié sur
127.0.0.1uniquement : l’accès se fera via le reverse proxy ; - épinglez la version de Tika (ici
3.2.3.0). Aveclatest, une mise à jour majeure peut casser l’analyse de certains fichiers Excel ; ne passez à une version plus récente qu’après un test.
Le fichier .env
cat > .env <<'EOF'
DB_PASSWORD=choisissez-un-mot-de-passe-long
PAPERLESS_SECRET_KEY=generez-une-cle-avec-openssl-rand-hex-32
PAPERLESS_URL=https://paperless.home.mondomaine.tld
PAPERLESS_PROXY_SSL_HEADER=["HTTP_X_FORWARDED_PROTO", "https"]
PAPERLESS_TIME_ZONE=Europe/Paris
PAPERLESS_OCR_LANGUAGE=fra+eng
PAPERLESS_OCR_USER_ARGS={"invalidate_digital_signatures": true}
PAPERLESS_CONSUMER_RECURSIVE=true
EOF
chmod 600 .env
PAPERLESS_URL est essentiel derrière un proxy : sans lui, la connexion échoue (erreur CSRF) et les liens générés sont faux. Une fois posé, l’accès direct par IP:port est refusé, c’est normal.
Premier démarrage
mkdir -p /opt/paperless/{consume,export,media}
cd /opt/paperless
docker compose up -d
docker compose run --rm webserver createsuperuser
Ouvrez l’URL du reverse proxy et connectez-vous avec le compte créé.
➡ Page suivante : Alimenter Paperless
Pages : ⬅ Page précédente Page suivante ➡