Most installs need none of these. Set them in the compose file’s environment list or with docker run -e, then restart Maki. For the Linux service, add an Environment=NAME=value line to the [Service] section of maki.service, then run systemctl daemon-reload and restart the service.
In the timer and cache variables below, a value that is not a whole number or is negative falls back to the default.
| Variable |
Default |
What it does |
PUID |
1000 |
User ID Maki runs as. On each start the container changes the owner of anything in /config that is not already PUID:PGID. |
PGID |
1000 |
Group ID Maki runs as. |
MAKI_RUNTIME |
docker in the image |
docker or desktop. Any other value is treated as unset. Unset: Docker if /.dockerenv exists, otherwise a bare start. The update check reports Docker as IsDocker. |
MAKI_CONFIG_DIR |
/config in the image |
Folder for the database, logs, covers, caches and config.json. Unset: /config if it exists, otherwise %APPDATA%\Maki on Windows. The Windows app sets it to %LOCALAPPDATA%\Maki. See Ports, paths and files on disk. |
MAKI_DESKTOP_UPDATE_FEED |
GitHub releases |
Folder or URL holding vpk pack output, read by the Windows app instead of GitHub releases. Use it to test an update before it is published. |
MAKI_DESKTOP_SERVER and MAKI_DESKTOP_PARENT are for development and internal use, so they are not listed here.
| Variable |
Default |
What it does |
MAKI_ALLOW_LOCAL_LOGIN |
Off |
1 or true allows password sign-in for everyone when auth.oidconly is on. Admins can always use a password. For when the identity provider is down. |
| Variable |
Default |
What it does |
MAKI_DUMP_BOOT_DOWNLOAD |
On |
With no MangaBaka database installed, the download starts about 5 seconds after boot. 0 delays it to 2 minutes. |
MAKI_DROP_SCAN_CACHE |
On |
After a scan reads a file end to end, the OS drops its cached pages. Linux only. 0 keeps them, which suits a machine with RAM to spare. |
MAKI_EMBED_IDLE_MINUTES |
1 |
Minutes idle before the embedding model is unloaded from memory. 0 keeps it loaded. |
MAKI_ARTIFACT_IDLE_MINUTES |
1 |
Minutes idle before the in-memory catalogue and recommendation indexes are dropped. 0 keeps them loaded. |
MAKI_VECTOR_IDLE_MINUTES |
1 |
Minutes idle before the search vectors are dropped from memory. 0 keeps them loaded. |
MAKI_SNAPSHOT_MMAP |
On |
The search vectors, catalogue indexes and co-read graph are read in place from their snapshot files instead of being copied into memory, so the OS can drop those pages under pressure. 0 copies them into memory instead, for a filesystem where memory-mapped files misbehave. |
MAKI_EMBED_MMAP |
On |
The search model’s weights are read from a memory-mapped copy of the model (about 110 MB in the config folder, written on the first search by meaning) instead of being copied into memory, which saves about 100 MB while the model is loaded. Applies to the CPU provider. 0 turns it off, for a filesystem where memory-mapped files misbehave. |
MAKI_BROWSER_IDLE_MINUTES |
1 |
Minutes idle before the headless browser used by some sources shuts down. 0 keeps it running. |
| Variable |
Default |
What it does |
MAKI_EMBED_PROVIDER |
cpu |
cuda runs the embedding model on an NVIDIA GPU. Any other value runs it on the CPU. |
MAKI_EMBED_PRECISION |
int8 on CPU, fp32 on CUDA |
Model precision: int8 (or quantized) or fp32 (or float32). |
MAKI_EMBED_BATCH |
32 on CPU, 128 on CUDA |
Items per batch when computing embeddings. |
MAKI_EMBED_MODEL_URL |
The Snowflake Arctic Embed M model on Hugging Face, for the chosen precision |
URL the model file is downloaded from. |
MAKI_EMBED_VOCAB_URL |
The vocab.txt of the same model on Hugging Face |
URL the tokenizer vocabulary is downloaded from. |
Each variable overrides the built-in domain or API host of one source. To find a working mirror and set one, see Mirror overrides.
| Variable |
Default |
What it does |
MAKI_SOURCE_TCBSCANS_BASEURL |
Built-in domain |
Domain for TCB Scans. |
MAKI_SOURCE_RAWKUMA_BASEURL |
Built-in domain |
Domain for Rawkuma. |
MAKI_SOURCE_MANHWAWEB_APIURL |
Built-in API host |
API host for ManhwaWeb. |
MAKI_SOURCE_ANIMESAMA_BASEURL |
Built-in domain |
Domain for Anime-Sama. |
MAKI_SOURCE_SHINIGAMI_APIURL |
Built-in API host |
API host for Shinigami. |
MAKI_SOURCE_SHINIGAMI_BASEURL |
Built-in domain |
Site domain for Shinigami. |
MAKI_SOURCE_MANHUAGUI_BASEURL |
Built-in domain |
Domain for Manhuagui. |
MAKI_SOURCE_OLYMPUS_BASEURL |
Built-in domain |
Domain for Olympus Scanlation. |
MAKI_SOURCE_CUUTRUYEN_BASEURL |
Built-in domain |
Domain for Cứu Truyện. |
MAKI_SOURCE_TEAMX_BASEURL |
Built-in domain |
Domain for Team-X. |
MAKI_SOURCE_MANGAWORLD_BASEURL |
Built-in domain |
Domain for MangaWorld. |
MAKI_SOURCE_MANGALIB_APIURL |
Built-in API host |
API host for MangaLib. |
These point a tracker at a different API or OAuth address. They exist so end-to-end tests can use mocks. Leave them unset.
| Variable |
Default |
What it does |
MAKI_SCROBBLE_ANILIST_API |
https://graphql.anilist.co |
AniList GraphQL endpoint. |
MAKI_SCROBBLE_ANILIST_OAUTH |
https://anilist.co/api/v2/oauth |
AniList OAuth endpoint. |
MAKI_SCROBBLE_MAL_API |
https://api.myanimelist.net/v2 |
MyAnimeList API. |
MAKI_SCROBBLE_MAL_OAUTH |
https://myanimelist.net/v1/oauth2 |
MyAnimeList OAuth endpoint. |
MAKI_SCROBBLE_KITSU_API |
https://kitsu.app/api/edge |
Kitsu API. |
MAKI_SCROBBLE_KITSU_OAUTH |
https://kitsu.app/api/oauth |
Kitsu OAuth endpoint. |
MAKI_SCROBBLE_MANGABAKA_API |
https://api.mangabaka.org |
MangaBaka API. |
MAKI_SCROBBLE_MANGAUPDATES_API |
https://api.mangaupdates.com/v1 |
MangaUpdates API. |