Skip to content

Kavita, FlareSolverr and Suwayomi

Kavita, FlareSolverr and Suwayomi are optional. Maki works without any of them.

Maki reaches each companion by its service name, such as http://flaresolverr:8191.

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
# Point a Kavita library at the same folder.
kavita:
image: jvmilazz0/kavita:latest
container_name: kavita
volumes:
- ./kavita-config:/kavita/config
- /path/to/manga-library:/library
ports:
- "5000:5000"
restart: unless-stopped
# Needed for Cloudflare-protected sources.
flaresolverr:
image: ghcr.io/flaresolverr/flaresolverr:latest
container_name: flaresolverr
ports:
- "8191:8191"
restart: unless-stopped
# Extension sources. Install extensions in its own UI.
suwayomi:
image: ghcr.io/suwayomi/suwayomi-server:stable
container_name: suwayomi
volumes:
- ./suwayomi-data:/home/suwayomi/.local/share/Tachidesk
ports:
- "4567:4567"
restart: unless-stopped

The ports lines are only for opening a companion’s own web interface from your browser. Maki does not need them.

Kavita reads Maki’s CBZ files as they are, with no link to Maki. To connect the two, fill in the Kavita card under Settings → Integrations → Kavita:

  • URL is the address Maki uses to reach Kavita, here http://kavita:5000.
  • API key comes from Kavita under User Settings, 3rd Party Clients.
  • Path as Maki sees it and Path as Kavita sees it are only needed when Maki and Kavita see the library folder at different paths. The compose file mounts it at /library in both, so leave both fields empty.
  • Attribute Kavita’s reading to picks the Kavita user that reading progress is attributed to.

If you read in Kavita or another app, see Reading over OPDS and Komga.

FlareSolverr solves Cloudflare challenges for sources that sit behind them.

  1. Open Settings → Downloads → FlareSolverr.
  2. Set the URL to http://flaresolverr:8191.
  3. Click Test.

The built-in sources list marks the sources that require it. The rest work without it.

Suwayomi is a server for Tachiyomi-style extensions, which Maki uses as extra sources. Install the extensions in Suwayomi’s own interface, not in Maki.

  1. Open Settings → Integrations → Suwayomi.
  2. Set the URL to http://suwayomi:4567.
  3. Click Test.
  4. Click Manage sources and turn on the ones you want Maki to use.

The suwayomi-data folder in the compose file keeps Suwayomi’s data between restarts.