¿Qué configuración de VPS hay que prever?

La pila de tres contenedores (servidor Django, PostgreSQL 16, Redis 7) consume entre 400 y 512 MB de RAM en reposo: un VPS de 2 GB es el mínimo recomendado, y 4 GB resulta más cómodo para un equipo o un archivo voluminoso. El OCR hace subir puntualmente el procesador sin exigir más memoria. En cuanto al disco, dimensione con holgura: Paperless-ngx conserva el original y la versión archivada de cada documento.

¿Es obligatorio un nombre de dominio?

No. Paperless-ngx es accesible desde el despliegue por la IP del VPS en el puerto 8000. Un dominio sigue siendo recomendable en producción: permite servir la interfaz en HTTPS detrás de un reverse proxy y generar enlaces de documento correctos en las notificaciones. Puede añadirlo en cualquier momento después del despliegue inicial.

Soporte

Compartir la información y colaborar.

Paperless-ngx

Gestión documental open source y autoalojada: OCR Tesseract, clasificación automática por corresponsal y tipo, búsqueda de texto completo en todo su archivo documental.

2 GB (4 GB recomendado) RAM 2 vCPU Puerto 8000 Disponible

Stack técnico

DockerDjangoPostgreSQL 16Redis 7Tesseract OCR

RAM mínima2 GB (4 GB recomendado)

CPU mínima2 vCPU

Puerto por defecto8000

SO compatiblesubuntu-24.04

Paperless-ngx es un sistema de gestión electrónica de documentos de código abierto (AGPL-3.0, más de 43 000 estrellas en GitHub) mantenido por su comunidad. Convierte sus documentos en papel y digitales en un archivo clasificado y consultable, alojado íntegramente en su VPS: ningún dato sale de su infraestructura. Deposite un PDF o el escaneo de una carta y Paperless-ngx lanza el OCR mediante Tesseract, extrae el texto íntegro, coteja el documento con sus reglas (remitente, palabra clave, expresión regular) y le asigna un corresponsal («Administración tributaria», «Banco»), un tipo de documento («Factura», «Contrato») y etiquetas — sin intervención manual. Cada palabra de cada documento pasa a ser buscable de inmediato.

La pila funciona en tres contenedores Docker: un servidor web Django/Gunicorn, una base de datos PostgreSQL 16 y un broker Redis 7 para la cola de tareas Celery. Un directorio de consumo automatiza la ingesta: un fichero depositado en la carpeta vigilada, recibido por correo electrónico o enviado desde un escáner se procesa y se clasifica solo. La API REST abre la puerta a las integraciones con n8n, Nextcloud, su ERP o sus propios scripts.

Funcionalidades clave

OCR automático mediante Tesseract — cada PDF o imagen que deposite pasa a ser consultable en texto completo, en los idiomas que active.

Reglas de clasificación automática — corresponsal, tipo de documento y etiquetas asignados según el título, el contenido o el origen.

Bandeja de consumo — carpeta vigilada, buzón de correo IMAP o API REST para ingerir los documentos sin manipulación.

Búsqueda de texto completo instantánea, incluso en las imágenes escaneadas, con filtros por fecha, tipo, etiqueta y corresponsal.

API REST completa para consultar, depositar, etiquetar y descargar los documentos mediante programación (n8n, Nextcloud, scripts propios).

Registro de auditoría — cada creación, modificación y eliminación queda registrada con su marca de tiempo y su usuario.

Multiusuario con permisos detallados — áreas de almacenamiento separadas, etiquetas compartidas y control de acceso preciso.

Modo oscuro, panel personalizable y vistas de lista o de detalle — una interfaz web cuidada, accesible desde cualquier navegador.

Licencia AGPL-3.0 — sin cuota por documento, sin nube SaaS y sin dependencia de proveedor: sus datos son suyos.

¿Cuándo usar esta solución?

Oficina sin papel para una pyme

Sustituya los archivadores y los PDF dispersos por un archivo centralizado y consultable. El contable deposita las facturas en la carpeta de consumo; Paperless-ngx les aplica OCR, las etiqueta y las clasifica por proveedor y por periodo. Una búsqueda de «IVA 2025» devuelve el documento correcto en menos de un segundo, sin recorrer el árbol de carpetas.

Archivo personal: banco, impuestos, seguros

Reúna extractos bancarios, declaraciones fiscales, contratos de arrendamiento y pólizas de seguro en un único espacio consultable. Las reglas de clasificación dirigen cada extracto al corresponsal correcto, y la búsqueda de texto completo encuentra una cláusula concreta en cualquier contrato. Sus documentos permanecen en su VPS, fuera de todo servicio en la nube.

Repositorio de cumplimiento de un equipo técnico

Utilice Paperless-ngx como repositorio interno de los documentos de cumplimiento: acuerdos de confidencialidad firmados, facturas de material, informes de auditoría, renovaciones de certificados. La API REST permite que su cadena de integración continua deposite automáticamente los PDF generados en cada build, y el registro de auditoría documenta quién ha tocado qué.

Desplegar Paperless-ngx en su VPS

Guía optimizada para los VPS Cloud ServOrbit.

Pedir el VPS

Paperless-ngx cabe sin problema en un VPS de 2 GB / 2 vCPU con Ubuntu 24.04: los tres contenedores consumen entre 400 y 512 MB en reposo. Prevea 4 GB para un archivo de más de 100 000 documentos o para lotes de OCR simultáneos, y disco con holgura — cada documento se conserva en original y en versión archivada, además de la base de datos PostgreSQL.

Desplegar desde el Marketplace

