Componentes

Cómo se conecta

Haz clic para ampliar

Ensamblaje

1. 1

   Levanta el núcleo de Paperless-ngx

   Paperless-ngx necesita PostgreSQL para los metadatos y Redis para la cola de tareas de OCR en segundo plano. Levanta los tres como contenedores propios de este stack, sin reutilizar instancias que ya tengas para otra cosa salvo que controles bien los permisos cruzados.

   yamlCopiar

   services:
     broker:
       image: docker.io/library/redis:7
       restart: unless-stopped
   
     db:
       image: docker.io/library/postgres:16
       restart: unless-stopped
       environment:
         POSTGRES_DB: paperless
         POSTGRES_USER: paperless
         POSTGRES_PASSWORD: cambia-esto
       volumes:
         - ./pgdata:/var/lib/postgresql/data
   
     webserver:
       image: ghcr.io/paperless-ngx/paperless-ngx:latest
       restart: unless-stopped
       depends_on:
         - db
         - broker
       ports:
         - "8010:8000"
       environment:
         PAPERLESS_REDIS: redis://broker:6379
         PAPERLESS_DBHOST: db
         PAPERLESS_OCR_LANGUAGE: spa
         PAPERLESS_SECRET_KEY: cambia-esto-tambien
       volumes:
         - ./consume:/usr/src/paperless/consume
         - ./media:/usr/src/paperless/media
         - ./data:/usr/src/paperless/data

2. 2

   Configura la carpeta de consumo

   Monta una carpeta compartida (SMB, NFS, o simplemente la carpeta donde vuelca tu escáner) como el volumen consume del contenedor. Cualquier PDF o imagen que caiga ahí entra automáticamente en la cola de OCR y clasificación, sin que tengas que subirlo a mano desde la interfaz web.

3. 3

   Añade Stirling PDF para lo que Paperless no cubre

   yamlCopiar

     stirling-pdf:
       image: docker.io/stirlingtools/stirling-pdf:latest
       restart: unless-stopped
       ports:
         - "8011:8080"
       volumes:
         - ./stirling-data:/usr/share/tessdata
         - ./stirling-config:/configs

   Paperless-ngx organiza y busca, pero no firma ni edita PDFs sueltos. Stirling PDF cubre justo eso: firmar, comprimir, dividir o unir documentos antes (o después) de que entren en el archivo definitivo.

4. 4

   Conecta ntfy para el aviso

   yamlCopiar

     ntfy:
       image: docker.io/binwiederhier/ntfy:latest
       command: serve
       restart: unless-stopped
       ports:
         - "8012:80"
       volumes:
         - ./ntfy-cache:/var/cache/ntfy

   Paperless-ngx permite definir workflows que, tras consumir un documento, ejecutan un script. Ese script solo necesita una llamada a ntfy para avisar.

   bashCopiar

   #!/bin/sh
   # post-consumo: avisa por ntfy del documento recién procesado
   curl -s -d "Nuevo documento: ${DOCUMENT_FILE_NAME}" http://ntfy:80/paperless

Álvaro Fraguas Bravo

Administrador de sistemas Windows y Linux en una empresa de telecomunicaciones. El día a día es servidores, Active Directory, Docker y automatización; el tiempo libre, más de lo mismo pero por gusto — siempre liado probando algo nuevo, montando algo en el homelab o viendo qué cacharro se puede automatizar a continuación. Si algo se puede scriptear, mejor que no hacerlo a mano dos veces.