Self-hosted · open source · installable PWA

A manga library that fills itself.

Point it at a series and Uchiyomi downloads it, watches for new chapters, and serves them to a reader built for webtoons. One compose file, on your own server, and it installs like an app.

Already run Sonarr or Radarr? It’s that, for manga.

Self-host it in two commands → View on GitHub

CBZCBRimage foldersMangaDexMadaraMangaThemesiaManganato

uchiyomi

The pitch

Indexerfinding series

Schedulerwatching for new chapters

Downloadergrabbing files

Solvergetting past Cloudflare

Media serverserving and reading

uchiyomi.

Normally that's four or five containers
and a weekend of compose files. Uchiyomi is one image.

Discover

Grab

Monitor

Serve

Read

The tour

Six screens. One scroll.

HomeA daily pick, and where you left off.
LibraryEverything you own, sorted how you like.
SeriesReal cover art, every chapter, one tap in.
ReaderTrue black, webtoon-first, chapters run on.
DiscoverOne search across every source at once.
AdminMembers, providers, and a library that checks itself.

uchiyomi / home

Home: A daily pick, and where you left off.

Library: Everything you own, sorted how you like.

Series: Real cover art, every chapter, one tap in.

Reader: True black, webtoon-first, chapters run on.

Discover: One search across every source at once.

Admin: Members, providers, and a library that checks itself.

Two doors, one search

Paste a URL. Or bring Mihon’s whole catalogue.

1,369extensions, one click

Built-in engines reach whole families of manga sites from a pasted URL, with nothing to wire up. Want more? Point Uchiyomi at an extension repository you trust and add one with a click. Both land in the same search.

Adding one switches its sources on immediately
Adult extensions hidden by default
Uchiyomi hosts nothing — you choose the repository

uchiyomi / admin

Why Uchiyomi

Most tools make you pick a side. This one does both.

A library server reads files you supply but can’t fetch new chapters. A source app fetches them but is Android-only or wrapped in a basic web UI. Uchiyomi does both, in something worth opening.

	Uchiyomi	Komga / Kavita	Tachiyomi / Mihon	Suwayomialso runs inside Uchiyomi
Self-hosted, multi-user server	✓	✓	×Android app	✓
Fetches new chapters from sources	✓	×you supply files	✓	✓
OLED design + webtoon-first reader	✓	basic	mobile	basic
Installable PWA + offline, any device	✓	partial	Android only	partial
Per-user progress + household	✓	✓	×	limited
2FA · lockout · audit · sessions	✓	basic	×	×
Add a source by pasting a URL	✓	n/a	extensions	extension repos
Reaches Mihon’s extensions	✓	×	✓	✓
Syncs progress to AniList	✓	Kavita+, paid	✓	✓
Single sign-on (OIDC)	✓	✓	×	×
Finds chapter gaps & bad downloads	✓	partial	×	×
API tokens, scoped read / write / admin	✓	keys, unscoped	×	×
Automatic nightly backups	✓	×	×	×

uchiyomi / household

Managing the accounts on a household Uchiyomi server

Honest about it: Komga and Kavita are further along at managing a library. Uchiyomi edits two metadata fields, never writes back to your files, and can’t delete or rename anything. It reads CBZ, CBR and folders of images, and skips PDF and EPUB on purpose. Extensions run in a second container with a JVM’s worth of memory, and you paste a repository URL once, exactly as you would in Mihon. What you get for that is the combination nobody else offers: one app that finds, fetches, tracks and reads, for a whole household.

Inside

One image. A surprising amount inside.

Mihon extensions

Around 1,400 of them. Click Add, search immediately.

AniList sync

Finish a chapter, your list updates itself.

Library health

Finds gaps, bad downloads and duplicates for you.

Single sign-on

OIDC against Authentik, Authelia or Keycloak.

Scoped API tokens

Read, write or admin. Revocable any time.

Offline

Installs as an app. Reads with no connection.

Multi-user household

Accounts, progress, streaks and a leaderboard.

Nightly backups

Database and config, rotated, restorable.

Self-host in minutes

One file. One command. Done.

One docker compose up brings up the reader, the API, the database, the Cloudflare solver and the extension engine together. No stack to assemble.

View the repo MPL-2.0 · runs anywhere Docker does

bash · uchiyomi

// one file, prebuilt images — nothing to compile
  $ curl -O https://raw.githubusercontent.com/AngeloSha/uchiyomi/main/deploy/docker-compose.yml

  // already have a manga folder? point at it first (optional)
  $ echo "LIBRARY_PATH=/path/to/your/manga" > .env

  $ docker compose up -d
  
  // later, to update: docker compose pull && docker compose up -d

  // open http://localhost:8080 and create your admin account
  // in the browser, add a source by URL, and start reading.
  ✓ uchiyomi-web           running
  ✓ uchiyomi-bff           running
  ✓ uchiyomi-db            running
  ✓ uchiyomi-flaresolverr  running
  ✓ uchiyomi-suwayomi      running

The Uchiyomi sign-in screen on a fresh install — …then create your admin account in the browser.

Install it

Add Uchiyomi to your home screen.

It installs from your own server, not an app store. Open your Uchiyomi in the browser and add it to the home screen: full-screen, true black, and it reads offline.

Uchiyomi home screen on a phone — Add to home screen

Reading a chapter full-screen on a phone — Full-screen, true black

A library of series on a phone — Your library, in your pocket

Safari → Share → Add to Home Screen Chrome → menu → Install app

What’s new