Deploy BookStack

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

Deploy BookStack

/config

MySQL

mysql:8

Just deployed

/var/lib/mysql

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

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.


Template Content

MySQL

mysql:8

More templates in this category

View Template
Libredesk - Complete Setup
Complete self-hosted omnichannel customer support desk.

codestorm
2
View Template
Paperless-ngx
Paperless-ngx — document management with OCR and full-text search

INAPP
1
View Template
Instatic CMS - Postgres
Design, build and manage powerful static sites from state-of-the-art CMS

Instatic
168