Skip to content
RenzodefPublic

About

Self-hosted manga, manhwa and comics manager for the *arr stack (Sonarr for manga): monitors series, downloads chapters and volumes via Suwayomi, Prowlarr, qBittorrent and SABnzbd, and builds a clean CBZ library for Komga, Kavita and Stump.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

1 watching

Forks

Latest commit

 

History

70 Commits

Folders and files

Tankarr logo: three manga volumes on a shelf

Tankarr

Self-hosted manga, manhwa and comics manager for the *arr stack: Sonarr for manga.

CI status Latest release Docker image on GitHub Container Registry License: GPL-3.0 OpenSSF Scorecard Documentation Online demo

Tankarr follows the manga, manhwa, webtoons and comics you read. It downloads new chapters and volumes automatically in the language you choose, and files them into a clean, reader-ready CBZ library for Komga, Kavita, Stump or its own built-in reader. If you know Sonarr or Radarr, you already know how it works: add a series once, pick a monitoring profile, and Tankarr keeps the series complete.

Try it online: the real interface on a library of well-known manga, manhwa and manhua, every page and the built-in reader, nothing to install.

The Tankarr Library: a grid of series covers with chapter counts, language and status badges

A series page with the publisher's release rhythm and the chapter list

A fictional library, generated for the documentation. More screenshots.

  • Add a work, not a website. Series are identified through the MangaBaka catalogue (with MangaUpdates, AniList, Kitsu and MyAnimeList IDs). Download sources are mapped afterwards, so a badly named mirror never decides what a series is.
  • Every kind of source. A managed Suwayomi engine with Mihon/Tachiyomi-compatible extensions, Prowlarr indexers with qBittorrent (torrents) and SABnzbd (Usenet), the Internet Archive, and a local import folder for the files you already own.
  • The language belongs to the release. A Japanese manga can be followed in English, Italian or any language a translation exists in. Downloads from indexers are checked with OCR before they enter the library.
  • Chapters or volumes. Tankarr reads what a series actually offers, follows chapters while a work is running and volumes once it is collected, and can assemble chapters into books.
  • A library that stays clean. Consistent naming, ComicInfo.xml metadata, covers, hash-checked atomic imports, a recycle bin, and page-quality checks that replace unreadable downloads.
  • *The arr experience. Library, Activity queue, Wanted, History, interactive release search, monitoring profiles, and a System page with health checks, scheduled tasks, logs and one-click backups.
  • In your language. The interface is available in English and Italian, chosen per browser; another language is one JSON file away.
  • Built to be operated. Notifications to ntfy, Discord, Telegram, Apprise or any webhook; an API key and Prometheus metrics; forms, basic or reverse-proxy (Remote-User) authentication; PUID/PGID; verified automatic backups and safe restores.
  • Runs anywhere Docker runs. Multi-architecture images for linux/amd64 and linux/arm64 (Raspberry Pi 4 and 5 included), a Compose file, an Unraid template and a Helm chart.

If Tankarr is useful to you, a star on GitHub helps other readers find it.

Quick start

Tankarr is distributed as a Docker image on the GitHub Container Registry. Create a docker-compose.yml:

services:
  tankarr:
    image: ghcr.io/renzodef/tankarr:latest
    container_name: tankarr
    environment:
      PUID: 1000                    # the user and group that own your folders
      PGID: 1000
      TZ: Etc/UTC
    volumes:
      - ./config:/config            # database, settings, cache, backups
      - /path/to/comics:/library    # your manga and comics library
      - /path/to/import:/import:ro  # optional: files to add to the library
    ports:
      - "8787:8787"
    restart: unless-stopped

Start it, read the login Tankarr creates on its first start, and open http://localhost:8787:

docker compose up -d
docker compose logs tankarr | grep "created one"

Tankarr never runs without a login: you can also choose your own with TANKARR_AUTH_USERNAME and TANKARR_AUTH_PASSWORD, and change it any time under Settings → Security. The setup page then walks you through the library, the reader, the download sources and the optional indexers. The installation guide covers docker run, permissions, reverse proxies, Raspberry Pi and running from source.

Documentation

The full documentation lives at https://renzodef.github.io/tankarr/ (sources in docs/):

Guide What it covers
Installation Docker Compose, docker run, Unraid, Kubernetes (Helm), folders and permissions, reverse proxy, building from source
Getting started First login, setup checklist, adding series, monitoring profiles, your first download
Configuration Every TANKARR_* environment variable and its default
Integrations Suwayomi, Prowlarr, qBittorrent, SABnzbd, Internet Archive, Komga, Kavita, Stump, notifications (ntfy, Discord, Telegram, Apprise, webhooks), Prometheus
How Tankarr works Identity, numbering, official editions, Wanted recovery, page quality
Compared with other tools Where Tankarr sits next to Mylar3, Kapowarr, Suwayomi and readers like Komga
Screenshots Every page of the interface
Upgrading Release channels, image tags, backups and rollback
FAQ and troubleshooting Common questions and problems

Release channels

Tankarr is published the way the other *arr applications are, as Docker images on a registry with a stable channel and immutable builds:

Image tag Built from Use it for
latest, X.Y.Z, X.Y a release tag on main Stable releases. Recommended.
branch-<name> a branch with an open pull request Trying a change before it is merged.
sha-<commit> any published build Pinning or rolling back to one exact build.

Release notes are on the releases page.

FAQ

Is Tankarr a "Sonarr for manga"? Yes. It brings the Sonarr and Radarr workflow (monitored series, a Wanted list, a download queue, release profiles) to manga, manhwa, manhua, webtoons and comics, and it integrates with the same tools: Prowlarr, qBittorrent and SABnzbd.

How is it different from Mylar3, Kapowarr or Suwayomi? Mylar3 and Kapowarr are built around ComicVine and Western comic books; Suwayomi and Mihon are readers with source extensions. Tankarr identifies works through manga catalogues, follows chapters across editions and languages, uses Suwayomi as one of several download channels, and writes a library for your reader. The comparison goes through it tool by tool.

Does Tankarr host or distribute manga? No. Tankarr contains no content and no sources of its own. It automates the tools and sources that you configure. You are responsible for complying with the laws of your country and the terms of the services you use. Please support the creators and official publishers of the works you enjoy.

Which readers does it work with? Any reader that can open a folder of CBZ files. Tankarr has a built-in web reader and can drive Komga and Stump directly (library scans, metadata and covers). Kavita and other readers work by pointing them at the same library folder.

Does it run on a Raspberry Pi? Yes. The image is built for arm64 and Tankarr is developed on a Raspberry Pi 5. Allow about 1.5 GB of memory for the container when the managed Suwayomi engine is enabled.

Contributing

Bug reports, ideas and pull requests are welcome. Read the contributing guide: changes go through pull requests against main, and nothing is pushed to it directly. For questions and ideas, open a discussion.

Please report security vulnerabilities privately, as described in the security policy.

License

Tankarr is free software released under the GNU General Public License v3.0.

About

Self-hosted manga, manhwa and comics manager for the *arr stack (Sonarr for manga): monitors series, downloads chapters and volumes via Suwayomi, Prowlarr, qBittorrent and SABnzbd, and builds a clean CBZ library for Komga, Kavita and Stump.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages