---
title: "Deploy BookLore"
description: "Self-hosted multi-user ebook, PDF and comic library, with MariaDB"
category: "Storage"
url: https://railway.com/deploy/booklore-2
---

# Deploy BookLore

Self-hosted multi-user ebook, PDF and comic library, with MariaDB

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

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

- **Creator:** Agaz Self-Host
- **Category:** Storage

## Template content

### BookLore https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/booklore.png

- **Source:** https://github.com/aalfath/booklore-railway-template
- **Health check:** /api/v1/healthcheck
- **Public domain:** Yes

### MariaDB https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/mariadb.png

- **Source:** https://github.com/aalfath/booklore-railway-template

## Documentation

# Deploy and Host BookLore on Railway

BookLore is a self-hosted, multi-user digital library for your books. It organises EPUB, PDF, comic and audiobook files into libraries and smart shelves, fetches covers and metadata automatically, and has a built-in browser reader, Kobo and KOReader sync, OPDS for reading apps, and BookDrop imports. It is open source (AGPL-3.0).

## About Hosting BookLore

BookLore is a Java (Spring Boot) web app that needs a MariaDB database and a disk for its settings, covers and book files. This template deploys two services built from one GitHub repo: BookLore v2.4.0 and MariaDB 11.4 LTS, both pinned by version and digest and each on its own volume. They talk over Railway's private network, the database password is generated at deploy, and BookLore waits for the database on its first boot. Nothing has to be filled in. After the deploy, open the public URL and create the admin account in the setup wizard straight away, then add a library that uses the `/data/books` folder.

## Common Use Cases

* Keep a private ebook, PDF and comic collection in one place and read it in any browser
* Share a family or book-club library, with separate shelves and reading progress for each user
* Sync books and reading progress to a Kobo, KOReader or any OPDS reading app

## Dependencies for BookLore Hosting

* MariaDB (included, 11.4 LTS on a volume)
* A Railway volume for BookLore's settings, covers and book files (included)

### Deployment Dependencies

* BookLore source and releases: https://github.com/booklore-app/booklore/releases
* BookLore documentation: https://booklore.org/docs/getting-started
* Template repo (Dockerfiles, start script, changelog): https://github.com/aalfath/booklore-railway-template

### Implementation Details

Services:

* **BookLore**: the web app and API, public on port 6060, health check `/api/v1/healthcheck`. Its volume at `/data` holds `app` (settings, covers, cache), `books` (your library folder) and `bookdrop` (files put here are queued for import).
* **MariaDB**: BookLore's database (users, libraries, shelves, metadata, reading progress). Private network only, volume at `/var/lib/mysql`.

After deploy:

1. Open the BookLore URL and create the admin account. Only the first visitor can do this, so do it right away.
2. Create a library with the folder `/data/books`, then upload books in the UI or through BookDrop.
3. Optional: set up OIDC login, email (send to Kindle) and metadata sources in BookLore's settings. Add `TZ` or `ALLOWED_ORIGINS` to the BookLore service if you need them.

Updates: both services build from the template repo. When we bump the pinned versions, Railway shows you an "update available" notice and you choose when to apply it. Read the repo's `CHANGELOG.md` first. Note: upstream has announced that BookLore is in maintenance mode (bug fixes and security updates), with BookOrbit as its successor.

## Why Deploy BookLore 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 BookLore 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

- [RustFS | (Just Updated) S3 Object Store, Public URL and Keys Set](https://railway.com/deploy/rustfs-or-just-updated-s3-object-store-p) — S3-compatible object store, keys and public URL preset, volume kept
- [TimescaleDB](https://railway.com/deploy/timescaledb-railway-template) — A PostgreSQL-based time-series database for analytics on Railway.
- [Neo4j 2026.10 Community](https://railway.com/deploy/neo4j-202610-community) — Neo4j graph database with APOC, Browser, Bolt TCP proxy and a volume

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