Skip to main content

How to Deploy BookStack Wiki

Introduction

BookStack is a free wiki, this guide describes how to set it up using Linux and hosting it online.

Step-by-Step Guide

Deploy the Linux Server

  • Deploy a Ubuntu Server 24.10.
  • Record the IP, login and certificates in a safe location.
  • Take note of any network security groups configured by the hosting provider.

Configure the Linux Server

Create a user account where BookStack will be accessed from.

sudo adduser bookstack
sudo usermod -aG sudo bookstack
su - bookstack

Perform updates.

sudo apt update && sudo apt upgrade -y
sudo reboot

Configure automatic updates.

sudo apt install unattended-upgrades
systemctl status unattended-upgrades
sudo dpkg-reconfigure -plow unattended-upgrades
sudo nano /etc/apt/apt.conf.d/50unattended-upgrades

I made the following changes:

Unattended-Upgrade::Remove-Unused-Kernel-Packages "true";
Unattended-Upgrade::Automatic-Reboot "true";
Unattended-Upgrade::Automatic-Reboot-Time "02:00";
sudo nano /etc/apt/apt.conf.d/20auto-upgrades

I made the following changes:

APT::Periodic::Download-Upgradeable-Packages "1";

Test the changes by running sudo unattended-upgrades --dry-run and if needed change your timezone using sudo timedatectl set-timezone followed by your location.

Install BookStack

Configure Apache

Install Caddy

Install SSL Certificates

Configure BookStack

Configure DNS

Configuring

Troubleshooting and Maintenance