Docker Image For BookStack
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
With Docker Compose is a Quickstart very easy. Run the following command:
docker-compose upand after that open your Browser and go to
http://localhost:8080 . You can login with username
[email protected] and password password.
If you have any issues feel free to create an issue on GitHub.
Note that if you want to use LDAP, $ has to be escape like \$, i.e. -e "LDAP_USER_FILTER"="(&(uid=\${user}))"
Networking changed in Docker v1.9, so you need to do one of the following steps.
-
MySQL Container:
docker run -d \ -p 3306:3306 \ -e MYSQL_ROOT_PASSWORD=secret \ -e MYSQL_DATABASE=bookstack \ -e MYSQL_USER=bookstack \ -e MYSQL_PASSWORD=secret \ --name bookstack_db \ mysql:5.7.21
-
BookStack Container:
docker run -d --link bookstack_db_:mysql \ -p 8080:8080 \ --name bookstack_24.2.3 \ solidnerd/bookstack:24.2.3-1
-
Create a shared network:
docker network create bookstack_nw
-
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.21 -
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_24.2.3" \ solidnerd/bookstack:24.2.3-1The APP_URL parameter should be the base URL for your BookStack instance without a trailing slash. For example:
APP_URL=http://example.comThe following environment variables are required for Bookstack to start:
APP_KEYAPP_URLDB_HOST(in the form${hostname_or_ip_address}:${port})DB_DATABASEDB_USERNAMEDB_PASSWORD
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/uploadsIn 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.
This is a fork of Kilhog/docker-bookstack. Kilhog did the intial work, but I want to go in a different direction.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
![renovate[bot] avatar](https://avatars.githubusercontent.com/in/2740?v=4 "renovate[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent