---
title: "Deploy BookStack"
description: "Open-source wiki: BookStack 26.09 with MySQL, no default admin password"
category: "CMS"
url: https://railway.com/deploy/bookstack-2
---

# Deploy BookStack

Open-source wiki: BookStack 26.09 with MySQL, no default admin password

**[Deploy BookStack on Railway](https://railway.com/template/bookstack-2)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/bookstack-2/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** CMS
- **Total deploys:** 2

## Template content

### BookStack https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/bookstack.png

- **Source:** https://github.com/aalfath/bookstack-wiki-railway-template
- **Health check:** /status
- **Public domain:** Yes

### MySQL https://devicons.railway.app/i/mysql.svg

- **Image:** mysql:8
- **Start command:** `docker-entrypoint.sh mysqld --innodb-use-native-aio=0 --disable-log-bin --performance_schema=0 --innodb-buffer-pool-size=1G`

## Documentation

# Deploy and Host BookStack on Railway

BookStack is a free, open-source wiki and documentation platform. It organises content into shelves, books, chapters and pages, with a WYSIWYG and Markdown editor, full-text search, page revisions, roles and permissions, and LDAP, SAML or OIDC login. It's built on PHP (Laravel) and stores its content in MySQL or MariaDB.

## About Hosting BookStack

Hosting BookStack means running its PHP web app, a MySQL or MariaDB database, and persistent storage for uploaded images and attachments. The app needs a fixed encryption key, its public URL, database credentials, and database migrations on every upgrade. Out of the box it creates an admin account with a well-known default password, which has to be changed before the site is exposed. This template handles all of that: it builds BookStack v26.09.3 from a pinned image, connects it to Railway's MySQL over the private network, stores files on a volume, runs migrations on start, and replaces the default admin with your email and a generated password.

## Common Use Cases

* Internal company wiki and knowledge base
* Product, API and technical documentation
* Team runbooks, how-to guides and onboarding material

## Dependencies for BookStack Hosting

* MySQL 8 (Railway's MySQL service, included)
* A volume for uploads, images and attachments (`/config`, included)

### Deployment Dependencies

* BookStack: https://www.bookstackapp.com/
* BookStack installation docs: https://www.bookstackapp.com/docs/admin/installation/
* BookStack v26.09.3 release: https://github.com/BookStackApp/BookStack/releases/tag/v26.09.3
* LinuxServer.io BookStack image: https://github.com/linuxserver/docker-bookstack
* Template source: https://github.com/aalfath/bookstack-wiki-railway-template

### Implementation Details

You enter one value at deploy time: `BOOKSTACK_ADMIN_EMAIL`. On first boot, BookStack's default `admin@admin.com` account is changed to that email with a generated password. Find it as `BOOKSTACK_ADMIN_PASSWORD` in the BookStack service's Variables tab, log in, and change it in BookStack. If the admin can't be set, the app stops before it serves any page, so it's never reachable with the default password.

The BookStack service builds from the GitHub repo above, so Railway offers you updates (new BookStack versions, listed in the repo's CHANGELOG) when they land. Email (`MAIL_*`), LDAP, SAML and OIDC are optional: add their variables to the BookStack service as described in BookStack's docs. If you use a custom domain, set `APP_URL` to it.

## Why Deploy BookStack on Railway?


Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying BookStack on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.



## Similar templates

- [Libredesk - Complete Setup](https://railway.com/deploy/libredesk-complete-setup) — Complete self-hosted omnichannel customer support desk.
- [Paperless-ngx](https://railway.com/deploy/paperless-ngx-3) — Paperless-ngx — document management with OCR and full-text search
- [Instatic CMS - Postgres](https://railway.com/deploy/instatic-cms-postgres) — Design, build and manage powerful static sites from state-of-the-art CMS

Open this page in a browser: https://railway.com/deploy/bookstack-2
