La verdad es que (y llamadme paranoico) no soy muy fan de guardar documentos en la nube aunque sea en un vps gestionado por mí, pero, debido a mi trabajo, necesito tener cierta documentación bien ordenada y accesible por si necesito buscar algún dato rápidamente. Sin hacerme el interesante: llevar la trazabilidad de tooodos los productos que entran en la cocina de un restaurante y buscar cualquier etiqueta por si hay algún problema es un dolor de huevos si lo hacemos a la antigua, que no es otra que ir pegando etiquetas en una libreta enorme donde se anotan fechas de entrada, de caducidad, proveedores, etc. Para eso uso Paperless-ngx: Escaneo las etiquetas con la aplicación del móvil, se suben a la nube con todos los datos que necesito y si quiero buscar algo, tardo cerocoma. Todo perfect.
Instalando
La instalación con docker y caddy es bien sencilla.
Primero creamos la carpeta donde irá nuestro docker-compose y los volúmenes que necesite Paperless.
1
2
3
mkdir paperless-ngx
cd paperless-ngx
nvim docker-compose.yml
El compose queda así:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
# Docker Compose file for running paperless from the Docker Hub.
# This file contains everything paperless needs to run.
# Paperless supports amd64, arm and arm64 hardware.
#
# All compose files of paperless configure paperless in the following way:
#
# - Paperless is (re)started on system boot, if it was running before shutdown.
# - Docker volumes for storing data are managed by Docker.
# - Folders for importing and exporting files are created in the same directory
# as this file and mounted to the correct folders inside the container.
# - Paperless listens on port 8000.
#
# In addition to that, this Docker Compose file adds the following optional
# configurations:
#
# - Instead of SQLite (default), PostgreSQL is used as the database server.
#
# To install and update paperless with this file, do the following:
#
# - Copy this file as 'docker-compose.yml' and the files 'docker-compose.env'
# and '.env' into a folder.
# - Run 'docker compose pull'.
# - Run 'docker compose run --rm webserver createsuperuser' to create a user.
# - Run 'docker compose up -d'.
#
# For more extensive installation and update instructions, refer to the
# documentation.
services:
broker:
image: docker.io/library/redis:7
restart: unless-stopped
volumes:
- ./redisdata:/data
db:
image: docker.io/library/postgres:16
restart: unless-stopped
volumes:
- ./pgdata:/var/lib/postgresql/data
environment:
POSTGRES_DB: paperless
POSTGRES_USER: paperless
POSTGRES_PASSWORD: paperless
webserver:
image: ghcr.io/paperless-ngx/paperless-ngx:latest
restart: unless-stopped
depends_on:
- db
- broker
ports:
- "127.0.0.1:8004:8000"
volumes:
- ./data:/usr/src/paperless/data
- ./media:/usr/src/paperless/media
- ./export:/usr/src/paperless/export
- ./consume:/usr/src/paperless/consume
env_file: docker-compose.env
environment:
PAPERLESS_REDIS: redis://broker:6379
PAPERLESS_DBHOST: db
volumes:
data:
media:
pgdata:
redisdata:
Ahora creamos el archivo donde irá la configuración con un nvim docker-compose.env y lo dejamos de la siguiente manera:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# 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
# 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&suite=buster
# for available languages.
#PAPERLESS_OCR_LANGUAGES=tur ces
###############################################################################
# Paperless-specific settings #
###############################################################################
# All settings defined in the paperless.conf.example can be used here. The
# Docker setup does not use the configuration file.
# 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.tudominio.es
# Adjust this key if you plan to make paperless available publicly. It should
# be a very long sequence of random characters. You don't need to remember it.
PAPERLESS_SECRET_KEY=pon aquí algo muy largo y enrevesado, que no tienes que recordar
# Use this variable to set a timezone for the Paperless Docker containers. If not specified, defaults to UTC.
PAPERLESS_TIME_ZONE=Europe/Madrid
# The default language to use for OCR. Set this to the language most of your
# documents are written in.
PAPERLESS_OCR_LANGUAGE=spa
# Set if accessing paperless via a domain subpath e.g. https://domain.com/PATHPREFIX and using a reverse-proxy like traefik or nginx
#PAPERLESS_FORCE_SCRIPT_NAME=/PATHPREFIX
#PAPERLESS_STATIC_URL=/PATHPREFIX/static/ # trailing slash required
Una vez creados estos documentos, añadimos el virtualhost al archivo /etc/caddy/Caddyfile.
1
2
3
4
5
paperless.tudominio.es {
reverse_proxy http://localhost:8004 {
header_down Referrer-Policy "strict-origin-when-cross-origin"
}
}
El paso siguiente es crear el usuario administrador, y para ello seguimos las instrucciones que vienen en el docker-compose.yml, así que lanzamos lo siguiente en la terminal:
1
2
3
docker-compose pull
docker compose run --rm webserver createsuperuser
docker compose up -d'
Pues ya lo tenemos todo listo. Sólo nos falta reiniciar caddy con sudo systemctl reload caddy y ya podemos acceder a la web.
Más información en Paperless-ngx