Configuration
Overview of Comicarr settings, config file structure, and credential encryption.
All Comicarr settings are stored in config.ini inside your data directory. The web Settings page edits a growing subset of options; the rest (most download clients, OPDS, library paths) are configured by editing config.ini directly and restarting when required.
Settings are accessed internally via comicarr.CONFIG.option_name.
Config File Location
| Deployment | Path |
|---|---|
| Docker | /config/comicarr/config.ini (entrypoint sets --datadir /config/comicarr) |
| Manual | <datadir>/config.ini, which defaults to the application directory unless you pass --datadir |
UI vs config.ini
| Configured in the web UI | config.ini only |
|---|---|
| ComicVine / Metron / MangaDex / MAL keys | NZBGet and blackhole connection details |
| Comicarr API key (regenerate) | Torrent client hosts, ports, credentials |
| Newznab and Torznab indexers: add, edit, enable (Search tab, Torznab since v0.33.0) | |
| NZB client selection, plus SABnzbd URL, API key, category, directory, and TLS verification (Download clients tab) | OPDS enablement and credentials |
| Notifications | Many scheduler and advanced path options |
| AI (BYOK) | Library destination paths (shown read-only in UI) |
| Quality / size filters (Search tab) | 32P, seedbox, and AutoSnatch |
| Log level and log viewer (Logs tab) | |
| Support bundle (About tab) |
Some settings are per-series instead of global, and they live only in the UI on the series detail page: Search options (Allow packs, Ignore book type) and the comic/manga classification. Manga series add two more: the search mode (blended / volumes / chapters) and the bare-number interpretation (auto / volumes / chapters). See Manga.
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:
<data_dir>/.secure/master.keyOn Docker, that is typically /config/comicarr/.secure/master.key.
The file is created automatically on first run with restrictive permissions. If you move your data directory to a new machine, you must copy .secure/ (or at least 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 or config file.
Configuration Sections
General
Library paths, file naming, scheduling, logging, and backup.
AI
AI provider, rate limits, and circuit breaker settings.
Download Clients
SABnzbd, NZBGet, and NZB blackhole settings.
Torrent Clients
qBittorrent, Deluge, Transmission, rTorrent, and uTorrent.
Direct Downloads
GetComics, DDL, FlareSolverr, and proxy settings.
Advanced Sources
32P, seedbox, and AutoSnatch (config.ini).
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.
Database
SQLite, PostgreSQL, and MySQL backends.