How to Install BookStack on Your Synology NAS

From now on you can become the author of your own book! BookStack is a free and open source Wiki designed for creating beautiful documentation. Featuring a simple, but powerful WYSIWYG editor, it allows for teams to create detailed and useful documentation with ease. BookStack is a great alternative for DokuWiki for storing and organizing information and documentation. In this step by step guide I will show you how to install BookStack on your Synology NAS using Portainer.

STEP 1

Install Portainer. If you already have Portainer installed on your Synology NAS, skip this STEP.

STEP 2

Go to File Station and open the docker folder. Inside the docker folder, create one new folder and name it bookstack. Follow the instructions in the image below.
Note: Be careful enter only lowercase, not uppercase letters.

STEP 3

Inside the bookstack folder create a new folder and name it config. Follow the instructions in the image below.
Note: Be careful enter only lowercase, not uppercase letters.

STEP 4

Log into Portainer using your username and password. On the Portainer left sidebar click on Stacks. After you click on Stacks, a new screen will open. Click + Add Stack. In the Name field type in bookstack. Follow the instructions in the image below.

Note: In the Portainer Stacks Web editor Copy Paste the code below.

version: "2"
services:
  bookstack:
    image: linuxserver/bookstack
    container_name: bookstack
    environment:
      - PUID=1026
      - PGID=100 
      - APP_URL=https://yourNASIP:6875
      - DB_HOST=bookstack_db
      - DB_USER=bookstack
      - DB_PASS=yourdbpass
      - DB_DATABASE=bookstackapp
    volumes:
      - /volume1/docker/bookstack/config:/config
    ports:
      - 6875:80
    restart: always
    depends_on:
      - bookstack_db
  bookstack_db:
    image: linuxserver/mariadb
    container_name: bookstack_db
    environment:
      - PUID=1026
      - PGID=100
      - MYSQL_ROOT_PASSWORD=yourdbpass
      - TZ=Europe/Bucharest
      - MYSQL_DATABASE=bookstackapp
      - MYSQL_USER=bookstack
      - MYSQL_PASSWORD=yourdbpass
    volumes:
      - /volume1/docker/bookstack/config:/config
    restart: always

After you paste the code in the Web editor, change the value for TZ (Select your current Time Zone from this list).
After you paste the code in the Web editor, change the value numbers for PUID and PGID with your own values.
After you paste the code in the Web editor, change the value for APP_URL with your NAS local ip https://yourNASIP followed by :6875
Note: https://192.168.0.182 is my own NAS local IP you should use your NAS local IP.
Note: If you have your docker folder in a different volume, then change /volume1/docker/bookstack/config according to your settings. For example: /volume2/docker/bookstack/config or /volume3/docker/bookstack/config etc.

STEP 5

Scroll down on the page until you see a button named Deploy the stack. Click on it. Follow the instructions in the image below. The installation process can take up to a few minutes. It will depend on your Internet speed connection.

STEP 6

If everything goes right, you will see this message at the top right of your screen: “Stack successfully deployed“.

STEP 7

Now open your browser and type in https://Synology-ip-address:6875/ Follow the instructions in the image below.
In the Email Address field type in admin@admin.com and in the Password field type in password
This email and this password are the default credentials for your first access to Bookstack. Click LOG IN.

STEP 8

Edit your profile and change the default email and password.

You can also change your avatar.

STEP 9

You can start writing your book with Dark Mode activated.

Simple and intuitive text editor.

You can easily navigate the pages. Enjoy your BookStack!