Frequently Asked Questions
I forgot my password
Either ask an admin to reset your password, or use the Command Line Interface to reset it by yourself.
Where can I find the log files?
By default (if you haven't changed the configuration), log files are located:
- on the Windows app:
- on the macOS app:
- on Windows:
- on macOS or Unix:
- on Docker: in the directory you mounted as
/config, in a subdirectory called
How to enable DEBUG or TRACE logs?
Add the following key in your
jar via the command line
jar with the following option:
java -jar komga-x.y.z.jar --logging.level.org.gotson.komga=DEBUG
java -jar komga-x.y.z.jar --logging.level.org.gotson.komga=TRACE
Add the following environment variable:
Komga seems slow, how can I check what's going on?
If any activity is going on, an animated yellow bar will appear below the top-left logo. Hover your cursor over the bar to see the details of all pending tasks.
The memory consumption is huge
TL;DR: The operating system does not report the real memory usage of the application, so don't look at those figures.
Komga runs on the Java Virtual Machine (JVM). The JVM works differently than other native programs in regard to memory consumption. On startup, the JVM will reserve some memory from the OS, but that doesn't mean this memory is used by the application. If the OS needs to reclaim that memory, the JVM will try to release it.
By default, the JVM would reserve 1/4th of the physical memory (depends on the total memory and JVM version), for instance if you have 32 Gb of memory, the JVM would reserve 8 Gb.
How can I sync reading progress with tracker websites?
Komga does not support this outside the box.
You can try MAL-Sync which integrates with Komga and works with MyAnimeList, Kitsu, Anilist and others.
Webreader double pages are not showing as single page
The double pages feature of the webreader requires image sizes to be available. This feature was added in v
0.51.0. If your books have been analyzed before that version, you will need to re-analyze them in order for the double pages feature to work properly.
Media type application/x-7z-compressed is not supported
Your files are compressed using 7zip, which is not supported. Extract your archives and compress them again using the
My books/series show a different name than the files/folders
Komga automatically import metadata from
EPUB files and from
cbr. The imported metadata will override the file/folder name.
This server has already been claimed
The server cannot be claimed if a user already exists in the database. It can happen when you start Komga for the first time without the
claim profile as Komga will generate a default user.
You can solve the issue by deleting the database. By default it is located in
~ is your home directory on Unix, and your User profile on Windows.
How can I move a library to a different folder?
You can follow those steps:
- Make sure File Hashing is enabled on the library.
- Disable automatically emptying the trash for the library.
- Perform a scan on the library and let all tasks finish. This will ensure all files are hashed.
- Stop Komga.
- Move/copy the files to the new folder.
- Start Komga.
- Edit the library and choose the new folder as the library root directory.
- A scan will be triggered automatically after saving the library. The scan could take some time depending on the size of the library.
- Once the scan is finished, the series and books should have been matched with the files in the new folder.
Scan doesn't pick up new files under mergerfs
func.getattr=newest to the options in your
/etc/fstab entry for the mergerfs volume. By default, mergerfs doesn't update the modified times for everything for performance reasons. This forces it to. In most cases the performance impact is negligible.
/media/user/disk* /media/user/storage fuse.mergerfs defaults,nonempty,allow_other,use_ino,cache.files=off,moveonenospc=true,dropcacheonclose=true,minfreespace=50G,category.create=mfs,func.getattr=newest,fsname=mergerfs 0 0
Docker on Raspberry PI arm32: No monotonic clock was available
If you encounter the following message when starting the container:
OpenJDK Server VM warning: No monotonic clock was available - timed services may be adversely affected if the time-of-day clock changes
Your host system needs to have installed:
- Docker version
- libseccomp version