Suwayomi
Manga reader server with extensions, downloads and a web reader
- ghcr.io/suwayomi/suwayomi-server:v2.4.2490
- v2.4.2490
- Updated 21 Nov 2026
- port 6785
- amd64 · arm64
- Media
- 8.1k stars
Open the app
About Suwayomi
Suwayomi is a manga reader that runs on your server, like Tachiyomi and Mihon. Add sources with extensions, follow series in your library, download chapters and read them in your browser or in apps that connect to it. New chapters are checked for on a schedule.
Features
- Extensions for many manga sources, like Tachiyomi and Mihon
- Library with categories, read progress and history
- Chapter downloads, as images or CBZ files
- Web reader for phone and desktop
- Tracking with AniList, MyAnimeList and others
- Automatic library updates and backups
How to use
- Open Suwayomi from your dashboard.
- Go to Extensions and install the sources you want.
- Search a source in Browse and add a series to your library.
- Open a chapter to read it, or download it.
Before you install
You can install it as it is and open it at http://[ZIMAOS-IP-ADDRESS]:6785. There is no login by default, as upstream ships it: to add one, set AUTH_MODE to ui_login and add AUTH_USERNAME and AUTH_PASSWORD in the app settings. Downloads go to /DATA/Media/Manga, and the library and settings are in /DATA/AppData/suwayomi/data. Update times, backups, FlareSolverr and the other settings are in the Variables tab. The first start takes a few minutes while it downloads the web reader.
The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.
In the app settings
| Variable | Default value | Description |
|---|---|---|
TZ | $TZ | Your time zone. It is filled in from your ZimaOS time zone and used for the update and backup times. |
AUTH_ | none | none lets anyone on your network in. For a login, set it to ui_login and add AUTH_USERNAME and AUTH_PASSWORD (see the Variables tab). |
Sign-in
| Variable | Default value | Description |
|---|---|---|
AUTH_ | — | The user name for the login, when AUTH_MODE is not none. |
AUTH_ | — | The password for the login. Pick your own. |
JWT_ | 60d | How long you stay signed in with ui_login. |
Library
| Variable | Default value | Description |
|---|---|---|
DOWNLOAD_ | false | Set to true to save chapters as CBZ files. |
UPDATE_ | 12 | How often to look for new chapters, in hours (at least 6, 0 turns it off). |
MAX_ | 6 | How many sources may be checked or downloaded from at once (1 to 20). |
EXTENSION_ | [] | More extension stores, as a list like ["https://.../index.min.json"]. |
Backups
| Variable | Default value | Description |
|---|---|---|
BACKUP_ | 00:00 | When the daily backup runs, as HH:MM. |
BACKUP_ | 1 | Days between backups. 0 turns them off. |
BACKUP_ | 14 | How many days to keep backups. |
Web reader
| Variable | Default value | Description |
|---|---|---|
WEB_ | stable | bundled, stable or preview. |
WEB_ | 23 | Hours between web reader update checks. 0 turns it off. |
FlareSolverr
| Variable | Default value | Description |
|---|---|---|
FLARESOLVERR_ | false | Set to true to get past Cloudflare checks with FlareSolverr. |
FLARESOLVERR_ | http://localhost:8191 | Your FlareSolverr address, like http://192.168.1.20:8191. |
Proxy
| Variable | Default value | Description |
|---|---|---|
SOCKS_ | false | Set to true to connect through a SOCKS5 proxy. |
SOCKS_ | — | The proxy's address. |
SOCKS_ | — | The proxy's port. |
Server
| Variable | Default value | Description |
|---|---|---|
DEBUG | false | Set to true for more detail in the log. |
name: suwayomi
services:
suwayomi:
image: ghcr.io/suwayomi/suwayomi-server:v2.4.2490
container_name: suwayomi
user: "0:0"
restart: unless-stopped
stop_grace_period: 30s
network_mode: bridge
environment:
- TZ=$TZ
- AUTH_MODE=none
ports:
- target: 4567
published: "6785"
protocol: tcp
volumes:
- type: bind
source: /DATA/Media/Manga
target: /home/suwayomi/.local/share/Tachidesk/downloads
bind:
create_host_path: true
- type: bind
source: /DATA/AppData/$AppID/data
target: /home/suwayomi/.local/share/Tachidesk
bind:
create_host_path: true
healthcheck:
test: ["CMD", "curl", "-fsS", "-o", "/dev/null", "http://127.0.0.1:4567/"]
interval: 30s
timeout: 10s
retries: 5
start_period: 180s
deploy:
resources:
limits:
cpus: "2.00"
memory: 2048M
reservations:
cpus: "0.05"
memory: 256M
labels:
icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/suwayomi/icon.png
x-casaos:
id: com.icestore.suwayomi
envs:
- container: TZ
description:
en_US: >-
Your time zone. It is filled in from your ZimaOS time zone and
used for the update and backup times.
- container: AUTH_MODE
description:
en_US: >-
none lets anyone on your network in. For a login, set it to
ui_login and add AUTH_USERNAME and AUTH_PASSWORD (see the
Variables tab).
ports:
- container: "4567"
description:
en_US: Suwayomi web reader and API, published on host as 6785
volumes:
- container: /home/suwayomi/.local/share/Tachidesk/downloads
description:
en_US: >-
Downloaded chapters, in /DATA/Media/Manga.
- container: /home/suwayomi/.local/share/Tachidesk
description:
en_US: >-
Suwayomi's library database, extensions, settings, backups and
logs. Back it up.
x-casaos:
id: com.icestore.suwayomi
architectures:
- amd64
- arm64
main: suwayomi
author: HSinghHira
category: Media
developer: Suwayomi
icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/suwayomi/icon.png
title:
en_US: Suwayomi
tagline:
en_US: Manga reader server with extensions, downloads and a web reader
description:
en_US: >-
Suwayomi is a manga reader that runs on your server, like Tachiyomi
and Mihon. Add sources with extensions, follow series in your
library, download chapters and read them in your browser or in apps
that connect to it. New chapters are checked for on a schedule.
**Features**
- Extensions for many manga sources, like Tachiyomi and Mihon
- Library with categories, read progress and history
- Chapter downloads, as images or CBZ files
- Web reader for phone and desktop
- Tracking with AniList, MyAnimeList and others
- Automatic library updates and backups
**How to use?**
1. Open Suwayomi from the ZimaOS dashboard.
2. Go to Extensions and install the sources you want.
3. Search a source in Browse and add a series to your library.
4. Open a chapter to read it, or download it.
tips:
before_install:
en_US: >-
1. Downloads go to /DATA/Media/Manga.
2. There is no login by default. To add one, set AUTH_MODE to
ui_login and add AUTH_USERNAME and AUTH_PASSWORD in the app
settings.
3. Start the installation. The first start takes a few minutes.
4. Open http://[ZIMAOS-IP-ADDRESS]:6785.
index: /
port_map: "6785"
scheme: http
is_uncontrolled: false
version: "v2.4.2490"
update_at: "2026-11-21"
release_notes:
en_US: |-
- First IceStore release, on port 6785
- The official ghcr.io/suwayomi/suwayomi-server image, v2.4.2490, run as root so it can write the ZimaOS folders
- Downloads go to /DATA/Media/Manga
repo: "https://github.com/Suwayomi/Suwayomi-Server"
support: "https://github.com/Suwayomi/Suwayomi-Server/issues"
docs: "https://github.com/Suwayomi/Suwayomi-Server-docker#readme"Install Suwayomi
Something not working with Suwayomi?
Report it so it gets fixed, or ask for an app that is not here yet.
ZimaOS
Add the store link, then find Suwayomi in the App Store and install it.
CasaOS
Add the store link, then find Suwayomi in the App Store and install it.
ReCasaOS
Add the store link, then find Suwayomi in the App Store and install it.
Homeio
Add the store link, then find Suwayomi in the App Store and install it.
MOS
Add the repository in MOS Hub Settings, then find Suwayomi in Docker → MOS Hub and install it.