Hoe self-host Paperless-ngx op een VPS (Complete Gids)

Self-hosten van Paperless-ngx, een documentbeheersysteem, op een Virtual Private Server (VPS) kan je workflow stroomlijnen en de dataprivacy verbeteren. Deze gids neemt je mee door de stappen die nodig zijn om Paperless-ngx te installeren met Docker op een VPS, waardoor het toegankelijk is voor ontwikkelaars en homelabliefhebbers.

Wat is Paperless-ngx?

Paperless-ngx is een open-source applicatie waarmee je je documenten eenvoudig kunt scannen, uploaden en beheren. Gebouwd op het ethos van Paperless, biedt deze moderne variant verbeterde functies en een gebruiksvriendelijkere interface. Door zelf te hosten, behoud je controle over je documenten zonder afhankelijk te zijn van derde partijen.

Keuze van een VPS-provider

Voordat je begint, moet je een VPS-provider kiezen. Hieronder een vergelijking van enkele topopties:

Je kunt een volledige VPS-vergelijking hier vinden.

Systeemvereisten

Voor de installatie, zorg dat je VPS voldoet aan de volgende eisen:

• Minimaal 2GB RAM (4GB aanbevolen)
• 20GB SSD-opslag
• Een domeinnaam (optioneel maar aanbevolen)
• Docker en Docker Compose geïnstalleerd

Stap-voor-stap Installatiegids

Stap 1: Je VPS opzetten

Provision je gekozen VPS. Bijvoorbeeld, je kunt een nieuwe instantie aanmaken met Hetzner Cloud voor 4.15 EUR/maand of gebruik Contabo voor slechts 5.99 EUR/maand.

1. Maak verbinding met je server via SSH:

   ssh root@your_server_ip

2. Werk je systeem bij:

   apt update && apt upgrade -y

Stap 2: Installeer Docker en Docker Compose

Je moet Docker en Docker Compose installeren op je VPS. Gebruik de volgende commando’s:

1. Installeer Docker:

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

2. Installeer Docker Compose:

   apt install -y docker-compose

Stap 3: Paperless-ngx instellen

1. Maak een directory voor Paperless-ngx:

   mkdir ~/paperless
   cd ~/paperless

2. Maak een docker-compose.yml bestand:

   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. Lanceer Paperless-ngx:

   docker-compose up -d

Stap 4: Toegang tot de applicatie

Zodra de containers draaien, kun je toegang krijgen tot Paperless-ngx door te navigeren naar http://your_server_ip:8000 in je webbrowser. Wil je een reverse proxy instellen met Nginx of Traefik voor gebruik met een eigen domein, dan wordt dat aanbevolen.

Veelgestelde vragen

1. Wat zijn de voordelen van self-hosting van Paperless-ngx?

Self-hosting van Paperless-ngx op een VPS biedt betere controle over je gegevens en verhoogt de privacy, omdat je documenten opgeslagen worden op je eigen server in plaats van bij derden. Je bent zelf verantwoordelijk voor je back-ups en beveiligingsmaatregelen. Daarnaast kun je de applicatie aanpassen aan jouw specifieke workflow zonder beperkingen van gehoste oplossingen.

2. Hoeveel opslag heb ik nodig voor Paperless-ngx?

De minimale aanbevolen opslag is ongeveer 20GB, maar dit hangt af van het aantal documenten dat je wilt beheren. Als je hoge-resolutie bestanden hebt of veel documenten, overweeg dan om je opslag uit te breiden. VPS-aanbieders zoals DigitalOcean of Vultr bieden schaalbare opslagopties, wat handig is voor groeiende bestandsgroottes.

3. Kan ik andere applicaties op dezelfde VPS draaien?

Ja, je kunt meerdere applicaties draaien op dezelfde VPS door Docker te gebruiken om elke dienst te isoleren. Elke applicatie kan in zijn eigen container draaien, wat resourceconflicten voorkomt. Zorg er wel voor dat je VPS voldoende resources heeft (CPU, RAM en schijfruimte) om deze applicaties tegelijk te ondersteunen. Het is verstandig om regelmatig de prestaties van je server te monitoren om overbelasting te voorkomen.

Kortom, self-hosting van Paperless-ngx op een VPS is een bevredigend project dat vele voordelen biedt voor documentenbeheer, vooral voor ontwikkelaars en homelabliefhebbers. Door deze gids te volgen, kun je een autonome, efficiënte systeem opzetten voor het veilig organiseren van je documenten. --- End ---