First-run setup
The Windows app opens Maki in your browser the first time it starts. It only listens on this computer until you turn on Allow other devices on your network under Settings → System → Network.
1. Create the administrator account
Section titled “1. Create the administrator account”Open Maki in your browser, for example http://localhost:8990. A new install has no users, so the
first screen is Create your account. The password needs at least 10 characters, with no symbol
rules.
This account is the administrator. Add more people later from the users section of Settings.
The screen also has a short checklist for public installs: HTTPS, the trusted proxy setting and two-factor sign-in. See Reverse proxy and HTTPS before you expose Maki outside your network.
2. Work through the setup guide
Section titled “2. Work through the setup guide”The setup guide opens after the account is created. It has six steps:
- Welcome. Pick the interface language. Appearance is saved on this device only.
- Library. Add your library folders, then choose what Maki does with folders it finds: rename
them to Maki’s standard, or keep their names and download into them or into a new folder. Two
more switches write ComicInfo.xml into imported files and save a
cover.jpginto each series folder. - Discover. Shows the status of the local MangaBaka database. Also sets Recommendations and search by description and the most explicit content rating Discover may show outside your own library.
- Downloads. Pick the languages Maki looks for and which chapters it skips.
- Connections. Optional. Add tools you already run, such as FlareSolverr, Kavita, an indexer or a download client. Maki downloads from its built-in sources without any of them.
- Finish. A summary, and links to add a series, import what you have, connect trackers or invite people.
Every change saves as you go. Each setting is also in Settings afterwards, and you can reopen the guide from the top of Settings.
3. Add a library folder
Section titled “3. Add a library folder”In the Library step, enter the path as Maki sees it in Folder path. In Docker that is
/library, the container path from the compose file. On the Windows app it is a Windows path, such
as C:\Manga. To pick a folder instead of typing one, choose Browse to open a folder browser for
the server.
Maki shows the free space on each folder. If a row says Maki can’t reach this folder, check the mount and the permissions. See Volumes, PUID and PGID.
Removing a root folder does not touch the files on disk. It does remove every user’s access to that folder.
If a share is re-mounted or the library moves to new storage later, use the edit button on the root folder under Settings → Library → Root folders instead of adding a new one. It checks the new path and counts the series folders it finds there before saving, and it never moves files.
4. Wait for the MangaBaka database
Section titled “4. Wait for the MangaBaka database”Series details and search come from a local copy of the MangaBaka database, about 350 MB to download and 3.5 GB on disk. Maki downloads it in the background, and the Discover step shows its progress.
Until it is installed, Maki shows Getting the metadata database ready. It opens by itself when the download finishes, so you do not need to refresh.
- An administrator sees the progress, with Open settings and Open health for when a download fails.
- Other users see a waiting screen, or a message saying the download failed and is retried on its own.
- Reading apps connected over OPDS, Komga or KOReader keep working while you wait.
The setup guide does not finish until the database is installed.