Requisitos del servidor para Paperless-ngx: configuración básica y cómo calcularla
Para un archivo de hasta 1 000 documentos de Paperless-ngx bastan 2 vCPU, 4 GB de RAM y 80 GB de almacenamiento NVMe, pero para importar mediante OCR más de 10 000 archivos se necesitan al menos 4 vCPU y 8 GB de RAM.
Paperless-ngx es una aplicación self-hosted relativamente ligera cuando está inactiva: la interfaz web, PostgreSQL, Redis y los procesos en segundo plano suelen consumir menos de 1 vCPU. La carga aumenta cuando llegan documentos nuevos. Cada PDF, escaneo o imagen pasa por OCR mediante OCRmyPDF y Tesseract; con Apache Tika y Gotenberg activados también se añaden la conversión de archivos de Office, la extracción de texto y el renderizado de PDF.
Por eso, los requisitos del servidor para Paperless-ngx no deben evaluarse solo según el número de usuarios. Los parámetros principales son el tamaño del archivo, el flujo diario de documentos, el porcentaje de escaneos sin capa de texto, la resolución de las imágenes y la necesidad de procesar rápidamente una cola acumulada.
Qué servicios utiliza Paperless-ngx
- PostgreSQL almacena los metadatos, las etiquetas, los corresponsales, el índice de texto completo y la configuración.
- Redis se utiliza para las colas y las tareas en segundo plano; normalmente necesita entre 128 y 512 MB de RAM.
- Consumer supervisa la carpeta consume e inicia el procesamiento de documentos.
- OCRmyPDF y Tesseract reconocen los escaneos, crean archivos PDF con texto buscable y generan el principal pico de CPU.
- Gotenberg convierte DOCX, XLSX, HTML y otros formatos de Office a PDF.
- Apache Tika extrae texto y metadatos de los formatos compatibles.
Por qué debes dimensionar según los picos de carga
Un usuario que abre documentos en el navegador apenas carga el servidor. La situación cambia al subir 500 escaneos de 5–20 páginas: varios procesos de OCR pueden ocupar todos los núcleos durante decenas de minutos u horas. El enfoque para elegir el hardware es el mismo que al planificar otros servicios: primero mide el trabajo en segundo plano durante los picos y después deja margen de capacidad. Este principio se explica con más detalle en el artículo sobre cómo elegir hardware para aplicaciones self-hosted.
Requisitos de hardware de Paperless ngx según el tamaño del archivo
Los requisitos de hardware de Paperless ngx dependen sobre todo del número de documentos y del tipo de importación. Un archivo de 10 000 PDF electrónicos puede ocupar 10–30 GB, mientras que 10 000 contratos escaneados a 300 dpi suelen requerir entre 80 y 250 GB incluso antes de crear las copias de seguridad.
Escala → especificaciones
Para un archivo de hasta 10 000 documentos y cargas periódicas de OCR bastan 4 vCPU, 8 GB de RAM, 200 GB de almacenamiento NVMe y un puerto de 1 Gbps.
| Escala de carga | vCPU | RAM | Disco | Puerto de red | Tráfico | Precio |
|---|---|---|---|---|---|---|
| Hasta 1 000 documentos, hasta 50 nuevos al día | 2 vCPU | 4 GB | 80 GB NVMe | 1 Gbps | 1 TB/mes | aproximadamente desde 8 $/mes |
| 1 000–10 000 documentos, hasta 300 nuevos al día | 4 vCPU | 8 GB | 200 GB NVMe | 1 Gbps | 2 TB/mes | aproximadamente desde 18 $/mes |
| 10 000–50 000 documentos, hasta 1 000 nuevos al día | 6–8 vCPU | 16 GB | 500 GB NVMe | 1 Gbps | 3–5 TB/mes | aproximadamente desde 35 $/mes |
| Más de 50 000 documentos, importación masiva y varios usuarios | 8–12 vCPU | 24–32 GB | 1 TB NVMe | 1 Gbps | 5 TB+/mes | aproximadamente desde 70 $/mes |
Los precios son una referencia general de mercado a marzo de 2025 para VPS de la clase correspondiente; el coste real depende de la ubicación, el tipo de CPU, la capacidad NVMe y el tráfico incluido.
Cómo interpretar los niveles de carga
El primer nivel es adecuado para un archivo doméstico, facturas personales, contratos y correo electrónico. 2 vCPU pueden procesar OCR, pero una cola de varios cientos de documentos no se resolverá de inmediato. Es una opción razonable si la importación se ejecuta por la noche o los archivos llegan de forma gradual.
El nivel de 4 vCPU y 8 GB de RAM es el mínimo práctico para una empresa pequeña o un departamento. Permite mantener PostgreSQL, Redis, los contenedores de Paperless-ngx y Gotenberg sin una falta constante de memoria, además de procesar varios documentos en paralelo.
Un archivo de más de 50 000 documentos requiere algo más que núcleos adicionales. También son importantes un NVMe rápido, espacio adicional para el crecimiento del almacenamiento, el mantenimiento periódico de PostgreSQL y copias de seguridad independientes. Si en el mismo servidor funcionan otros servicios, es mejor no mezclar los recursos de Paperless-ngx con bases de datos críticas.
¿Buscas un servidor fiable para tus proyectos?
VPS desde 10 $/mes y servidores dedicados desde 9 $/mes, con NVMe, protección DDoS y soporte 24/7.
Ver ofertas →Paperless ngx RAM y CPU: qué ocurre durante el OCR y la conversión
El consumo de RAM y CPU de Paperless ngx es irregular: cuando está inactivo, el stack suele mantenerse en 1–2 GB de RAM y una fracción de un núcleo, pero durante el OCR un escaneo pesado puede ocupar por completo 1 hilo de CPU.
Rendimiento del OCR: referencias prácticas
Tesseract, integrado en OCRmyPDF, escala bien según el número de documentos procesados simultáneamente, pero no convierte un único documento en un proceso perfectamente multihilo. En una CPU moderna con una frecuencia aproximada de 3,0 GHz, una página A4 a 300 dpi suele reconocerse en 1–5 segundos; sin embargo, los escaneos en color, las tablas, el contraste deficiente y 600 dpi pueden aumentar el tiempo hasta 10–30 segundos por página.
Como referencia práctica, un servidor con 4 vCPU rápidas puede procesar aproximadamente 1 000–3 000 páginas normales por hora con una cola en paralelo, siempre que el disco no sea el cuello de botella. Con 2 vCPU compartidas lentas, la misma tarea puede tardar entre 2 y 4 veces más. Para OCR son más importantes el rendimiento de un solo núcleo y la ausencia de un throttling estricto de CPU que un número nominalmente elevado de núcleos virtuales.
Tika y Gotenberg: cuándo necesitas recursos adicionales
Los requisitos del servidor OCR de Paperless ngx deben tener en cuenta Tika y Gotenberg cuando se trabaja con documentos de Office, correos electrónicos, presentaciones y HTML. Gotenberg utiliza procesos similares a Chromium o LibreOffice y puede ocupar temporalmente entre 500 MB y 1,5 GB de RAM al convertir un archivo complejo. Para un servidor con Gotenberg no conviene elegir menos de 4 GB de RAM, aunque el archivo sea pequeño.
Limita el paralelismo de los consumidores si el VPS se comparte con otras aplicaciones. Por ejemplo, la configuración inicial de Docker Compose podría ser la siguiente:
services:
webserver:
image: ghcr.io/paperless-ngx/paperless-ngx:latest
environment:
PAPERLESS_THREADS_PER_WORKER: "2"
PAPERLESS_WORKERS: "2"
PAPERLESS_OCR_LANGUAGE: "rus+eng"
PAPERLESS_TASK_WORKERS: "2"En 2 vCPU es lógico empezar con 1–2 tareas de OCR; en 4 vCPU, con 2–4. Después de una importación masiva, comprueba la carga de CPU, el uso de memoria y la longitud de la cola en lugar de aumentar workers a ciegas.
Cuánta RAM necesita Paperless-ngx y cómo calcular el almacenamiento
La respuesta práctica a «cuánta RAM necesita Paperless ngx» es la siguiente: 4 GB es el mínimo para un archivo personal, 8 GB es un nivel cómodo con Gotenberg y 16 GB es lo habitual para 10 000–50 000 documentos y una importación en paralelo.
Memoria: contenedores, caché de archivos y base de datos
No asignes RAM únicamente sumando el consumo de los contenedores. Linux utiliza la memoria libre como caché de archivos, mientras que PostgreSQL se beneficia de la caché del índice y de los metadatos consultados con frecuencia. En un VPS con 4 GB, tras iniciar Paperless-ngx, PostgreSQL, Redis y Gotenberg, la memoria disponible puede reducirse rápidamente a 1 GB. Durante la conversión de DOCX o el OCR de PDF grandes comienza a utilizarse swap y el tiempo de procesamiento aumenta varias veces.
- 4 GB de RAM: hasta 1 000–3 000 documentos, 1–2 workers en segundo plano y sin cargas por lotes pesadas.
- 8 GB de RAM: hasta 10 000 documentos, 2–4 workers, Tika/Gotenberg e importación diaria.
- 16 GB de RAM: archivo de hasta 50 000 documentos, varios usuarios y margen para PostgreSQL y las importaciones.
- 24–32 GB de RAM: archivo grande, 8+ flujos de OCR, servicios adicionales o procesamiento de TIFF/PDF grandes.
Fórmula para calcular el almacenamiento
Debes calcular el tamaño del disco según los originales, no según el tamaño de PostgreSQL. Utiliza esta fórmula: archivo de originales × 1,5 + 20–50 GB para el sistema, la base de datos y los archivos temporales. El coeficiente 1,5 cubre el PDF posterior al OCR, las miniaturas, el índice, los datos temporales y un crecimiento moderado.
Por ejemplo, si los documentos actuales ocupan 120 GB, el mínimo razonable es un NVMe de 200 GB, pero para crecer durante un año es preferible disponer de 300–400 GB. No guardes la única copia de seguridad en el mismo disco: un fallo del sistema de archivos, un borrado accidental o la vulneración del servidor afectarían tanto al archivo como al backup.
Para definir la estrategia de almacenamiento, puedes aplicar los enfoques del artículo sobre cómo calcular el volumen de backups y la deduplicación: reserva espacio independiente y comprueba la restauración, no solo que la tarea se haya iniciado correctamente.
Requisitos de Paperless ngx para red, disco y seguridad del servidor
Los requisitos de red de un servidor Paperless ngx suelen ser modestos: para una oficina basta un puerto de 1 Gbps, y son más importantes una conexión estable y suficiente tráfico mensual para las cargas y las copias de seguridad.
Tráfico: qué se transmite realmente
Al trabajar desde el navegador, los usuarios suben los originales y descargan los PDF. Si cada mes se reciben 500 documentos de 10 MB, el volumen entrante será de aproximadamente 5 GB. El mayor consumo aparece durante las copias de seguridad: un archivo de 200 GB transferirá unos 200 GB durante la primera carga, mientras que las copias incrementales posteriores solo enviarán los datos modificados.
Un puerto de 1 Gbps puede transmitir teóricamente hasta 125 MB/s, pero la velocidad está limitada por el disco, la ruta de red, el rendimiento del VPS y el almacenamiento remoto. Para la sincronización inicial de 200 GB calcula varias horas, no 30 minutos. Si accedes a través de Internet, utiliza HTTPS, contraseñas complejas, autenticación de dos factores cuando exista un SSO externo y limita el acceso mediante VPN o firewall.
Por qué NVMe es mejor que un disco SATA grande
El OCR lee el original, crea archivos temporales, escribe el PDF final y actualiza PostgreSQL. Un disco lento aumenta la latencia de toda la cola. Un NVMe con decenas de miles de IOPS es mucho más adecuado para ejecutar simultáneamente la base de datos y las importaciones que un HDD. Un SSD SATA es aceptable para un archivo pequeño de hasta 1 000 documentos, pero para 10 000+ documentos es preferible NVMe.
Si necesitas hardware aislado, RAID, un gran conjunto de almacenamiento local o decenas de tareas simultáneas, consulta cómo elegir un servidor Linux dedicado según la carga. Un servidor dedicado está especialmente justificado cuando Paperless-ngx forma parte de la gestión documental corporativa y deja de ser un archivo personal.
Hardware self-hosted para Paperless ngx: VPS o servidor dedicado
En la mayoría de los casos, el hardware self-hosted para Paperless ngx comienza con un VPS: hasta 10 000 documentos no hace falta pagar por un servidor físico si tienes 4 vCPU, 8 GB de RAM y almacenamiento NVMe.
Cuándo basta con un VPS
Un VPS es adecuado para un archivo personal, una empresa pequeña, un departamento de hasta 20 empleados y una carga gradual de documentos. Elige una configuración que permita ampliar la RAM y el disco sin realizar una migración compleja. Para OCR son preferibles las CPU con un rendimiento predecible: un VPS barato con una alta sobreasignación de recursos puede ofrecer una velocidad de reconocimiento inestable.
La configuración inicial óptima es un VPS independiente para Paperless-ngx, Docker Compose, un volcado diario de PostgreSQL y una copia remota del directorio media. No expongas PostgreSQL ni Redis a Internet: desde el exterior solo debe estar disponible el reverse proxy o el contenedor web mediante HTTPS.
Cuándo pasar a un servidor dedicado
Necesitas un servidor dedicado con un archivo de 50 000+ documentos, el procesamiento diario de miles de páginas, requisitos de RAID local, numerosas integraciones o varios servicios internos alojados simultáneamente. Una configuración con 8 núcleos a 3,0 GHz+, 32 GB de RAM ECC y 2 × 1 TB NVMe en RAID 1 ofrece un procesamiento mucho más predecible que un VPS sobrecargado.
No alojes en el mismo nodo LLM que consuman muchos recursos, codificación de vídeo y OCR sin aplicar límites estrictos a los contenedores: los servicios competirán por la CPU y la memoria. Si tu infraestructura incluye modelos locales, consulta por separado las recomendaciones para IA self-hosted, RAM y VRAM.
Despliegue y optimización del rendimiento de Paperless-ngx
El funcionamiento estable de Paperless-ngx comienza separando los datos, configurando correctamente los límites de Docker y controlando el espacio libre: un disco ocupado al 100 % puede detener tanto PostgreSQL como la importación de documentos.
Parámetros mínimos de Docker Compose
Para un despliegue en producción, fija los directorios de datos en NVMe, configura la zona horaria y los idiomas de OCR, y programa tareas periódicas de backup. Ejemplo de variables principales:
services:
webserver:
environment:
PAPERLESS_REDIS: redis://redis:6379
PAPERLESS_DBHOST: db
PAPERLESS_DATA_DIR: /usr/src/paperless/data
PAPERLESS_MEDIA_ROOT: /usr/src/paperless/media
PAPERLESS_CONSUMPTION_DIR: /usr/src/paperless/consume
PAPERLESS_OCR_LANGUAGE: rus+eng
PAPERLESS_TIME_ZONE: Europe/Moscow
PAPERLESS_URL: https://paperless.example.comLos directorios data, media y la base de datos PostgreSQL deben estar en persistent volumes. La carpeta consume puede crecer temporalmente si se produce un error de OCR, por lo que debes supervisarla por separado.
Cómo comprobar la cola y el estado de los contenedores
Después de importar 100–200 documentos de prueba, comprueba la carga real. Comandos para el diagnóstico básico:
docker compose ps
docker stats --no-stream
docker compose logs --tail=100 webserver
df -h
free -h
uptimeSi la CPU se mantiene constantemente por encima del 90 % durante más de 30 minutos y la cola no disminuye, primero reduce el número de tareas paralelas o aumenta el número de vCPU. Si quedan menos de 500 MB de memoria libre y el swap está activo, aumenta la RAM. Si el NVMe supera el 80 % de ocupación, amplía el volumen con antelación: PostgreSQL y Docker necesitan espacio libre para funcionar correctamente.
Copias de seguridad, actualizaciones y control de recursos
En Paperless-ngx no basta con copiar únicamente los PDF: una restauración completa requiere los originales, la base de datos PostgreSQL, la configuración y las claves utilizadas para el cifrado o las integraciones.
Qué debe incluir el backup
- El directorio
mediacon los documentos originales y procesados. - Un volcado de PostgreSQL al menos 1 vez al día.
- Los archivos Docker Compose,
.envy la configuración del reverse proxy. - Las claves y secretos, incluido
PAPERLESS_SECRET_KEY, en un almacenamiento protegido. - Una copia independiente fuera del VPS o servidor dedicado principal.
Comprueba la restauración al menos una vez por trimestre en una máquina de pruebas. Un backup de 300 GB que nunca se ha restaurado no demuestra que tus datos estén protegidos. Para un archivo crítico, utiliza la regla 3-2-1: 3 copias, 2 soportes diferentes y 1 copia fuera de la ubicación principal.
Cuándo ampliar la configuración
Las señales para actualizar son claras: carga media de CPU superior al 80 % durante la importación, una cola de OCR que no se procesa durante la noche de trabajo, uso constante del swap, menos del 20 % de espacio libre en el disco o una interfaz que responde notablemente más despacio. En ese caso, primero añade vCPU para el OCR, después RAM para la base de datos y la caché, y finalmente amplía el NVMe.
No confundas una carga elevada de CPU durante una migración puntual con una necesidad permanente de una configuración cara. Puedes importar 30 000 archivos antiguos en un servidor ampliado temporalmente y, una vez terminado el procesamiento, reducir los recursos al nivel necesario para el funcionamiento diario.
Preguntas frecuentes
Respuestas sobre los recursos de Paperless-ngx
¿Cuánta RAM necesita Paperless-ngx? Para un archivo personal de hasta 1 000 documentos bastan 4 GB de RAM. Si están activados Gotenberg, Apache Tika y el procesamiento periódico mediante OCR, elige 8 GB. Para 10 000–50 000 documentos, varios usuarios y 4+ tareas en segundo plano, es razonable asignar 16 GB de RAM para evitar el uso constante del swap.
¿Cuántas vCPU necesita el OCR de Paperless-ngx? El mínimo son 2 vCPU para importaciones ocasionales, pero 4 vCPU resultan mucho más cómodas para el procesamiento diario. Si cargas 1 000 páginas o más al día, elige 6–8 vCPU. Un proceso de OCR puede ocupar casi un núcleo completo, por lo que el número de núcleos determina la velocidad con la que se vacía la cola.
¿Paperless-ngx necesita un disco NVMe? Para un archivo de hasta 1 000 documentos puedes utilizar un SSD SATA, pero para 10 000+ archivos se recomienda NVMe. Paperless-ngx lee simultáneamente los originales, crea PDF temporales, escribe miniaturas y actualiza PostgreSQL. El mínimo práctico es 80 GB NVMe, mientras que para un archivo mediano suele hacer falta una capacidad de 200 GB.
¿Se puede instalar Paperless-ngx en un VPS con 2 GB de RAM? Técnicamente, una instalación mínima sin procesamiento pesado puede funcionar en ocasiones con 2 GB de RAM, pero para producción es arriesgado. PostgreSQL, Redis, el contenedor de Paperless-ngx y el OCR pueden provocar swap u OOM al procesar un PDF grande. Para un funcionamiento fiable, utiliza como mínimo 4 GB de RAM y 2 vCPU.
Conclusiones
Recomendación para elegir el servidor
Para la mayoría de los archivos de Paperless-ngx de hasta 10 000 documentos, elige un VPS con 4 vCPU, 8 GB de RAM y 200 GB NVMe. Si realizas OCR masivo, tienes un archivo de 50 000+ archivos o cargas miles de páginas al día, pasa a 8 vCPU, 16–32 GB de RAM y al menos 1 TB NVMe con copias de seguridad independientes.
VPS NVMe activado en 60 segundos: acceso root completo, más de 20 ubicaciones y pago con tarjeta o criptomonedas.
Elegir plan
