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.
Install Portainer using my step by step guide. If you already have Portainer installed on your Synology NAS, skip this STEP.
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.
Inside the bookstack folder create a new folder and name it config. Follow the instructions in the image below.
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.
version: "2" services: bookstack: image: linuxserver/bookstack container_name: bookstack environment: - PUID=1026 - PGID=100 - APP_URL=http://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. (Follow my step by step guide on how to do this.)
After you paste the code in the Web editor, change the value for APP_URL with your NAS local ip http://yourNASIP followed by :6875
Note: http://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.
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.
If everything goes right, you will see this message at the top right of your screen: “Stack successfully deployed“.
Go back to STEP 1 or you will deal with karma 🙂.
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 firstname.lastname@example.org 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.
Edit your profile and change the default email and password.
You can also change your avatar.
You can start writing your book with Dark Mode activated.
Simple and intuitive text editor.
You can easily navigate the pages. Enjoy your BookStack!
This post was updated on Saturday / January 9th, 2021 at 12:46 AM