Repository files navigation

Users of version 24.2.3 should switch to 24.2.3-1 (or higher); a maintainererroneously 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 forenvironment variable management. Instead, the preferred approach is to managethem directly with the container runtime (e.g. Docker's-e). This is tosimplify troubleshooting if and when errors occur. The most important change isthat${APP_KEY} is no longer provided for you, instead it is up to theoperator to ensure this value is present. Versions prior to this supplied${APP_KEY} (with a default ofSomeRandomStringWith32Characters. A fullreference of available environment variables is available in theBookstackrepository

The version 23.6.0 is broken due to a bad.env configuration created by theentrypoint 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 rootprivileges to be dropped

In 0.12.2 we removedDB_PORT . You can now specify the port viaDB_HOST likeDB_HOST=mysql:3306

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

docker compose up

and after that open your Browser and go tohttp://localhost:8080 . You can login with usernameadmin@admin.com and passwordpassword.

If you have any issues feel free to create anissue on GitHub.

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

1. Create a shared network:

   docker network create bookstack_nw

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

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_25.5.2" \ solidnerd/bookstack:25.5.2

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

   APP_URL=http://example.com orAPP_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

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 runcommand:

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

After these steps you can visithttp://localhost:8080.You can login with usernameadmin@admin.com and passwordpassword.

This is a fork ofKilhog/docker-bookstack. Kilhogdid the intial work, but I want to go in a different direction.