Hoe zelf hosten van BookStack op een VPS (Compleide Gids)

BookStack is een eenvoudig, zelf-gehost platform om documentatie te organiseren en op te slaan. Als je een ontwikkelaar of een homelabber bent die BookStack op een VPS wil zelf hosten, neemt deze gids je mee door het installatieproces stap voor stap. We zullen de installatie met Docker bespreken, wat de deployment en het beheer van applicaties vereenvoudigt.

Waarom BookStack gebruiken?

BookStack stelt je in staat om eenvoudig wiki-stijl documentatie te maken, met functies zoals:

• Geneste pagina’s
• Markdown-ondersteuning
• Gebruikersrollen en rechten
• Ingebouwde zoekmogelijkheden

Dit maakt BookStack een ideale keuze voor iedereen die documentatie wil bouwen en onderhouden voor projecten of persoonlijk gebruik.

Een VPS Provider kiezen

Er zijn verschillende VPS-providers om uit te kiezen, afhankelijk van je budget en wensen. Hieronder een korte vergelijking van populaire providers:

Bij het kiezen van een VPS-provider, overweeg factoren zoals prijs, prestaties en gebruiksgemak. Als je twijfelt, bekijk dan onze volledige VPS vergelijking voor meer opties.

Je VPS voorbereiden

1. Deploy je VPS: Kies een provider uit de tabel en zet je VPS op. Kies je gewenste Linux-distributie (Ubuntu/Debian wordt aanbevolen).

2. Toegang tot je server: Gebruik SSH om verbinding te maken met je server. Je kunt een terminalprogramma zoals PuTTY gebruiken of de terminal van je systeem.

   ssh gebruikersnaam@jouw_vps_ip

3. Werk je systeem bij: Houd je systeem altijd up-to-date.

   sudo apt update && sudo apt upgrade -y

Docker installeren

BookStack kan eenvoudig worden uitgevoerd met Docker. Installeer Docker door de volgende commando’s uit te voeren:

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install docker-ce -y

Je kunt de installatie verifiëren door de Docker-versie te controleren:

docker --version

Docker Compose installeren

Docker Compose is een tool voor het definiëren en uitvoeren van multi-container Docker applicaties. Installeer Docker Compose met de volgende commando’s:

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Verifieer dat Docker Compose correct is geïnstalleerd:

docker-compose --version

BookStack implementeren

1. Maak een map voor BookStack:

   mkdir ~/bookstack
   cd ~/bookstack

2. Maak een docker-compose.yml bestand:

   Gebruik je favoriete teksteditor om het bestand aan te maken:

   nano docker-compose.yml

   Voeg de volgende configuratie toe:

   version: '2'
   services:
     bookstack:
       image: solidnerd/bookstack
       ports:
         - "80:80"
       environment:
         - DB_HOST=db
         - DB_USER=bookstack
         - DB_PASS=bookstackpassword
         - DB_DATABASE=bookstack
       depends_on:
         - db
   
     db:
       image: mysql:5.7
       environment:
         - MYSQL_ROOT_PASSWORD=rootpassword
         - MYSQL_DATABASE=bookstack
         - MYSQL_USER=bookstack
         - MYSQL_PASSWORD=bookstackpassword
       volumes:
         - db_data:/var/lib/mysql
   
   volumes:
     db_data:

   Pas de database-wachtwoorden aan indien nodig.

3. Start de containers:

   Voer het volgende commando uit om BookStack te starten:

   docker-compose up -d

   Dit commando downloadt de benodigde images en start ze in detached mode.

4. Toegang tot BookStack:

   Open je webbrowser en ga naar http://jouw_vps_ip. Je zou de setup pagina van BookStack moeten zien. Volg de instructies op het scherm om de installatie te voltooien.

BookStack beheren

Je kunt BookStack beheren via de webinterface. Je kunt gebruikers toevoegen, verschillende boeken, hoofdstukken en pagina’s aanmaken volgens je behoeften.

Veelgestelde Vragen

Q1: Kan ik BookStack zonder Docker draaien?

Ja, je kunt BookStack zonder Docker installeren, maar dat vereist meer handmatige configuratie, inclusief PHP, MariaDB en een webserver zoals Apache of Nginx. Docker vereenvoudigt dit proces aanzienlijk, waardoor deployment en updates veel makkelijker gaan.

Q2: Hoe maak ik een back-up van mijn BookStack installatie?

Om een back-up te maken van je BookStack installatie, moet je zowel de database als de applicatiebestanden back-uppen. Dit kun je doen door Docker-commando’s te gebruiken om de databasebestanden te kopiëren en de gegevens uit je BookStack-map op te slaan. Het automatiseren via scripts kan dit proces verder stroomlijnen.

Q3: Is BookStack veilig voor zelf-hosting?

BookStack is relatief veilig, vooral wanneer je het zelf host. Het is belangrijk om sterke wachtwoorden te gebruiken, de software up-to-date te houden en passende firewallregels in te stellen. Daarnaast helpt het gebruik van SSL (via Let’s Encrypt of vergelijkbare diensten) om veilige toegang tot je BookStack via het web te garanderen.

Conclusie

Zelf hosten van BookStack op een VPS biedt een krachtige manier om je documentatie te beheren. Met de stappen uit deze gids kun je je eigen instance van BookStack efficiënt uitrollen en beheren. Vergeet niet om de verschillende functies van BookStack te ontdekken en het aan te passen aan je wensen terwijl je je kennisbasis uitbreidt. Voor andere opties en vergelijkingen van VPS-providers, bekijk onze volledige VPS vergelijking. Veel plezier met hosten! --- Eind ---