En su área de cliente de ServOrbit, abra Marketplace → Colaboración y productividad → Paperless-ngx y lance el despliegue. Docker descarga ghcr.io/paperless-ngx/paperless-ngx:latest, PostgreSQL 16 y Redis 7, y después arranca los tres contenedores. La cuenta de administrador se crea en el primer arranque a partir de las credenciales facilitadas por el despliegue.

Conectarse por primera vez

Abra la URL, inicie sesión con el usuario admin y la contraseña facilitada, y cámbiela de inmediato desde el menú de su perfil.

Conectarse y crear sus primeros tipos

Si hay un dominio asociado a la aplicación, abra https://su-dominio — sin número de puerto. Sin dominio no hay acceso público: abra un túnel SSH con ssh -L 8000:127.0.0.1:8000 root@<ip-de-su-vps> (8000 es el puerto del catálogo, indicado como ejemplo — consulte el puerto que aparece en la ficha de su aplicación en el área de cliente) y luego abra http://localhost:8000. Inicie sesión con las credenciales de administración. En Settings → Document Types, cree sus primeros tipos («Factura», «Contrato») y añada después en Correspondents los remitentes que trata con más frecuencia. Paperless-ngx se apoya en estos dos repertorios para clasificar los documentos entrantes.

Elegir un modo de ingesta y escribir sus reglas

Lo más sencillo es la carpeta de consumo montada en /usr/src/paperless/consume: todo fichero que aterrice allí se procesa automáticamente. También puede activar el recolector de correos (Settings → Mail) para recuperar los adjuntos de un buzón IMAP dedicado. En Settings → Matching, defina a continuación las reglas que asignan corresponsal, tipo y etiquetas a cada nuevo documento.

Añadir un dominio y pasar a HTTPS

El dominio no es obligatorio, pero sin él no hay ningún acceso público: la interfaz solo es accesible mediante un túnel SSH desde su equipo. Para un acceso remoto permanente, asocie un dominio a la aplicación desde su área de cliente de ServOrbit, por ejemplo docs.su-dominio.com: ServOrbit se encarga del vhost, del certificado TLS y de la redirección al puerto 8000 local. Indique después en PAPERLESS_URL la URL pública para que los enlaces de descarga y las notificaciones usen la dirección correcta.

Preguntas frecuentes

Paperless-ngx es un sistema de gestión electrónica de documentos de código abierto y autoalojado (AGPL-3.0, más de 43 000 estrellas en GitHub). Digitaliza, aplica OCR e indexa sus documentos en papel y digitales, los clasifica automáticamente por corresponsal, tipo y etiqueta, y hace que cada palabra sea buscable — en su propio VPS, sin depender de ningún servicio en la nube.

Sí. La imagen Docker incorpora Tesseract con sus paquetes de idiomas, y la plantilla de ServOrbit arranca con PAPERLESS_OCR_LANGUAGE=fra+eng, es decir, OCR simultáneo en francés e inglés. Para añadir un idioma — el árabe, por ejemplo — basta con ampliar esta variable de entorno y reiniciar el contenedor: no hay ningún paquete adicional que instalar.

Todo el estado vive en los volúmenes Docker de la pila: paperless_media para los documentos originales y archivados, paperless_data para el índice y los ficheros de trabajo, paperless_db para la base de datos PostgreSQL. Haga una copia de seguridad de estos volúmenes — más una exportación de la base de datos si prefiere un dump SQL — y podrá reconstruir la instancia de forma idéntica en otro VPS.

Sí. Paperless-ngx expone una API REST documentada en /api/ que permite listar, buscar, subir, etiquetar, descargar y eliminar documentos por HTTP. Es el punto de entrada natural para desencadenar una ingesta desde un escenario de n8n, una cadena de integración continua o cualquier script.

Integrar el botón de despliegue

¿Mantiene un proyecto que utiliza Paperless-ngx? Este botón permite a sus lectores desplegarlo en un VPS con un clic, sin leer documentación de Docker.

Markdown

[![Deploy Paperless-ngx on ServOrbit](https://servorbit.com/brand/deploy/button.svg)](https://servorbit.com/vps-cloud?template=paperless-ngx&utm_source=deploy-badge&utm_medium=referral&utm_campaign=paperless-ngx)

HTML

<a href="https://servorbit.com/vps-cloud?template=paperless-ngx&utm_source=deploy-badge&utm_medium=referral&utm_campaign=paperless-ngx"><img src="https://servorbit.com/brand/deploy/button.svg" alt="Deploy Paperless-ngx on ServOrbit" height="40"></a>

El botón lleva al pedido de un VPS con la plantilla preseleccionada. La imagen se sirve desde servorbit.com: no tiene que alojar nada por su parte.

Soluciones complementarias

Colaboración y productividad

Nextcloud

Almacenamiento, compartición y colaboración en equipo. Sus archivos, calendarios y contactos en su propia infraestructura.

Colaboración y productividad

Mattermost

Mensajería de equipo segura y autoalojada. Canales, hilos, integraciones — sin depender de Slack ni de Teams.

Colaboración y productividad

Wiki.js

Base de conocimiento moderna para sus equipos. Documentación estructurada, búsqueda de texto completo y gestión detallada de los accesos.

Compartir la información y colaborar.

Active Paperless-ngx en su infraestructura.

VPS Cloud dedicado: IPv4 incluida, centro de datos europeo, soporte incluido. Sus datos nunca salen de su servidor.

Configuración recomendada: 2 GB (4 GB recomendado) RAM · 2 vCPU

¿Necesita ayuda?

Consulte nuestro centro de ayuda y nuestra FAQ, o contacte con nuestro equipo: llamada, WhatsApp o correo electrónico. Soporte en francés, inglés y árabe.

Escribir por WhatsApp

o escribirnos