solidnerd/bookstack repository overview

⁠Docker Image For BookStack⁠

⁠Changes

Users of version 24.2.3 should switch to 24.2.3-1 (or higher); a maintainer erroneously set image tag 24.2.3 to use 23.2.3 as the release.

Versions higher than 23.6.2 no longer use an in-container .env file for environment variable management. Instead, the preferred approach is to manage them directly with the container runtime (e.g. Docker's -e). This is to simplify troubleshooting if and when errors occur. The most important change is that ${APP_KEY} is no longer provided for you, instead it is up to the operator to ensure this value is present. Versions prior to this supplied ${APP_KEY} (with a default of SomeRandomStringWith32Characters. A full reference of available environment variables is available in the Bookstack repository⁠

The version 23.6.0 is broken due to a bad .env configuration created by the entrypoint script. This is fixed in version 23.6.0-1.

In 0.28.0 we changed the container http port from 80 to 8080 to allow root privileges to be dropped

In 0.12.2 we removed DB_PORT . You can now specify the port via DB_HOST like DB_HOST=mysql:3306

⁠Quickstart

With Docker Compose is a Quickstart very easy. Run the following command:

docker compose up

and after that open your Browser and go to http://localhost:8080⁠ . You can login with username [email protected] and password password.

⁠Issues

If you have any issues feel free to create an issue on GitHub⁠.

⁠How to use the Image without Docker compose

Note that if you want to use LDAP, $ has to be escape like \$, i.e. -e "LDAP_USER_FILTER"="(&(uid=\${user}))"

⁠Docker 1.9+

1. Create a shared network:

   docker network create bookstack_nw
   

   Copy

2. Run MySQL container :

   docker run -d --net bookstack_nw  \
   -e MYSQL_ROOT_PASSWORD=secret \
   -e MYSQL_DATABASE=bookstack \
   -e MYSQL_USER=bookstack \
   -e MYSQL_PASSWORD=secret \
    --name="bookstack_db" \
    mysql:9.2.0
   

   Copy

3. Run BookStack Container

   docker run -d --net bookstack_nw \
   -e DB_HOST=bookstack_db:3306 \
   -e DB_DATABASE=bookstack \
   -e DB_USERNAME=bookstack \
   -e DB_PASSWORD=secret \
   -e APP_URL=http://localhost:8080 \
   -e APP_KEY=SomeRandomStringWith32Characters \
   -p 8080:8080 \
   --name="bookstack_26.3.3" \
    solidnerd/bookstack:26.3.3
   

   Copy

   The APP_URL parameter should be the base URL for your BookStack instance without a trailing slash, but including any port numbers. For example:

   APP_URL=http://example.com or APP_URL=http://localhost:8080.

   The following environment variables are required for Bookstack to start:

   • APP_KEY
   • APP_URL
   • DB_HOST (in the form ${hostname_or_ip_address}:${port})
   • DB_DATABASE
   • DB_USERNAME
   • DB_PASSWORD

⁠Volumes

To access your important bookstack folders on your host system change <HOST> in the following line to your host directory and add it then to your run command:

-v <HOST>:/var/www/bookstack/public/uploads \
-v <HOST>:/var/www/bookstack/storage/uploads

After these steps you can visit http://localhost:8080⁠. You can login with username [email protected] and password password.

⁠Inspiration

This is a fork of Kilhog/docker-bookstack⁠. Kilhog did the intial work, but I want to go in a different direction.