--- title: "Deploy Kavita" description: "Self-hosted Kavita reader for manga, comics and ebooks, admin set at deploy" category: "Other" url: https://railway.com/deploy/kavita-2 --- # Deploy Kavita Self-hosted Kavita reader for manga, comics and ebooks, admin set at deploy **[Deploy Kavita on Railway](https://railway.com/template/kavita-2)** Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/kavita-2/manifest.json - **Creator:** Agaz Self-Host - **Category:** Other - **Total deploys:** 1 ## Template content ### Kavita https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/kavita.svg - **Image:** jvmilazz0/kavita:0.9.1@sha256:31181a32f0dda73cae68721867028a7253d57881b58bea5754cd9e578e75421a - **Start command:** `/bin/bash -c 'echo H4sIAAAAAAACA5VWbXPaOBD+7l+xVWiBK8aQmevdmaEzNNCWSXgZQpq7AS4jbIFdjOVKcmhK+e+3kiGQkOTukg9xVivty/PsI528cqZh7EypDKwTOKe3oaLAYxjQMFrROxe/GdzyKF0yoAocnypaAuovwxgkYz7zYcpmXDBQAYOECwU8YbEs42nN3rDbGt4MrrrddvfTTbt7c9brDhvtbmsAoYQ0lkyB5LuoAY95KiT08RCnnTR8XzApmYSZ4EugSYLuKoznsvxV8hjPL2AOpMm9BROw5D4jECqgOm0JUSgVpqFLGbnuxP21UqkUy5aOaLOUQxImbIY1WlazMWzUTV1Wv05y635vMHRt7b8h1pW2nDe+tIeNm0azgyVcXbYG3Uan5dqmCejTvz5y6jcuL697g6Zr43qrc7Te6jTaF2bx7OOnurMwDXA8Hs/CuXNUaacxOMcjdKI7n7LI8MmSsDMkiGUtF34owE7ggTvZ/RuFU0HFndOh8ZweWc/4MvTkkfkD5wtJ9uxYMJZIbLUE3TRkDiuBx2+ZkCWI+FwCjX3YVQCI0cP6XGRJGCuDlTKsyehVtsIZjOAV2BePdsCkpv1iC0AswRazR+toj2Kw5eOiH3nNQmsE9gy9sOkEJvDzJ3gJOGqZPNf6ra+leePN5oUirOEEclWobwmGk2BYCgVC0EijCAtWTMyox2QRE5M4IHYIdguIdMZEc3tMXPhlVLH/mLw9sOT6Tg20ywHzjeeYjP4ekwn+PV4ck1wV7WSX58a6b6KuUxOHHHTPrCEXT/rXGwJ2pODdwSoA8wIOZLTl1gSe5DQsU6lw6DXEUHj3FryACuph0bJ4qAWzUKCfVFSoMoH3b06zEN8R9yp+IhrHAT/u97jgCUY1FOa0Lfcy4cnnrvKwCsLo3n4w7hH3aBRwPIfH0V2ZGBA0elA9/a1cwV8dnsW3YKcvSpTDYiXuDFnLMoA3uOu8327Wc6/wiy/qRB+N5cKNJnmuINk3qEL190qxBj431WLDvVREiIa8BBIolbiOc5+Gi5jTJHQCRiMVYI8cn906cYokOn3/ppoBoyPh5xSbsahlXQNYhOhjVxBLnRFB9/1WZLVxNo4ywmE1/fZRyHcUsH/gTr64p8Yx8FlX/dCHmD8AsZbFfiawEimrbTHeJvuh1/yrnitoIb0iYLSyf03AiGKrQ4CuFpCfpbGnQgTva0EW13OZTgvOeOyUyBh/SEkWa5mNZCZiTIKpVOAttDGVfmh9anfXiUC0kPrrMUklEzFdMpyTMXmN41Iak4RKueLCP7SxJVZ9b9iQEibR6n5pD3rdEbkik+IDA+b+yIJFTIqbvB72s16zhbVmkCPiNs/URbC55qco8xSvnxXkX681F248vLQ2ebA/Q/6Mo2zEyh7eJczVl10UelS3xNE6lIexKdL+E/q9yyHYtpZeREF3lzzPLOp5PI3VfQJEg2TA1tfhXhF04lq/yGmlQl6UhMZ+AM18Mr8M/W1X3WxSnxSNWypCOo2YmUcWYdy5QGba34B0ub61I77CG+yJfh1Q7KW84q020AjT8u80CaWSNc3fwIgI3ya8zUCyJ885OxSd7ET9TEAVL3weDvtgWlVEuS7g1KK0e4AvheOsi3vF+/d5WVGclxc8nhBOfQ/OjsPiiuKpF+y033oY/j+EwtO3lx2gvj3uzqUWAt2d/UPRPPly/TJcZM8FVMTIx7sAW/TgFbE2b45S9sYomTcFPn/Yd+b9fy22/gHEuYdYtgoAAA== | base64 -d | gunzip > /tmp/kavita-start.sh && exec bash /tmp/kavita-start.sh'` - **Health check:** /api/health - **Public domain:** Yes ## Documentation # Deploy and Host Kavita on Railway Kavita is an open-source, self-hosted reading server for manga, comics, webtoons, ebooks and PDFs. It scans your folders into a library with series, covers and metadata, and lets you read in the browser or in OPDS apps. Progress, collections, reading lists and multiple users with per-library access are built in. ## About Hosting Kavita Kavita is one .NET service that keeps its settings and SQLite database in a config folder and reads books from library folders on disk. This template runs the official `jvmilazz0/kavita` image, pinned by version and digest, with one Railway volume at `/data`: `/data/config` holds the database, covers and logs, and `/data/library` holds your books. Upstream, the first person to open a new server registers as admin. This template creates that admin at first start while Kavita still listens on localhost only, so the public URL can't be claimed. Books go onto the volume with `railway ssh`. ## Common Use Cases * Read your manga, comics and webtoons from any browser, with progress synced across devices * Host an ebook and PDF library for yourself, family or friends, each with their own account and library access * Serve your collection to OPDS reader apps (KOReader, Panels, Chunky and others) ## Dependencies for Kavita Hosting * The official Kavita Docker image (`jvmilazz0/kavita`, v0.9.1.4) * A Railway volume mounted at `/data` for the database, settings and library ### Deployment Dependencies * Kavita: https://github.com/Kareadita/Kavita * Release notes (v0.9.1.4): https://github.com/Kareadita/Kavita/releases/tag/v0.9.1.4 * Installation docs: https://wiki.kavitareader.com/installation/docker/ * Docker image: https://hub.docker.com/r/jvmilazz0/kavita ### Implementation Details **First login.** Open the service's public URL and sign in as `KAVITA_ADMIN_USERNAME` (default `admin`). The password is the generated `KAVITA_ADMIN_PASSWORD`: open the Kavita service, then **Variables**. You can change it in your account settings after the first login; the variable is only read on the very first start. **Adding books.** Kavita has no book upload in its web UI, so put files on the volume with the Railway CLI. One folder per series works best: ```bash railway link # pick this project and the Kavita service railway ssh -- mkdir -p "/data/library/Books/My Book" cat "My Book.epub" | railway ssh -- dd "of=/data/library/Books/My Book/My Book.epub" status=none # or download straight onto the volume railway ssh -- curl -fL --create-dirs -o "/data/library/Manga/One Series/Vol 1.cbz" "https://example.com/vol1.cbz" ``` Then, in Kavita, go to **Settings → Libraries → Add Library**, pick a type, add the folder (`/data/library/Manga`, `/data/library/Comics` or `/data/library/Books` are created for you) and scan. Folder watching picks up later additions. **Notes.** Kavita listens on Railway's `PORT`; the start script writes it into Kavita's settings on every boot. Kavita's own Docker image ignores those settings, so the script starts Kavita without its container flag, and the update banner may show the non-Docker update steps. To upgrade, change the image tag to a newer Kavita release; your data stays on the volume. ## Why Deploy Kavita 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 Kavita 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 - [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀 - [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform - [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy. Open this page in a browser: https://railway.com/deploy/kavita-2