Settings Key Reference
generated 2026-04-03T13:42:03.3344072ZDashboardHelpCatalog keys: 14Unknown DB keys: 79
Drift: settings present in DB but not in catalog (still honored, but not documented here):
app.port.host, autotune.enabled, autotune.eval_window_s, autotune.interval_min, autotune.unsafe, autotune_enabled, category_throttle.adaptive_auto_switch_enabled, category_throttle.adaptive_profile, category_throttle.delete_downloading_low_ratio_minutes, category_throttle.delete_downloading_low_ratio_threshold, category_throttle.delete_downloading_min_seeds, category_throttle.delete_downloading_under_completed_pct, category_throttle.delete_enabled, category_throttle.delete_error_confirmed, category_throttle.delete_error_enabled, category_throttle.delete_error_minutes, category_throttle.delete_exempt_categories_json, category_throttle.delete_files_confirmed, category_throttle.delete_files_enabled, category_throttle.delete_min_active_torrents, category_throttle.delete_min_upload_bps, category_throttle.delete_slow_upload_minutes, category_throttle.delete_stalled_minutes, category_throttle.delete_zero_upload_minutes, category_throttle.efficiency_alert, category_throttle.enabled, category_throttle.exempt_categories_json, category_throttle.halflife_enabled, category_throttle.halflife_weight, category_throttle.interval_seconds, category_throttle.limited_allow_bps, category_throttle.limited_categories_json, category_throttle.limited_category, category_throttle.limited_release_bps, category_throttle.limit_bytes, category_throttle.off_grace_seconds, category_throttle.on_grace_seconds, category_throttle.primary_categories_json, category_throttle.primary_category, category_throttle.primary_health_grace_seconds, category_throttle.primary_metric, category_throttle.primary_min_bps, category_throttle.primary_min_percent, category_throttle.priority_category, category_throttle.strategy, category_throttle.switching_enabled, category_throttle.switching_sensitivity, delete.protect_large_torrents_enabled, key, network.reflector_mode, network.reflector_port, network.reflector_public_base_url, network.reflector_timeout_ms, network.reflector_worker_base_url, qb_pass, racing.min_up_bps_to_keep, rag.ai.ollama.base_url, rag.ai.ollama.model, rag.ai.provider, rag.forum.auto_interval_minutes, rag.llm.provider, rag.ollama.base_url, rag.ollama.model, rag.wiki.auto_interval_minutes, ratio_tuning.cap_bps, ratio_tuning.cooldown_s, ratio_tuning.enabled, ratio_tuning.max_targets, ratio_tuning.min_dl_bps, ratio_tuning.mode, ratio_tuning.model, ratio_tuning.peer_block_enabled, removed.capture_manual, restricted.overrides, timezone, trackers.torrentleech.cookie, trackers.torrentleech.profile, ui.time_format, value
| Subsystem | Key | Type | Default | Current | Source | UI | Description |
|---|
| Core | public_dashboard.enabled | bool | False | 1 | db | public-dashboard-enabled (checkbox) | Enables the read-only guest dashboard on the public listener. Enable/disable is enforced in the request pipeline (instant, no restart). |
| Core | public_dashboard.port | int | 9101 | | default | public-dashboard-port (number) | Port number for the public (guest) dashboard listener. Changing this requires an app restart (socket binding). |
| Core | signalr.poll_seconds | int | 1 | | default | poll-seconds (number) | How often the backend polls qBittorrent for session + torrents state. Lower = more real-time; higher = lower load. |
| Core | ui.timezone | string | UTC | America/Indiana/Indianapolis | db | timezone (select) | Timezone used for bucket alignment and labels (UTC at rest; shifted at query/render time). |
| PeerBlock | peerblock.enabled | bool | False | | default | peerblock-enabled (checkbox) | Enables the persistent peer blocking subsystem. When enabled, peer blocks are re-applied after restarts via peer_blocks.db. |
| Racing | racing.burst_trigger_up_bps | long | 250000 | | default | racing-burst-trigger (number) | Burst mode engages when the winner's upload speed meets or exceeds this threshold. |
| Racing | racing.down_penalty | double | 0.25 | | default | racing-down-penalty (number) | Racing score favors upload but penalizes download: score = up_speed - (down_penalty * down_speed). |
| Racing | racing.dump_action | string | delete_filesystem | delete_filesystem | db | racing-dump-action (select) | What to do with dumped torrents: pause or delete from client + filesystem. Recommended for racing is delete_filesystem. |
| Racing | racing.early_window_seconds | int | 120 | | default | racing-early-window (number) | Only torrents whose added_on age is within this window are considered for racing decisions. |
| Racing | racing.enabled | bool | True | 1 | db | racing-enabled (checkbox) | Turns on the early-swarm pump-and-dump controller. This subsystem focuses upload into the most promising torrent(s) and dumps bad performers. |
| Racing | racing.max_active | int | 2 | 2 | db | racing-max-active (number) | Admission control: maximum number of torrents to allow into the early-window racing set. |
| Racing | racing.nonwinner_up_cap_bps | long | 150000 | 10485760 | db | racing-nonwinner-up-cap (number) | During burst focus, non-winners are capped to this upload rate to concentrate upload into the selected winner. |
| Racing | racing.post_down_cap_bps | long | 1000000 | 10000000 | db | racing-post-down-cap (number) | After the early window, apply a conservative download cap to avoid wasting bandwidth (if enabled). |
| Racing | racing.ramp_down_cap_bps | long | 0 | 0 | db | racing-ramp-down-cap (number) | Optional download cap applied during the early window. 0 means unlimited. |