Maki

Maki

Docker app from Orbit's Repository

Maki is a manga collection manager for the *arr ecosystem.

Overview
Maki is a manga collection manager for the *arr ecosystem. It tracks series across multiple scraper sources and torrent trackers, downloads chapters into CBZ files with embedded metadata, and lets you read them with a built-in reader (with a Home screen and progress tracking) or hand them off to Kavita. Includes an OPDS server for external readers, scrobbling to AniList/MyAnimeList/Kitsu/MangaBaka, rewind reading stats, user tags and saved library filters, and a local-embeddings "Discover" recommendation engine over the MangaBaka dump. After starting the container, open the WebUI, go to Settings, and add your /library path as a root folder. Point a Kavita library at the same /library folder to read the downloaded CBZs.

Maki: add a series once and it keeps it complete


Maki

Add a series once and Maki keeps it complete.
A self-hosted manga manager in the spirit of Sonarr and Radarr, with a reader built in.

Latest Tag CI License: GPL v3 Translation status

Overview · Why Maki · Quick start · Download · Sources · Docs site · Languages


Recommendations from your own library Reading progress follows you to every tracker

New chapters are queued on their own Plain CBZ with ComicInfo.xml that any reader opens

Home on a phone The built-in reader Discover on a phone Reading stats on a phone

Overview

Maki watches manga sites for new chapters, downloads the pages and writes CBZ files with ComicInfo.xml metadata. Kavita and most comic readers understand that format, so the same folder works everywhere. You can also read in Maki's own reader, over OPDS in Panels, Chunky, KOReader and Mihon, or in apps that speak Komga's API.

[!NOTE] Maki is almost entirely AI-slop-built, developed with Anthropic's latest Claude models. It is pre-1.0, so the schema and API can still change between releases. Issues and pull requests are welcome.

Why Maki

  • Recommendations from your own library. Local embeddings over the MangaBaka catalog suggest what to read next, with rails for blind spots, Readers like you and Your Taste. It all runs on your server.
  • Automatic monitoring. Maki checks your sources on a schedule, picks the best one for each series and queues new chapters as they appear. Series that release often are checked every 30 minutes, and an Upcoming view shows when the next chapter is likely. More than 30 sources are built in, in over a dozen languages, and optional Suwayomi support adds its extensions on top. Torrents through Prowlarr or Jackett, sent to qBittorrent, Transmission or Deluge, work the same way.
  • Scrobbling. Reading progress goes to AniList, MyAnimeList, Kitsu, MangaBaka and MangaUpdates, whether you read in Maki, over OPDS or in Kavita.
  • Plain files, any reader. Everything is saved as CBZ with ComicInfo.xml. Kavita, KOReader, Panels, Chunky, Mihon or any other comic reader can use the same folder, and nothing is locked inside Maki's database.
  • A reader when you want one. Paged, double-page or continuous scroll, with progress merged across every app you read in. Install Maki to your phone's home screen and save chapters to read offline.

Also included: multiple users with per-folder access, two-factor and OpenID Connect, notifications to Discord, Telegram, ntfy and more plus push to your devices, Mihon backup import, optional WebP/AVIF page conversion, stats and Rewind, eleven languages, a REST API and one-click backups. The full list is in docs/features.md.

Quick start

services:
  maki:
    image: ghcr.io/orbitmpgh/maki:latest
    container_name: maki
    environment:
      - PUID=1000
      - PGID=1000
    volumes:
      - ./maki-config:/config
      - /path/to/manga-library:/library
    ports:
      - "8990:8990"
    mem_reservation: 512m
    restart: unless-stopped
  1. Open http://localhost:8990 and create the administrator account.
  2. The setup guide opens next. Add /library as a library folder there. Maki downloads the local MangaBaka database in the background (about 350 MB, 3.5 GB on disk) and finishes opening once it is installed.
  3. Click Add series, search for a title and pick it. Maki links sources and syncs chapters in the background.
  4. Download a chapter or click Search all missing, then follow progress under Activity.

Kavita, FlareSolverr and Suwayomi are optional. A compose file with all of them is in docs/docker-compose.example.yml. If you use FlareSolverr, set its URL under Settings → Downloads → FlareSolverr to http://flaresolverr:8191 and hit Test. For Suwayomi, set http://suwayomi:4567 under Settings → Integrations → Suwayomi, hit Test, then Manage sources to turn on the ones you want.

mem_reservation is a soft limit: when the host runs short of memory, the kernel takes Maki's file cache back first. Most dashboards count that cache as the container's memory, so without it Maki can look much bigger than it is. Don't set a hard mem_limit below 1.5 GB yet, since a scrape and a search running together can briefly need close to 1 GB.

Offline reading and push notifications need HTTPS. See Exposing Maki to the internet for a reverse proxy setup.

Upgrading from a single-user Maki? The first page asks you to set a username and password. Your library, history and tracker connections are already attached to that account.

Download

