codemicro / docker-bookstack

Bookstack in a Docker container

Docker Image For BookStack

How to use the Image without Docker compose

(For Docker 1.9+)

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

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://example.com \
-p 8080:8080 \
--name="bookstack_23.02" \
 ghcr.io/codemicro/bookstack:23.02

The APP_URL parameter should be the base URL for your BookStack instance without a trailing slash. For example: APP_URL=http://example.com

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 '[e-mail]' and password 'password'.

Inspiration

This is a fork of solidnerd/docker-bookstack, which is in turn a fork of Kilhog/docker-bookstack. Kilhog did the intial work, solidnerd wanted to go in a different direction and I wanted an up-to-date version of the image.