Deploy and Host Calibre-Web on Railway

Deploy Calibre-Web on Railway to turn any Calibre library into a full-featured ebook server accessible from any browser or e-reader app. Self-host Calibre-Web with zero infrastructure hassle — this template pre-configures the LinuxServer.io container image with persistent storage, automatic metadata database initialization, and the correct port bindings for Railway's networking layer.

Calibre-Web provides a clean web interface for browsing, reading, and downloading books from a personal Calibre library. It supports OPDS feeds, Kobo sync, send-to-Kindle, multi-user access, and optional ebook format conversion.

Getting Started with Calibre-Web on Railway

After deployment completes, navigate to your Railway-generated public URL and append /login. Sign in with the default credentials: admin / admin123. Your first step is configuring the Calibre database location — go to Admin > Edit Calibre Database Configuration (/admin/dbconfig) and set "Location of Calibre Database" to /config/books. The template bootstraps a sample metadata.db in this directory automatically.

Once configured, you can upload books via the web UI, browse your library, and read directly in the browser. Change the default admin password immediately under Admin > Edit User. To enable multi-user access, configure user registration or create accounts manually from the admin panel.

About Hosting Calibre-Web

Calibre-Web is an open-source web application that provides a browser-based frontend for Calibre libraries. Unlike Calibre desktop, it runs as a server — making your entire book collection accessible from phones, tablets, e-readers, and any device with a browser.

• Browse, search, and filter books by author, tag, series, language, or custom columns
• Built-in EPUB and PDF reader — read books directly in the browser
• OPDS catalog feed for compatible reader apps (KOReader, Moon+ Reader, Aldiko)
• Native Kobo device synchronization with KEPUB conversion
• Send books to Kindle or other devices via email
• Multi-user support with granular permissions and optional LDAP/OAuth authentication
• Edit metadata, covers, and custom columns without Calibre desktop
• Optional ebook format conversion via Calibre binaries (DOCKER_MODS)

Why Deploy Calibre-Web on Railway

• One-click deploy with persistent volume storage for your library
• No server provisioning — Railway handles containers, networking, and TLS
• Automatic HTTPS on your public domain
• Scale resources up or down as your library grows
• Built-in health monitoring and deploy rollbacks

Common Use Cases for Calibre-Web

• Personal ebook library server — Access thousands of books from any device, anywhere
• Family or team reading hub — Create individual accounts with different permissions and reading lists
• Kobo and Kindle integration — Sync books directly to e-readers without manual file transfers
• OPDS catalog for mobile readers — Feed books to KOReader, Moon+ Reader, or Kybook via standard OPDS protocol

Dependencies for Calibre-Web on Railway

This template deploys a single service using the LinuxServer.io Calibre-Web image with a persistent volume for library storage.

• calibre-web-app — lscr.io/linuxserver/calibre-web:latest (LinuxServer.io, multi-arch: x86-64 and arm64)
• Volume — Mounted at /config for persistent library and configuration storage

Environment Variables Reference for Calibre-Web

Deployment Dependencies

• Runtime: Python 3.x (bundled in LinuxServer image)
• Docker image: linuxserver/calibre-web on Docker Hub
• Source code: janeczku/calibre-web on GitHub (17k+ stars, GPL-3.0)
• Docs: Calibre-Web Wiki

Hardware Requirements for Self-Hosting Calibre-Web

Calibre-Web is lightweight — the application itself uses minimal resources. Storage requirements depend entirely on the size of your ebook library. Enabling DOCKER_MODS for format conversion adds ~500 MB to the initial download and increases RAM usage during conversion operations.

Self-Hosting Calibre-Web with Docker

Pull and run the LinuxServer.io image directly:

docker run -d \
  --name=calibre-web \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 8083:8083 \
  -v /path/to/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/calibre-web:latest

Or use Docker Compose with ebook conversion support:

version: "3"
services:
  calibre-web:
    image: lscr.io/linuxserver/calibre-web:latest
    container_name: calibre-web
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - DOCKER_MODS=linuxserver/mods:universal-calibre
    volumes:
      - ./config:/config
    ports:
      - 8083:8083
    restart: unless-stopped

Place your existing Calibre library (including metadata.db) in the config directory before starting. If you don't have an existing library, Calibre-Web can create a new one.

Calibre-Web vs Kavita vs Komga

Calibre-Web is the best choice for prose ebook collections, especially if you already use Calibre desktop. Kavita excels at mixed media libraries with manga and comics. Komga is purpose-built for comics and manga with deep Tachiyomi/Mihon integration.

Is Calibre-Web Free to Self-Host?

Calibre-Web is completely free and open-source under the GPL-3.0 license. There are no paid tiers, premium features, or enterprise editions. When self-hosting on Railway, your only cost is Railway infrastructure — typically $5-10/month for a small library with minimal traffic.

FAQ

What is Calibre-Web and why should I self-host it? Calibre-Web is a web-based ebook management application that provides a browser frontend for Calibre libraries. Self-hosting gives you full control over your book collection, private access from any device, and no dependency on third-party cloud services.

What does this Railway template deploy for Calibre-Web? This template deploys a single Calibre-Web container using the LinuxServer.io image with a persistent volume mounted at /config. It pre-configures the correct port, user permissions, and timezone. A sample metadata database is bootstrapped automatically so the service is ready to use immediately after deploy.

Why does Calibre-Web need a volume on Railway? The volume at /config stores your Calibre library (books and metadata.db), user database, and application configuration. Without persistent storage, all data would be lost on every redeploy. The volume ensures your library survives container restarts and redeployments.

How do I enable ebook format conversion in self-hosted Calibre-Web? Add the environment variable DOCKER_MODS=linuxserver/mods:universal-calibre to your deployment. This installs Calibre binaries (calibredb, ebook-convert, kepubify) into the container, enabling conversion between EPUB, MOBI, PDF, AZW3, and other formats. Note: this adds ~500 MB to the initial container download.

Can I use Calibre-Web with Kobo or Kindle e-readers? Yes. Calibre-Web has native Kobo sync support — configure your Kobo to point at your Calibre-Web instance and books sync automatically. For Kindle, configure SMTP settings in the admin panel and use the "Send to Kindle" button to email books directly to your device.

How do I migrate an existing Calibre library to Railway-hosted Calibre-Web? Upload your existing metadata.db and book files to the /config/books directory on the Railway volume. You can use Railway's volume management or SCP/SFTP to transfer files. After uploading, set the library path in Calibre-Web's admin panel to /config/books.