Skip to main content

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: %LOCALAPPDATA%/Komga/logs/komga.log
  • on the macOS app: ~/Library/Logs/Komga/komga.log
  • on Windows: %USERPROFILE%/.komga/komga.log
  • on macOS or Unix: ~/.komga/komga.log
  • on Docker: in the directory you mounted as /config, in a subdirectory called logs

How to enable DEBUG or TRACE logs?​

Via an application.yml​

Add the following key in your application.yml:

logging.level.org.gotson.komga: DEBUG

or

logging.level.org.gotson.komga: TRACE

Using the jar via the command line​

Start the jar with the following option:

java -jar komga-x.y.z.jar --logging.level.org.gotson.komga=DEBUG

or

java -jar komga-x.y.z.jar --logging.level.org.gotson.komga=TRACE

Using Docker​

Add the following environment variable:

LOGGING_LEVEL_ORG_GOTSON_KOMGA=DEBUG

or

LOGGING_LEVEL_ORG_GOTSON_KOMGA=TRACE

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.

To increase or limit the maximum memory, see here (jar) and here (Docker).

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 v0.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 zip format.

My books/series show a different name than the files/folders​

Komga automatically import metadata from EPUB files and from ComicInfo.xml for cbz/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 ~/.komga/database.sqlite. ~ 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:

  1. Make sure File Hashing is enabled on the library.
  2. Disable automatically emptying the trash for the library.
  3. Perform a scan on the library and let all tasks finish. This will ensure all files are hashed.
  4. Stop Komga.
  5. Move/copy the files to the new folder.
  6. Start Komga.
  7. Edit the library and choose the new folder as the library root directory.
  8. A scan will be triggered automatically after saving the library. The scan could take some time depending on the size of the library.
  9. 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​

Add 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.

Example:

/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 19.03.9 or newer
  • libseccomp version 2.4.2 or newer