How to Install BookStack on Your Synology NAS

synology-nas-19122.768x432 (Demo)
Advertisements by Google

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.

1 Synology NAS Bookstack Docker container set up

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.

2 Synology NAS Bookstack Docker container set up

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.

3 Synology NAS Bookstack Docker container setup

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.

Advertisements by Google
4 Synology NAS Bookstack Docker container set up

STEP 6

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 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.

6 Synology NAS Bookstack Docker container set up

STEP 8

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 9

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

Advertisements by Google

Related Posts

Leave a comment

Privacy Preferences
When you visit our website, it may store information through your browser from specific services, usually in form of cookies. Here you can change your privacy preferences. Please note that blocking some types of cookies may impact your experience on our website and the services we offer.
%d bloggers like this: