# Uchiyomi-Suwayomi

Uchiyomi-Suwayomi is the Suwayomi extension engine that runs Mihon and Tachiyomi extensions for the Uchiyomi manga server. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3429/uchiyomi-suwayomi

## Description

Uchiyomi-Suwayomi is the Suwayomi extension engine that runs Mihon and Tachiyomi extensions for the Uchiyomi manga server. It enables Uchiyomi to search, follow, and download manga from community-maintained sources in a separate background container. You configure it through Uchiyomi's Admin → Extensions tab and never interact with it directly. MangaDex and manually-added sites work in Uchiyomi without this component. Requires Uchiyomi to be installed and running first.

## Platform availability

Available on 3 of 10 platforms: Unraid, Mac, Windows.

## Desktop and other devices

Mac, Windows.

## Health score

73/100 (Good), based on 5 of 5 factors.
- Maintained: 100 (last commit 7 days ago)
- Popular: 41 (114 GitHub stars)
- Easy to install: 55 (3 install platforms, install notes, Docker image)
- Light to run: 50 (2 GB minimum RAM)
- Security check: 94 (no serious findings, 1 minor, CI, tests)

## Links

- desktop: https://github.com/AngeloSha/uchiyomi/releases/latest
- Unraid: https://ca.unraid.net/apps/uchiyomi-suwayomi-0qlgn3x17vm09l?q=uchiyomi-suwayomi
- GitHub: https://github.com/AngeloSha/uchiyomi
- Official website: https://uchiyomi.com

## Common questions

### Do I need to open a separate Suwayomi web UI to manage Mihon or Tachiyomi extensions in Uchiyomi?

No. Uchiyomi runs a headless Suwayomi-Server engine, and its extensions are browsable and installable from Uchiyomi's admin panel.

### Can Uchiyomi use MangaDex or manually added sites if Uchiyomi-Suwayomi is not used?

Yes. MangaDex and manually added sites work in Uchiyomi without the extension engine, while Mihon and Tachiyomi extensions depend on it.

### On Unraid, how should I prepare the appdata folder for Uchiyomi-Suwayomi?

Create /mnt/user/appdata/uchiyomi-suwayomi and chown it to 1000:1000 before first start. The engine runs as user 1000 and cannot write to a root-owned folder; first start takes 1-2 minutes.

### Will Suwayomi download chapter files again if they already exist?

Suwayomi picks up existing files and does not download anything that is not new.

---
Source: Our Local Host (https://ourlocalhost.com/app/3429/uchiyomi-suwayomi), the self-hosted and open-source app directory.
