Configuration
Overview of Comicarr settings, config file structure, and credential encryption.
All Comicarr settings are stored in config.ini inside your config directory and managed through the Settings page in the web UI. You rarely need to edit the file by hand -- the UI writes changes back to config.ini automatically on save.
Settings are accessed internally via comicarr.CONFIG.option_name.
Config File Location
The default location depends on how you deployed Comicarr:
| Deployment | Path |
|---|---|
| Docker | /config/config.ini (mapped volume) |
| Manual | ~/.comicarr/config.ini or the path passed with --datadir |
Credential Encryption
Comicarr encrypts sensitive values (passwords, API keys) at rest using Fernet symmetric encryption.
How to identify encrypted values
Encrypted values in config.ini always start with the prefix gAAAAA. If you see a value beginning with this string, it is encrypted and will be decrypted transparently at runtime.
Master Key
A master encryption key is stored in your secure directory:
<config_dir>/secure/master.keyThe file is created automatically on first run with 0600 permissions (owner read/write only). If you move your config directory to a new machine, you must copy master.key alongside config.ini or encrypted values will be unreadable.
Do not delete master.key
Losing this file means all encrypted credentials in config.ini must be re-entered through the UI.
Configuration Sections
General
Library paths, file naming, scheduling, logging, and backup.
Download Clients
SABnzbd, NZBGet, and NZB blackhole settings.
Torrent Clients
qBittorrent, Deluge, Transmission, rTorrent, and uTorrent.
Direct Downloads
GetComics, DDL, FlareSolverr, and proxy settings.
Search Providers
Newznab, Torznab, retention, and provider priority.
Metadata
ComicVine, Metron, and comic tagging configuration.
Post-Processing
File handling, scripts, and check folder setup.
Notifications
Discord, Telegram, Slack, email, and 8 more providers.
Authentication
Login methods, API keys, rate limiting, and password storage.