Cómo Autohospedar Paperless-ngx en un VPS (Guía Completa)

Autohospedar Paperless-ngx, un sistema de gestión documental, en un Servidor Privado Virtual (VPS) puede optimizar tu flujo de trabajo y mejorar la privacidad de los datos. Esta guía te llevará a través de los pasos necesarios para instalar Paperless-ngx utilizando Docker en un VPS, haciéndolo accesible tanto para desarrolladores como para entusiastas del homelab.

¿Qué es Paperless-ngx?

Paperless-ngx es una aplicación de código abierto que te permite escanear, cargar y gestionar tus documentos sin esfuerzo. Construido sobre la ética de Paperless, esta variante moderna ofrece características mejoradas y una interfaz más amigable. Al autohospedar, mantienes el control sobre tus documentos sin depender de servicios de terceros.

Elegir un Proveedor de VPS

Antes de comenzar, necesitas elegir un proveedor de VPS. A continuación, se presenta una comparación de algunas opciones principales:

Puedes encontrar una comparación completa de VPS aquí.

Requisitos del Sistema

Antes de la instalación, asegúrate de que tu VPS cumpla con los siguientes requisitos:

• Al menos 2GB de RAM (4GB recomendado)
• 20GB de almacenamiento SSD
• Un nombre de dominio (opcional pero recomendable)
• Docker y Docker Compose instalados

Guía de Instalación Paso a Paso

Paso 1: Configura tu VPS

Provisión del VPS elegido. Por ejemplo, puedes crear una nueva instancia con Hetzner Cloud por 4.15 EUR/mes o usar Contabo por solo 5.99 EUR/mes.

1. Conéctate a tu servidor usando SSH:

   ssh root@tu_ip_del_servidor

2. Actualiza tu sistema:

   apt update && apt upgrade -y

Paso 2: Instala Docker y Docker Compose

Necesitas tener Docker y Docker Compose instalados en tu VPS. Usa los siguientes comandos:

1. Instalar Docker:

   apt install -y docker.io
   systemctl start docker
   systemctl enable docker

2. Instalar Docker Compose:

   apt install -y docker-compose

Paso 3: Configura Paperless-ngx

1. Crea un directorio para Paperless-ngx:

   mkdir ~/paperless
   cd ~/paperless

2. Crea un archivo docker-compose.yml:

   version: '3.7'
   services:
     paperless-ngx:
       image: ghcr.io/jfcherng/paperless-ngx:latest
       restart: always
       volumes:
         - ./data:/usr/src/paperless/data
       ports:
         - "8000:8000"
       environment:
         PAPERLESS_REDIS: redis://redis:6379
         PAPERLESS_DBHOST: db
         PAPERLESS_DBUSER: paperless
         PAPERLESS_DBPASS: password
     redis:
       image: redis:latest
       restart: always
     db:
       image: postgres:latest
       restart: always
       environment:
         POSTGRES_USER: paperless
         POSTGRES_PASSWORD: password
         POSTGRES_DB: paperless
       volumes:
         - ./postgres:/var/lib/postgresql/data

3. Lanza Paperless-ngx:

   docker-compose up -d

Paso 4: Accediendo a la Aplicación

Una vez que los contenedores estén en funcionamiento, puedes acceder a Paperless-ngx navegando a http://tu_ip_del_servidor:8000 en tu navegador web. Puede que desees configurar un proxy inverso usando Nginx o Traefik para el uso con un dominio real.

Preguntas Frecuentes

1. ¿Cuáles son los beneficios de autohospedar Paperless-ngx?

Autohospedar Paperless-ngx en un VPS proporciona un control y una privacidad de datos mejorados, ya que tus documentos se almacenan en tu propio servidor en lugar de en servicios de terceros. Este enfoque asegura que estés a cargo de tus prácticas de copia de seguridad y seguridad. Además, puedes personalizar la aplicación para adaptarla a tus necesidades de flujo de trabajo específicas sin las limitaciones impuestas por soluciones alojadas.

2. ¿Cuánto almacenamiento necesito para Paperless-ngx?

Si bien el almacenamiento mínimo recomendado es de alrededor de 20GB, en última instancia, depende de la cantidad de documentos que planeas gestionar. Si manejas archivos de alta resolución o un gran número de documentos, considera aumentar tu almacenamiento en consecuencia. Aprovechar un proveedor de VPS como DigitalOcean o Vultr para opciones de almacenamiento escalables también es una opción inteligente para tamaños de archivo en crecimiento.

3. ¿Puedo ejecutar otras aplicaciones en el mismo VPS?

Sí, puedes ejecutar múltiples aplicaciones en el mismo VPS utilizando Docker para aislar cada servicio. Cada aplicación puede ejecutarse en su propio contenedor, evitando conflictos de recursos. Sin embargo, asegúrate de que tu VPS tenga suficientes recursos (CPU, RAM y espacio en disco) para manejar estas aplicaciones simultáneamente. Es aconsejable monitorear el rendimiento de tu servidor regularmente para evitar problemas de sobrecarga.

En conclusión, autohospedar Paperless-ngx en un VPS es un proyecto gratificante que ofrece varios beneficios para la gestión documental, especialmente para desarrolladores y entusiastas del homelab. Siguiendo esta guía, puedes lograr un sistema autónomo y eficiente para organizar tus documentos de manera segura.