Troubleshooting

Common Issues

Docker permission errors

Files created by Comicarr are owned by the wrong user, or the container fails to start with permission errors.

Cause: The PUID and PGID environment variables do not match the owner of your mounted volumes.

Fix: Run id on the host and set the values in your docker-compose.yml:

id
# uid=1000(user) gid=1000(user)

environment:
  - PUID=1000
  - PGID=1000

Recreate the container after changing these values.

ComicVine API rate limiting

Metadata lookups fail or return errors when adding multiple series.

Cause: ComicVine enforces rate limits. The default CVAPI_RATE is 2 requests per second.

Fix:

• Reduce CV_MAX_PARALLEL_REQUESTS in Settings > ComicVine
• Enable ComicVine response caching to avoid redundant requests
• Space out bulk additions rather than adding many series at once

Download client connection failures

Comicarr cannot reach SABnzbd, NZBGet, or a torrent client.

Fix:

• Verify the host, port, and credentials in Settings > Download Client
• If both services run in Docker, use the container name as the hostname (e.g., sabnzbd instead of localhost)
• Check that the containers are on the same Docker network
• Test connectivity from inside the Comicarr container:

  docker exec comicarr curl -s http://sabnzbd:8080

Encrypted credentials after config restore

After restoring a config.ini backup, credentials fail to decrypt.

Cause: Encrypted values (prefixed with gAAAAA) are tied to the master key in secure/master.key. If the key file does not match, decryption fails.

Fix: Copy master.key alongside config.ini when migrating or restoring. If the key is lost, re-enter all credentials through the Settings UI -- they will be re-encrypted with the new key.

Search returning no results

Automatic or manual searches find nothing for series that should have results.

Fix:

• Verify provider configuration in Settings > Search Providers
• Confirm API keys are valid for each provider
• Check USENET_RETENTION (default: 3500 days) -- reduce if your provider has shorter retention
• Review PROVIDER_ORDER to ensure your preferred providers are enabled and prioritized
• Check the logs in Settings > Logs for provider-specific errors

Post-processing failures

Downloaded files are not moved or renamed after download completes.

Fix:

• Verify path permissions: the container user (PUID/PGID) must have write access to both /downloads and /comics
• Check that DESTINATION_DIR is set and writable
• Review logs in LOG_DIR for specific error messages
• Ensure the download client reports the correct download path inside the container

Migration issues

The Mylar3 migration fails or reports errors.

Fix:

• Verify mylar.db is mounted and accessible inside the container at the expected path
• Check file permissions: the container user must be able to read mylar.db
• Run a preview migration first to identify problems before executing
• Check the Comicarr logs for specific table errors

FlareSolverr not working

Direct download providers that require JavaScript rendering fail.

Fix:

• Verify ENABLE_FLARESOLVERR is set to True in Settings > Direct Downloads
• Confirm FLARESOLVERR_URL is reachable from the Comicarr container (e.g., http://flaresolverr:8191)
• Check that the FlareSolverr container is running:

  docker logs flaresolverr

FAQ

Where is the config stored?

/config/config.ini inside the container, mapped to your host via the Docker volume mount. With manual installation, the default is ~/.comicarr/config.ini or the path specified with --datadir.

How do I reset my password?

Delete the HTTP_USERNAME and HTTP_PASSWORD entries from the [General] section in config.ini, then restart Comicarr. You will be prompted to create new credentials on next login.

What is the default port?

8090. Change it with the HTTP_PORT setting in config.ini or by mapping a different host port in Docker.

Does Comicarr support CBR files?

Yes. Comicarr can read CBR files natively. If you prefer CBZ format, enable CBR2CBZ_ONLY in Settings > General to automatically convert CBR files to CBZ during post-processing.

How do I enable the API?

Set API_ENABLED=True and configure an API_KEY in Settings > General. See the API documentation for usage details.