Skip to content

Install and upgrade

They set the user and group the container runs as. Maki chowns /config to that user at startup but not your library folder, so the same user needs read and write access there. See Install with Docker Compose.

The local MangaBaka database (mangabaka.db, which Discover and metadata lookups read) is about 350 MB to download and 3.5 GB on disk. The first search by meaning adds about 110 MB for a memory-mapped copy of the search model (MAKI_EMBED_MMAP=0 turns that off). Plan for that on the drive holding /config, on top of your library. See Install with Docker Compose.

Yes. Maki writes plain CBZ files with ComicInfo.xml, so Kavita reads the same files, and your Maki tags go into ComicInfo’s SeriesGroup so Kavita can build collections from them. Add the folder to Maki under Settings → Library → Root folders. Optional read sync is under Settings → Reading → Kavita read sync.

Docker and Unraid updates are manual. The Windows app checks for and installs updates itself, and the Linux tarball does not update itself. Settings → System → Updates shows the steps for your install. With Docker Compose: docker compose pull, then docker compose up -d.

Migrations only move forward. Maki takes a backup before any upgrade that applies one, and that backup is your way back. If an older Maki starts on a newer database, the Health page says so. After an upgrade, Settings has a New tab listing the settings added since your last version. See Backup and restore.

I am upgrading from a single-user Maki. What happens to my account?

Section titled “I am upgrading from a single-user Maki. What happens to my account?”

The first page asks you to set a username and password. Your library, history and tracker connections are already attached to it. See Upgrading.

Yes. The Windows app runs from the tray and keeps its data in %LOCALAPPDATA%\Maki. The Linux tarballs for x64 and arm64 run as a plain program or as a systemd service. You can also build from source, which needs .NET 10 and Node 24, see the development guide. On Unraid, install from the Apps tab, see Unraid.