Install and upgrade
What do PUID and PGID do?
Section titled “What do PUID and PGID do?”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.
How much disk space does Maki need?
Section titled “How much disk space does Maki need?”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.
Can I use my existing Kavita library?
Section titled “Can I use my existing Kavita library?”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.
How do I upgrade?
Section titled “How do I upgrade?”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.
Does an upgrade change my data?
Section titled “Does an upgrade change my data?”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.
Can I run Maki without Docker?
Section titled “Can I run Maki without Docker?”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.