Configuration

Configuration

indexarr.json holds the startup settings; everything else lives in the database and is changed from the Settings page. This page lists the file and every setting with its default.

The file

indexarr.json contains only the startup settings:

{
  "listen": ":8788",
  "db_path": "indexarr.db",
  "log_level": "info",
  "vault_key_path": "",
  "memory_limit_mb": 64,
  "log_file": "logs/indexarr.log",
  "log_max_mb": 10,
  "log_max_files": 5
}

A relative db_path is resolved against the directory of the configuration file. vault_key_path is optional: if empty the vault key is looked up in INDEXARR_MASTER_KEY, INDEXARR_MASTER_KEY_FILE, legacy <db>.key (if it exists) and then os.UserConfigDir()/indexarr/master.key. A relative path is resolved against the directory of indexarr.json. Details, vault export-key / vault move-key commands, backups and Docker secrets in Vault.

log_file is the rotating log file (relative like db_path; "off" turns it off): when it exceeds log_max_mb it becomes indexarr.log.1, older files shift and log_max_files files in total are kept. An old configuration file without these fields uses the defaults.

Main settings

Setting	Default	Meaning
default_interval_seconds	3600	Interval of sources without their own
fetch_timeout_seconds	45	Timeout for each HTTP request
workers	2	Sources run in parallel (requires restart)
max_torrents_per_run	30	Limit of .torrent files downloaded per run
max_torrent_bytes	8 MiB	Maximum size of a .torrent
fetch_torrents	on	Downloads .torrent files when the source only offers a link
retention_days	0	Deletes releases no longer seen after N days (0 = never)
public_url	empty	Public URL for Torznab links behind a reverse proxy
notify_*	—	Notification channels and triggers
auto_disable_after	0	Disables a source after N consecutive errors (0 = never)
flaresolverr_url	empty	FlareSolverr endpoint for RSS and direct indexers
torznab_download_factor	0	downloadvolumefactor (0 = freeleech)
torznab_upload_factor	1	uploadvolumefactor
api_rate_limit_per_minute	0	Requests per API key per minute (0 = unlimited)
flaresolverr_timeout_seconds	60	Time FlareSolverr may spend on one Cloudflare check
torznab_live_search	on	Queries the indexers live on every search with a query
torznab_live_timeout_seconds	20	Overall deadline of the live search
torznab_live_wait_seconds	5	How long the answer waits for the live results; late indexers finish in the background
torznab_live_cache_seconds	300	How long a live result stays cached (0 = off)
torznab_proxy_magnets	off	Magnet grabs go through indexarr and are recorded in Statistics → Downloads
torznab_proxy_ed2k	on	eD2k grabs go through indexarr; the direct link stays in the ed2k attribute
host_rate / host_burst	1 / 4	Requests per second per host, shared by all indexers, and initial burst
breaker_threshold	5	Consecutive failures before a host is paused
breaker_cooldown	600 s	Pause after repeated failures or a 429/503 without Retry-After
seeders_ttl_hours	6	Age of the seeders before they are refreshed
history_retention_days	30	Retention of run metrics, app searches and samples (0 = forever)
stored_source_limit	3	Soft limit of search-only sites whose results are stored (warning only)
stored_retention_days	90	Retention of releases that came only from those sites (0 = forever)
download_client	none	Legacy client; modern clients are on the App page
backup_enabled	on	Automatic database backup
backup_interval_hours	24	Interval of automatic backups (6–168)
backup_keep	7	Number of automatic backups kept (1–60)
log_level	config	Runtime level (debug, info, warn, error)
memory_limit_mb	config	Soft Go memory limit in MiB (0 disables it)

---

Part of the indexarr documentation.