{"id":13574033,"url":"https://github.com/solidnerd/docker-bookstack","last_synced_at":"2026-03-15T21:55:19.621Z","repository":{"id":39525388,"uuid":"65643342","full_name":"solidnerd/docker-bookstack","owner":"solidnerd","description":"BookStack in a container","archived":false,"fork":false,"pushed_at":"2025-03-25T14:36:24.000Z","size":555,"stargazers_count":479,"open_issues_count":2,"forks_count":199,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-03-29T08:44:49.752Z","etag":null,"topics":["bookstack","bookstack-container","docker-bookstack"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/solidnerd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-08-14T00:52:47.000Z","updated_at":"2025-03-25T14:36:03.000Z","dependencies_parsed_at":"2024-01-25T13:53:44.970Z","dependency_job_id":"eb3b0c4a-561b-498e-8323-c031e1eeea69","html_url":"https://github.com/solidnerd/docker-bookstack","commit_stats":null,"previous_names":[],"tags_count":135,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solidnerd%2Fdocker-bookstack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solidnerd%2Fdocker-bookstack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solidnerd%2Fdocker-bookstack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solidnerd%2Fdocker-bookstack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/solidnerd","download_url":"https://codeload.github.com/solidnerd/docker-bookstack/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247194055,"owners_count":20899424,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bookstack","bookstack-container","docker-bookstack"],"created_at":"2024-08-01T15:00:45.384Z","updated_at":"2026-03-15T21:55:19.613Z","avatar_url":"https://github.com/solidnerd.png","language":"Shell","readme":"# Docker Image For [BookStack](https://github.com/ssddanbrown/BookStack)\n\n![Build Status](https://img.shields.io/github/actions/workflow/status/solidnerd/docker-bookstack/master.yml)\n![Latest release](https://img.shields.io/github/v/tag/solidnerd/docker-bookstack?label=Latest%20release)\n![GitHub contributors](https://img.shields.io/github/contributors/solidnerd/docker-bookstack)\n\n## Changes\n\nUsers of version 24.2.3 should switch to 24.2.3-1 (or higher); a maintainer\nerroneously set image tag 24.2.3 to use 23.2.3 as the release.\n\nVersions higher than 23.6.2 no longer use an in-container `.env` file for\nenvironment variable management. Instead, the preferred approach is to manage\nthem directly with the container runtime (e.g. Docker's `-e`). This is to\nsimplify troubleshooting if and when errors occur. The most important change is\nthat `${APP_KEY}` is no longer provided for you, instead it is up to the\noperator to ensure this value is present. Versions prior to this supplied\n`${APP_KEY}` (with a default of `SomeRandomStringWith32Characters`. A full\nreference of available environment variables is available in the [Bookstack\nrepository](https://github.com/BookStackApp/BookStack/blob/development/.env.example.complete)\n\nThe version 23.6.0 is broken due to a bad `.env` configuration created by the\nentrypoint script. This is fixed in version 23.6.0-1.\n\nIn 0.28.0 we changed the container http port from 80 to 8080 to allow root\nprivileges to be dropped\n\nIn 0.12.2 we removed `DB_PORT` . You can now specify the port via `DB_HOST` like\n`DB_HOST=mysql:3306`\n\n## Quickstart\n\nWith Docker Compose is a Quickstart very easy. Run the following command:\n\n```bash\ndocker compose up\n```\n\nand after that open your Browser and go to\n[http://localhost:8080](http://localhost:8080) . You can login with username\n`admin@admin.com` and password `password`.\n\n## Issues\n\nIf you have any issues feel free to create an [issue on GitHub](https://github.com/solidnerd/docker-bookstack/issues).\n\n## How to use the Image without Docker compose\n\nNote that if you want to use LDAP, `$` has to be escape like `\\$`, i.e. `-e \"LDAP_USER_FILTER\"=\"(\u0026(uid=\\${user}))\"`\n\n### Docker 1.9+\n\n1. Create a shared network:\n\n   ```bash\n   docker network create bookstack_nw\n   ```\n\n2. Run MySQL container :\n\n   ```bash\n   docker run -d --net bookstack_nw  \\\n   -e MYSQL_ROOT_PASSWORD=secret \\\n   -e MYSQL_DATABASE=bookstack \\\n   -e MYSQL_USER=bookstack \\\n   -e MYSQL_PASSWORD=secret \\\n    --name=\"bookstack_db\" \\\n    mysql:9.2.0\n   ```\n\n3. Run BookStack Container\n\n   ```bash\n   docker run -d --net bookstack_nw \\\n   -e DB_HOST=bookstack_db:3306 \\\n   -e DB_DATABASE=bookstack \\\n   -e DB_USERNAME=bookstack \\\n   -e DB_PASSWORD=secret \\\n   -e APP_URL=http://localhost:8080 \\\n   -e APP_KEY=SomeRandomStringWith32Characters \\\n   -p 8080:8080 \\\n   --name=\"bookstack_26.3.0\" \\\n    solidnerd/bookstack:26.3.0\n   ```\n\n    The APP_URL parameter should be the base URL for your BookStack instance without\n    a trailing slash, but including any port numbers. For example:\n\n    `APP_URL=http://example.com` or `APP_URL=http://localhost:8080`.\n\n    The following environment variables are required for Bookstack to start:\n    - `APP_KEY`\n    - `APP_URL`\n    - `DB_HOST` (in the form `${hostname_or_ip_address}:${port}`)\n    - `DB_DATABASE`\n    - `DB_USERNAME`\n    - `DB_PASSWORD`\n\n### Volumes\n\nTo access your important bookstack folders on your host system change `\u003cHOST\u003e`\nin the following line to your host directory and add it then to your run\ncommand:\n\n```bash\n-v \u003cHOST\u003e:/var/www/bookstack/public/uploads \\\n-v \u003cHOST\u003e:/var/www/bookstack/storage/uploads\n```\n\nAfter these steps you can visit [http://localhost:8080](http://localhost:8080).\nYou can login with username `admin@admin.com` and password `password`.\n\n## Inspiration\n\nThis is a fork of\n[Kilhog/docker-bookstack](https://github.com/Kilhog/docker-bookstack). Kilhog\ndid the intial work, but I want to go in a different direction.\n","funding_links":[],"categories":["Shell","others"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolidnerd%2Fdocker-bookstack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsolidnerd%2Fdocker-bookstack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolidnerd%2Fdocker-bookstack/lists"}