Skip to content

Mirror and domain overrides

Some sites change domains, rotate them after takedowns, or are blocked where you live. Several built-in sources read an environment variable that replaces the address Maki uses. These are set on the server, not in the web UI.

Variable Source Built-in address
MAKI_SOURCE_TCBSCANS_BASEURL TCB Scans https://tcbonepiecechapters.com
MAKI_SOURCE_RAWKUMA_BASEURL Rawkuma https://rawkuma.net
MAKI_SOURCE_MANHWAWEB_APIURL ManhwaWeb The API host only. The site address has no override.
MAKI_SOURCE_ANIMESAMA_BASEURL Anime-Sama https://anime-sama.to
MAKI_SOURCE_SHINIGAMI_BASEURL Shinigami https://11.shinigami.asia, used for links and URL resolution
MAKI_SOURCE_SHINIGAMI_APIURL Shinigami https://api.shngm.io, the API host
MAKI_SOURCE_MANHUAGUI_BASEURL Manhuagui https://www.manhuagui.com
MAKI_SOURCE_OLYMPUS_BASEURL Olympus Scanlation https://olympusxyz.com
MAKI_SOURCE_CUUTRUYEN_BASEURL Cứu Truyện https://cuutruyen.net
MAKI_SOURCE_TEAMX_BASEURL Team-X https://olympustaff.com
MAKI_SOURCE_MANGAWORLD_BASEURL MangaWorld https://www.mangaworld.mx
MAKI_SOURCE_MANGALIB_APIURL MangaLib https://api.cdnlibs.org, the API host

Shinigami has two variables because its website number and API host rotate separately. Custom sources don’t use these variables, since each has its own address in its definition.

Add the variables to the environment list of the maki service. Use the mirror’s address with the scheme and no path (a trailing slash is stripped).

services:
maki:
image: ghcr.io/orbitmpgh/maki:latest
environment:
- PUID=1000
- PGID=1000
- MAKI_SOURCE_TCBSCANS_BASEURL=https://tcb-mirror.example

Then run docker compose up -d maki. Maki reads these values at startup, and up -d recreates the container with the new values, which a plain restart does not.

A mirror has to serve the same site layout, because Maki reads each source with that site’s own layout. A failing source shows Error on its row on the series page, and hovering over it shows the message.

To go back to the built-in address, remove the line and run docker compose up -d maki again.