Just Typing

Life Journal

0%

Bookstack Installation on Windows

Posted on Edited on

Introduction

This record the process of installing Bookstack on Windows through WLS2. This is just for personal test usage. Still not sure if this will cause the problem opening the port to the internet.

Bookstack is one possible solution for the team or the knowledge database system. Because of the sensitive info, it is hard to build the database on the free cloud server, and it is hard to extend the user in the future. Therefore, a local sever should be essential to document the process/effort that I did. At least before we send the info to the public, it is important to review the external info sharing.

The easiest way to install Bookstack on Windows using Docker

  • Why use docker for the installation?
    Bookstack is based on Linux OS, and thanks to Win11, we can install the Linux core instead of the whole OS system through a virtual machine! That is quite an improvement in recent years. Although Docker is for developers to test the software/program stability, I think it is still okay to run the personal database on Docker. We can definitely move the data to the server in the future if the database/process becomes mature.

  • Why use Windows but not just use Linux-based OS?

I tried to use Linux OS as my main working station. However, it’s hard to integrate or use some convenient software like Microsoft office for sharing the info with others. So in the past, I installed a virtual machine in the Linux OS, but it is pretty complex to operate. Therefore, using Windows and just using WSL2/Docker should be a better solution.

Install bookstack

  1. Install Ubuntu based on WSL2 (Ubuntu official tutorial)
  2. Install docker (Docker official tutorial)
  3. No need to install docker-compose (It seems like this program is already installed through the package in Win11 version)
  4. Using docker-compose to simplify the installation process
  5. Install Bookstack with Linuxserver version through docker-compose
    docker-compose.yml (github gist)
    Type docker-compose up -d in PowerShell to run the script (Note: please don’t use the administrator account to do so for the security reason.)
  6. You should be able to login through any website browser with the url
  7. The default username is admin@admin.com with the password of password
    , access the container athttp://localhost:6875/.

MISC

  • Backup & Restore

  • Latex (Mathjax) support

    Just add the following script in the HTML render for the Latex usage

    1
    2
    <script src="[https://polyfill.io/v3/polyfill.min.js?features=es6](https://polyfill.io/v3/polyfill.min.js?features=es6)"></script>
    <script id="MathJax-script" async src="[https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js](https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js)"></script>

Reference