Skip to content

Environment variables

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.