Platform Status Get it
Docker (amd64, arm64) Supported ghcr.io/orbitmpgh/maki:latest
Unraid Supported Search for Maki in the Apps tab on your Unraid server
Windows 10 and 11 (x64), installer Supported Maki-<version>-windows-x64-setup.exe from Releases, see docs/windows.md
Windows 10 and 11 (x64), portable Supported Maki-<version>-windows-x64-portable.zip from Releases
Linux x64 tarball Community Maki-<version>-linux-x64.tar.gz from Releases, see docs/linux.md
Linux arm64 tarball Community, tested by CI only Maki-<version>-linux-arm64.tar.gz from Releases
macOS Not available Use Docker
From source Supported .NET 10 and Node 24, see docs/development.md

Sources

35 sources are built in, from official publisher sites to scanlation groups, in over a dozen languages. Nothing to install. If you already run Suwayomi, point Maki at it and its extensions appear next to the built-in sources.

Show all sources

Notes on languages, FlareSolverr and mirror overrides are also in docs/sources.md.

Source Notes
MangaDex Official API, language filter
MANGA Plus Official (Shueisha), language-specific mappings
WEBTOON Official (webtoons.com), ORIGINALS and CANVAS in en, id, th, es, fr, zh-Hant, de
Naver Webtoon Official (comic.naver.com), Korean, WEBTOON tier only
GigaViewer sites Official Japanese: Shonen Jump+, Comic Days, Sunday Webry, MAGCOMI, Tonari no Young Jump, Comic Zenon, Kurage Bunch (free episodes only)
KadoComi (Comic Walker) Official, Japanese
MangaPill
Weeb Central Requires FlareSolverr
MangaFire Language filter, requires FlareSolverr
TCB Scans Domain override via MAKI_SOURCE_TCBSCANS_BASEURL
Asura Scans Manhwa/manhua
Flame Comics Manhwa/manhua, requires FlareSolverr
TopManhua Manhwa/manhua, requires FlareSolverr
MangaKatana
MangaKakalot Requires FlareSolverr
Atsumaru atsu.moe
Dynasty Scans English, yuri
Toonily Manhwa, adult, requires FlareSolverr
Manhwa18.net Adult, requires FlareSolverr
Baozi Manhua Simplified Chinese manhua
Manhuagui Simplified Chinese, mirror override via MAKI_SOURCE_MANHUAGUI_BASEURL
Manga Livre Brazilian Portuguese
Taiyō Brazilian Portuguese
ManhwaWeb Spanish
Olympus Scanlation Spanish, requires FlareSolverr
Anime-Sama French, requires FlareSolverr
Manga-Tube German
MangaWorld Italian
MangaLib Russian
MangaDenizi Turkish
Shinigami Indonesian, manhwa/manhua/manga
Cứu Truyện Vietnamese, FlareSolverr when challenged, mirror override via MAKI_SOURCE_CUUTRUYEN_BASEURL
Team-X Arabic, requires FlareSolverr; the domain rotates, override it with MAKI_SOURCE_TEAMX_BASEURL
Sen Manga Japanese raws
Rawkuma Japanese raws, FlareSolverr when challenged, mirror override via MAKI_SOURCE_RAWKUMA_BASEURL

Documentation

The full documentation lives at orbitmpgh.github.io/Maki: installation for every platform, setup guides, how each feature works and how to contribute. Its source is in site/, so fixes to the docs go through a normal pull request.

The guides below are also kept in the repository.

Guide Covers
Features Everything Maki does, in full
Sources The built-in sources and Suwayomi
Multiple readers Per-user data, library access, Kavita
Offline reading Installing as an app, saving chapters, push
KOReader OPDS downloads and progress sync
Exposing Maki to the internet HTTPS, trusted proxies, two-factor
Single sign-on OpenID Connect setup and claim mapping
Access log and CrowdSec Request log for ban tools, CrowdSec parser and scenarios
Backup and restore Snapshots, migrations, restoring
Development Building the image, running from source, architecture

Languages

The interface ships in English, German, French, Spanish, Brazilian Portuguese, Polish, Russian, Turkish, Japanese, Simplified Chinese and Korean. Everything except English is machine-translated and marked as needing review. Fixing a string on Hosted Weblate is the easiest way to help. More in docs/languages.md.

Legal

Maki is a tool for organizing your library. Scraper sources access third-party websites. You are responsible for complying with those sites' terms of service and your local laws. Support the industry: buy official releases.

License

GPL-3.0

The optional page-enhance models and shaders are separate files with their own licences, one of them non-commercial; see THIRD_PARTY_NOTICES.md.

Categories

Related apps

Explore more like this

Explore all

Links

Details

Repository
ghcr.io/orbitmpgh/maki:latest
Last Updated2026-11-22
First Seen2026-07-20

Runtime arguments

Web UI
http://[IP]:[PORT:8990]/
Network
bridge
Shell
bash
Privileged
false
Extra Params
--memory-reservation=512m

Template configuration

WebUI PortPorttcp

Maki web interface port

Target
8990
Default
8990
Value
8990
ConfigPathrw

Database, logs, covers, page cache, config.json/API key

Target
/config
Default
/mnt/user/appdata/maki
Value
/mnt/user/appdata/maki
LibraryPathrw

Manga library root

Target
/library
Default
/mnt/user/manga
Value
/mnt/user/manga
PUIDVariable

User ID to run as (matches file ownership of Config/Library)

Default
99
Value
99
PGIDVariable

Group ID to run as (matches file ownership of Config/Library)

Default
100
Value
100