digitalmotion/bookstack repository overview

⁠Docker Image For BookStack⁠

⁠Current Version: 21.05⁠

⁠Tags

• Versioned tags represent a version of BookStack itself.
• latest is tied to the latest versioned release

Additional tags are available in our GitLab Registry⁠ that map to working branches such as master. Only tagged releases are pushed to DockerHub.

⁠Changes

In 21.05 we moved to composer 2.x and did alot of code and build cleanup - moving image creation over to Kaniko. 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. Create a shared network:

docker network create bookstack_nw

1. 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:5.7

1. 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 \
-p 8080:8080 \
--name="bookstack" \
 digitalmotion/bookstack:latest

⁠Volumes

To access your .env file and 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:

--mount type=bind,source=<HOST>/.env,target=/var/www/bookstack/.env \
-v <HOST>:/var/www/bookstack/public/uploads \
-v <HOST>:/var/www/bookstack/storage/uploads

In case of a windows host machine the .env file has to be already created in the host directory otherwise a folder named .env will be created.

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 solidnerd/docker-bookstack⁠.