Hoe je HedgeDoc Zelf-host op een VPS (Volledige Gids)

Introductie

HedgeDoc is een collaboratieve markdown-editor waarmee meerdere gebruikers documenten in real-time kunnen bewerken. Vaak wordt het gebruikt voor notities maken en documentatie binnen teams. Het zelf hosten van HedgeDoc op een Virtual Private Server (VPS) geeft je volledige controle over je gegevens en waarborgt je privacy. In deze gids doorlopen we de stappen om HedgeDoc te installeren op een VPS met Docker.

Vereisten

Een VPS: Kies een geschikte VPS-aanbieder. Hier is een korte vergelijking van enkele populaire opties:

Provider	Maandprijs	RAM	Diskruimte	CPU
Contabo VPS	5.99 EUR	4 GB	50 GB	2 Cores
Hetzner Cloud	4.15 EUR	2 GB	20 GB	1 Core
DigitalOcean	6 USD	2 GB	1 vCPU	1 Core
Vultr	6 USD	2 GB	1 vCPU	1 Core
Linode (Akamai)	5 USD	2 GB	1 vCPU	1 Core

Voor gedetailleerde vergelijkingen van verschillende VPS-providers, bekijk onze volle VPS-vergelijking.

SSH-toegang: Zorg dat je toegang hebt tot je VPS via SSH.
Docker en Docker Compose: Zorg dat zowel Docker als Docker Compose geïnstalleerd zijn op je VPS. Je kunt ze installeren met de volgende commando’s:
```
sudo apt update
sudo apt install -y docker.io docker-compose
```

Stap 1: Het Opzetten van de HedgeDoc-omgeving

Maak een directory voor HedgeDoc:
```
mkdir ~/hedgedoc
cd ~/hedgedoc
```

Maak een docker-compose.yml bestand in de hedgedoc-map. Voeg de volgende configuratie toe om HedgeDoc met PostgreSQL als database te installeren:

version: '3.1'

services:
  hedgedoc:
    image: hedgedoc/hedgedoc:latest
    environment:
      - CMD_URI=https://jouw-domein.com
      - DB_TYPE=postgres
      - DB_HOST=db
      - DB_PORT=5432
      - DB_USER=hedgedoc
      - DB_PASS=hedgedoc_wachtwoord
      - DB_NAME=hedgedoc
    ports:
      - '3000:3000'
    depends_on:
      - db

  db:
    image: postgres:latest
    environment:
      - POSTGRES_USER=hedgedoc
      - POSTGRES_PASSWORD=hedgedoc_wachtwoord
      - POSTGRES_DB=hedgedoc
    volumes:
      - db_data:/var/lib/postgresql/data

volumes:
  db_data:

Vervang jouw-domein.com door het domein dat je gaat gebruiken voor toegang tot HedgeDoc.

Stap 2: HedgeDoc draaien

Start de HedgeDoc-applicatie met Docker Compose:
```
docker-compose up -d
```
Controleer of HedgeDoc correct draait door de logs te bekijken:
```
docker-compose logs -f
```
Standaard is HedgeDoc bereikbaar via http://je-server-ip:3000. Voor een productie-omgeving wordt aangeraden een reverse proxy in te stellen.

Stap 3: Een Reverse Proxy Instellen met Nginx

Installeer Nginx:
```
sudo apt install -y nginx
```
Maak een nieuw configuratiebestand voor HedgeDoc:
```
sudo nano /etc/nginx/sites-available/hedgedoc
```

Voeg de volgende configuratie toe:

server {
    listen 80;
    server_name jouw-domein.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Activeer de configuratie:

sudo ln -s /etc/nginx/sites-available/hedgedoc /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Stap 4: HedgeDoc beveiligen met SSL

Installeer Certbot om SSL-certificaten te verkrijgen via Let’s Encrypt:
```
sudo apt install -y certbot python3-certbot-nginx
```
Vraag een SSL-certificaat aan voor je domein:
```
sudo certbot --nginx -d jouw-domein.com
```

Veelgestelde Vragen

1. Wat zijn de voordelen van HedgeDoc zelf-hosten?

Zelf-hosting biedt je ongeëvenaarde controle over je gegevens en privacy. In tegenstelling tot cloud-oplossingen beheer je zelf de beveiligingsupdates en aanpassingen volgens jouw wensen. Deze opzet is vooral belangrijk voor ontwikkelaars en homelabgebruikers die willen voldoen aan specifieke dataverwerkingsvereisten of HedgeDoc naadloos willen integreren in grotere systemen.

2. Kan ik HedgeDoc draaien op een VPS met lage specificaties?

Ja, HedgeDoc kan efficiënt draaien op een VPS met lage specificaties, mits deze aan de systeemvereisten voldoet. Voor basisgebruik volstaat een VPS met 2 GB RAM en minimale diskruimte. Voor grotere instances of samenwerking met meerdere gebruikers wordt echter een VPS aanbevolen met minstens 4 GB RAM en 50 GB diskruimte voor soepel functioneren. De prijsstructuur van providers zoals Contabo en Hetzner maakt dit betaalbaar.

3. Hoe kan ik mijn HedgeDoc-installatie bijwerken?

Het bijwerken van HedgeDoc is eenvoudig dankzij de Docker-opzet. Je kunt de nieuwste image ophalen en de containers opnieuw opstarten. Gebruik daarvoor de volgende commando’s:

docker-compose pull
docker-compose up -d

Na het uitvoeren van deze commando’s is het verstandig om regelmatig de release-opmerkingen van HedgeDoc te controleren op eventuele wijzigingen of migratiestappen om een naadloze werking te garanderen. Raadpleeg de HedgeDoc-documentatie voor specifieke details over versie-updates.

Conclusie

Zelf-hosting van HedgeDoc op een VPS geeft je toegang tot een krachtige markdown-editor, terwijl je volledige controle behoudt over je omgeving. Met de bovenstaande stappen kun je HedgeDoc effectief installeren, configureren en beveiligen. Geniet van real-time samenwerking zonder in te boeten aan privacy of dataveiligheid. --- END ---