Install with Docker Compose
Maki publishes an image for amd64 and arm64 at ghcr.io/orbitmpgh/maki:latest.
Create the compose file
Section titled “Create the compose file”services: maki: image: ghcr.io/orbitmpgh/maki:latest container_name: maki environment: - PUID=1000 - PGID=1000 volumes: - ./maki-config:/config - /path/to/manga-library:/library ports: - "8990:8990" mem_reservation: 512m restart: unless-stoppeddocker run -d --name maki \ -e PUID=1000 -e PGID=1000 \ -v ./maki-config:/config \ -v /path/to/manga-library:/library \ -p 8990:8990 \ --memory-reservation 512m \ --restart unless-stopped \ ghcr.io/orbitmpgh/maki:latestPaste the compose file from the first tab into a Portainer stack, or into a Synology Container Manager project. Map
/config and /library to shared folders that the PUID:PGID user can write to.
PUID and PGID set the user the container runs as. Maki fixes the ownership of /config on every
start but never touches /library, so that user needs write access to your library folder already. See Volumes, PUID and PGID.
Open Maki
Section titled “Open Maki”- Run
docker compose up -d, openhttp://localhost:8990and create the administrator account. - The setup guide opens next. Add
/libraryas a library folder there. Maki downloads the local MangaBaka database in the background (about 350 MB, 3.5 GB on disk) and finishes opening once it is installed. - Continue with Add your first series.
Memory
Section titled “Memory”mem_reservation is a soft limit: when the host runs short of memory, the kernel takes Maki’s file
cache back first. Most dashboards count that cache as the container’s memory, so without a
reservation Maki can look much bigger than it is.
Don’t set a hard mem_limit below 1.5 GB yet, since a scrape and a search running together can
briefly need close to 1 GB.
Optional companions
Section titled “Optional companions”The compose file for Kavita, FlareSolverr and Suwayomi, and where each is connected in Maki, is on Kavita, FlareSolverr and Suwayomi.
- Upgrading, including going back after a bad upgrade.
- Offline reading and push notifications need HTTPS. See Reverse proxy and HTTPS.