How to Install BookStack on Your Synology NAS

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

Please Support My Work by Making a Donation.

  • STEP 2

Install Portainer using my step by step guide. If you already have Portainer installed on your Synology NAS, skip this STEP.

  • STEP 3

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.

1 Synology NAS Bookstack Docker container set up

  • STEP 4

Inside the bookstack folder create a new folder and name it config. Follow the instructions in the image below.

2 Synology NAS Bookstack Docker container set up

  • STEP 5

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
      - 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. (Follow my step by step guide on how to do this.)
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.

3 Synology NAS Bookstack Docker container set up

  • STEP 6

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.

4 Synology NAS Bookstack Docker container set up

  • STEP 7

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

5 Synology NAS Bookstack Docker container set up

  • STEP 8

Go back to STEP 1. Remember that this is a free guide. Please support the content creator you love. 🙂

  • STEP 9

Now open your browser and type in http://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.

6 Synology NAS Bookstack Docker container set up

  • STEP 10

Edit your profile and change the default email and password.

7 Synology NAS Bookstack Docker container set up

You can also change your avatar.

8 Synology NAS Bookstack Docker container set up

  • STEP 11

You can start writing your book with Dark Mode activated.

9 Synology NAS Bookstack Docker container set up

Simple and intuitive text editor.

10 Synology NAS Bookstack Docker container set up

You can easily navigate the pages. Enjoy your BookStack!

11 Synology NAS Bookstack Docker container set up

Note: Find out how to update Bookstack container with the latest image.
Note: Can I run Docker on my Synology NAS? See the supported models.

This post was updated on Monday / September 21st, 2020 at 3:38 AM