Como Auto-Hospedar Paperless-ngx em um VPS (Guia Completo)

Auto-hospedar Paperless-ngx, um sistema de gerenciamento de documentos, em um Virtual Private Server (VPS) pode simplificar seu fluxo de trabalho e melhorar a privacidade dos dados. Este guia irá orientá-lo pelos passos necessários para instalar o Paperless-ngx usando Docker em um VPS, tornando-o acessível tanto para desenvolvedores quanto para entusiastas de homelab.

O que é Paperless-ngx?

Paperless-ngx é uma aplicação de código aberto que permite escanear, fazer upload e gerenciar seus documentos de forma fácil. Construído com base na filosofia do Paperless, esta versão moderna oferece recursos aprimorados e uma interface mais amigável. Ao auto-hospedar, você mantém o controle sobre seus documentos sem depender de serviços de terceiros.

Escolhendo um Fornecedor de VPS

Antes de começar, você precisa escolher um fornecedor de VPS. Abaixo, uma comparação de algumas das melhores opções:

Você pode encontrar uma comparação completa de VPS aqui.

Requisitos do Sistema

Antes da instalação, certifique-se de que seu VPS atende aos seguintes requisitos:

• Pelo menos 2GB de RAM (recomendado 4GB)
• 20GB de armazenamento SSD
• Um nome de domínio (opcional, mas recomendado)
• Docker e Docker Compose instalados

Guia Passo a Passo para Instalação

Passo 1: Configure seu VPS

Provisiona seu VPS escolhido. Por exemplo, você pode criar uma nova instância com Hetzner Cloud por 4,15 EUR/mês ou usar Contabo por apenas 5,99 EUR/mês.

1. Conecte-se ao seu servidor usando SSH:

   ssh root@seu_ip_do_servidor

2. Atualize seu sistema:

   apt update && apt upgrade -y

Passo 2: Instale Docker e Docker Compose

Você precisa ter Docker e Docker Compose instalados em seu VPS. Use os seguintes comandos:

1. Instale o Docker:

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

2. Instale o Docker Compose:

   apt install -y docker-compose

Passo 3: Configure o Paperless-ngx

1. Crie um diretório para o Paperless-ngx:

   mkdir ~/paperless
   cd ~/paperless

2. Crie um arquivo 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. Inicie o Paperless-ngx:

   docker-compose up -d

Passo 4: Acessando a Aplicação

Assim que os containers estiverem ativos, você pode acessar o Paperless-ngx navegando até http://seu_ip_do_servidor:8000 em seu navegador. Para uso de domínio real, considere configurar um proxy reverso usando Nginx ou Traefik.

FAQs

1. Quais são os benefícios de auto-hospedar Paperless-ngx?

Auto-hospedar Paperless-ngx em um VPS oferece maior controle e privacidade dos dados, já que seus documentos ficam armazenados no seu próprio servidor em vez de serviços de terceiros. Essa abordagem garante que você seja responsável por seus backups e práticas de segurança. Além disso, você pode personalizar o aplicativo para atender às suas necessidades específicas de fluxo de trabalho sem as limitações de soluções hospedadas.

2. Quanto de armazenamento eu preciso para Paperless-ngx?

Embora o armazenamento mínimo recomendado seja cerca de 20GB, isso depende do volume de documentos que você pretende gerenciar. Se trabalhar com arquivos de alta resolução ou uma grande quantidade de documentos, considere aumentar seu armazenamento de acordo. Utilizar um provedor de VPS como DigitalOcean ou Vultr, que oferece opções de armazenamento escalável, também é uma boa estratégia para tamanhos de arquivo em crescimento.

3. Posso rodar outros aplicativos no mesmo VPS?

Sim, é possível executar múltiplos aplicativos no mesmo VPS usando Docker para isolar cada serviço. Cada aplicação roda em seu próprio container, evitando conflitos de recursos. Contudo, certifique-se de que seu VPS possui recursos suficientes (CPU, RAM e espaço em disco) para suportar esses aplicativos simultaneamente. Recomenda-se monitorar regularmente o desempenho do servidor para evitar sobrecarga.

Em resumo, auto-hospedar Paperless-ngx em um VPS é um projeto gratificante que oferece diversas vantagens para gerenciamento de documentos, especialmente para desenvolvedores e entusiastas de homelab. Seguindo este guia, você pode obter um sistema autônomo e eficiente para organizar seus documentos de forma segura. --- FIM ---