Gmer4Lfe
0447fa6f86
Comments asserting a partner is down, being rebuilt or not yet installed are true on the day they are written and wrong afterwards, and nothing prompts anyone to revisit them. Behaviour is described generically; current state belongs in operator memory, not in tracked files.
113 KiB
113 KiB
Where every setting lives in the web UI
Generated by Tools/ui_map_build.php — do not edit by hand.
Every setting below can be changed in the browser. Nothing here needs a conf file opened over SSH, and the routes are what to tell someone who asks where a setting is.
Two surfaces show settings, and which one holds a given section depends on what the section is about:
- The Scheduler tab shows the settings belonging to one script. Pick the script, open Config, and its sections appear there.
- The AI tab shows the AI sections together under Settings → Configuration.
Both write through the same guarded path: the change is validated, the conf is backed up, the result is syntax-checked and read back, and a bad write is rolled back.
A setting is edited by finding its row and changing the control described below. The Save button sends only what was actually changed.
When someone asks where a setting is, answer with the route. Every setting here has a control in the browser, so the conf file it lands in is background rather than an instruction — telling someone to edit the file by hand is the wrong answer when a switch exists, and it is also the riskier one. The exception is the list at the very bottom: those settings genuinely have no control, and saying so is the right answer.
Arr Recovery Toggles
Reachable from:
- Scheduler tab → Arrs Failed Stalled Recovery → Config → Arr Recovery Toggles
- Media Stack tab → Media settings → Arr Recovery Toggles
- Settings tab → All settings → Arr Recovery Toggles
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_LIDARR_RECOVERY |
a switch | in this section | HOST1 only — exits cleanly on HOST2 |
HOST1_SONARR_RECOVERY |
a switch | in this section | — |
HOST1_RADARR_RECOVERY |
a switch | in this section | — |
Authelia
Reachable from:
- Auth tab → Auth settings → Authelia
- Settings tab → All settings → Authelia
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_AUTHELIA_CONFIG |
a text box | in this section | — |
HOST1_AUTHELIA_CONTAINER |
a text box | in this section | — |
Backup Verify
Reachable from:
- Scheduler tab → Backup Verify → Config → Backup Verify
- Settings tab → All settings → Backup Verify
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_BACKUP_VERIFY_SHARES |
a list, one entry per line | in this section | Leave empty to use HOST1_DAILY_SYNC_SHARES automatically. |
Bug Reports
Route: Settings tab → All settings → Bug Reports
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_BUG_REPORT_URL |
a text box | in this section | e.g. http://gitea:3000 or the tailnet name |
HOST1_BUG_REPORT_REPO |
a text box | in this section | owner/repo |
HOST1_BUG_REPORT_TOKEN |
a masked box with a Show button | in this section | Gitea API token with issue-write on that repo |
Certificate Monitor
Reachable from:
- Scheduler tab → Cert Monitor → Config → Certificate Monitor
- Scheduler tab → Weekly Health Digest → Config → Certificate Monitor
- Auth tab → Auth settings → Certificate Monitor
- Settings tab → All settings → Certificate Monitor
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_CERT_MONITOR_DOMAINS |
a list, one entry per line | in this section | — |
Corruption Scan
Reachable from:
- Scheduler tab → Arr Corruption Scan → Config → Corruption Scan
- Settings tab → All settings → Corruption Scan
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_FFPROBE_CONTAINER |
a text box | in this section | — |
HOST1_FFPROBE_BIN |
a text box | in this section | — |
HOST1_FFPROBE_PATH_MAP |
a list, one entry per line | in this section | — |
Critical Sync Shares
Reachable from:
- Scheduler tab → Critical Sync Maintenance → Config → Critical Sync Shares
- Settings tab → All settings → Critical Sync Shares
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_CRITICAL_SYNC_SHARES |
a list, one entry per line | in this section | Appdata shares synced every 30 minutes. Format: "/path/to/share" or "/path/to/share|profile-name" |
DDNS
Reachable from:
- Scheduler tab → Fallback → Config → DDNS
- Settings tab → All settings → DDNS
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_DDNS_CONTAINERS |
a list, one entry per line | in this section | DDNS containers this host manages. |
Daily Sync Shares
Reachable from:
- Scheduler tab → Daily Sync Maintenance → Config → Daily Sync Shares
- Settings tab → All settings → Daily Sync Shares
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_DAILY_SYNC_SHARES |
a list, one entry per line | in this section | Media shares this host pushes to all other nodes every night. Uses DEFAULT_RSYNC_OPTS from master.conf — no profile needed. |
Docker Daily Restart
Reachable from:
- Scheduler tab → Docker Daily Restart → Config → Docker Daily Restart
- Docker tab → Docker settings → Docker Daily Restart
- Settings tab → All settings → Docker Daily Restart
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_DAILY_RESTART_CONTAINERS |
a list, one entry per line | in this section | — |
Docker Network Connect
Reachable from:
- Scheduler tab → Docker Network Connect → Config → Docker Network Connect
- Docker tab → Docker settings → Docker Network Connect
- Settings tab → All settings → Docker Network Connect
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_NETWORK_CONNECT_CONTAINERS |
a list, one entry per line | in this section | — |
HOST1_NETWORK_CONNECT_NETWORKS |
a list, one entry per line | in this section | — |
Docker Watchdog
Reachable from:
- Scheduler tab → Docker Watchdog → Config → Docker Watchdog
- Watchdog tab → Watchdog settings → Docker Watchdog
- Docker tab → Docker settings → Docker Watchdog
- Settings tab → All settings → Docker Watchdog
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_WATCHDOG_CONTAINERS |
a list, one entry per line | in this section | Memory hard limits in MB — immediate restart if exceeded. 20GB=20480 16GB=16384 8GB=8192 4GB=4096 2GB=2048 1GB=1024 |
HOST1_WATCHDOG_CONTAINER_URLS |
a list, one entry per line | in this section | HTTP health check URLs — checked every cycle. |
HOST1_WATCHDOG_CONTAINER_API_CHECKS |
a list, one entry per line | in this section | API-level health checks — catches HTTP-200-but-internally-frozen containers (DB lock, deadlocked thread, etc.) that a basic HTTP check above would miss. Pick an endpoint that forces a real DB round-trip — a lightweight status endpoint may stay 200 even while the rest of the app is locked up. Format: ["ContainerName"]="url|APIKey" |
HOST1_WATCHDOG_REQUIRED_CONTAINERS |
a list, one entry per line | in this section | Required containers — must always be running. |
HOST1_WATCHDOG_SCAN_IGNORE |
a list, one entry per line | in this section | Containers to skip in Tier 2 global scan. |
HOST1_WATCHDOG_DEPENDENCIES |
a list, one entry per line | in this section | Dependency ordering — skip restarting a container if its dependency is also down. |
HOST1_WATCHDOG_APPDATA_SIZES |
a list, one entry per line | in this section | Per-container appdata growth suppress ceilings in MB. |
Docker Weekly Restart
Reachable from:
- Scheduler tab → Docker Weekly Restart → Config → Docker Weekly Restart
- Docker tab → Docker settings → Docker Weekly Restart
- Settings tab → All settings → Docker Weekly Restart
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_WEEKLY_RESTART_CONTAINERS |
a list, one entry per line | in this section | — |
Downloaders
Reachable from:
- Scheduler tab → Downloaders Reset → Config → Downloaders
- Scheduler tab → Resource Watchdog → Config → Downloaders
- Settings tab → All settings → Downloaders
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_SLSKD_URL |
a text box | in this section | — |
HOST1_SLSKD_API_KEY |
a masked box with a Show button | in this section | — |
HOST1_SLSKD_FAILED_IMPORTS_DIR |
a text box | in this section | — |
HOST1_SABNZBD_URL |
a text box | in this section | — |
HOST1_SABNZBD_API_KEY |
a masked box with a Show button | in this section | — |
HOST1_QBIT_URL |
a text box | in this section | — |
HOST1_QBIT_USERNAME |
a text box | in this section | — |
HOST1_QBIT_PASSWORD |
a masked box with a Show button | in this section | — |
Emby
Reachable from:
- Scheduler tab → Emby Session Report → Config → Emby
- Scheduler tab → Server Reboot → Config → Emby
- Scheduler tab → Playback Aware Lidarr Discovery → Config → Emby
- Scheduler tab → Playback Aware Radarr Discovery → Config → Emby
- Scheduler tab → Playback Aware Sonarr Discovery → Config → Emby
- Scheduler tab → Emby To Lidarr Sync → Config → Emby
- Scheduler tab → Emby To Radarr Sync → Config → Emby
- Scheduler tab → Emby To Sonarr Sync → Config → Emby
- Scheduler tab → Emby Database Repair → Config → Emby
- Media Stack tab → Media settings → Emby
- Settings tab → All settings → Emby
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_EMBY_CONTAINER |
a text box | in this section | — |
HOST1_EMBY_URL |
a text box | in this section | — |
HOST1_EMBY_API_KEY |
a masked box with a Show button | in this section | — |
Fallback Tiers — What HOST1 Wants Covered When Down
Reachable from:
- Fallback tab → Fallback settings → Fallback Tiers — What HOST1 Wants Covered When Down
- Settings tab → All settings → Fallback Tiers — What HOST1 Wants Covered When Down
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
FALLBACK_HOST1_TIER1 |
a list, one entry per line | in this section | Containers the partner starts for HOST1 when HOST1 goes down. Tier 1 is always immediate. Higher tiers activate after HOST1_TIER*_DELAY minutes. |
FALLBACK_HOST1_TIER2 |
a list, one entry per line | in this section | — |
FALLBACK_HOST1_TIER3 |
a list, one entry per line | in this section | — |
FALLBACK_HOST1_TIER4 |
a list, one entry per line | in this section | — |
Gitea
Route: Settings tab → All settings → Gitea
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_GITEA_API_TOKEN |
a masked box with a Show button | in this section | Personal access token for gitea_ssh_setup.sh. Create in Gitea: Settings → Applications → Generate Token → scope: write:user |
Identity
Route: Settings tab → All settings → Identity
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_SSH_KEY |
a masked box with a Show button | in this section | HOST1 host1ame lives in master.conf (not a credential — safe for all servers). SSH key used for all server-to-server operations — rsync, failover, conf sync. Convention: /root/.ssh/_rsync_automation Must be in /root/.ssh/ and authorised in the partner's /root/.ssh/authorized_keys. Run Partnership/ssh_setup.sh to generate the key and copy it to the partner. |
HOST1_STORAGE_PATH |
a text box | in this section | — |
HOST1_OWNER |
a text box | in this section | — |
HOST1_OWNER_EMAIL |
a text box | in this section | — |
Intermediate Sync Shares
Reachable from:
- Scheduler tab → Intermediate Sync Maintenance → Config → Intermediate Sync Shares
- Settings tab → All settings → Intermediate Sync Shares
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_INTERMEDIATE_SYNC_SHARES |
a list, one entry per line | in this section | Shares synced every 4 hours. Leave empty to skip mid-day rsync. |
Internet Loss
Reachable from:
- Scheduler tab → Fallback → Config → Internet Loss
- Settings tab → All settings → Internet Loss
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
FALLBACK_HOST1_STOP_ON_NO_NET |
a list, one entry per line | in this section | Containers stopped immediately when internet is lost. |
Jellyfin
Reachable from:
- Media Stack tab → Media settings → Jellyfin
- Settings tab → All settings → Jellyfin
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_JELLYFIN_CONTAINER |
a text box | in this section | — |
HOST1_JELLYFIN_URL |
a text box | in this section | — |
HOST1_JELLYFIN_API_KEY |
a masked box with a Show button | in this section | — |
Lidarr
Reachable from:
- Scheduler tab → Lidarr Cleanup → Config → Lidarr
- Scheduler tab → Lidarr Missing Art → Config → Lidarr
- Scheduler tab → Lidarr Release Fixer → Config → Lidarr
- Scheduler tab → Lidarr Duplicate Artist Cleanup → Config → Lidarr
- Scheduler tab → Playback Aware Lidarr Discovery → Config → Lidarr
- Scheduler tab → Emby To Lidarr Sync → Config → Lidarr
- Media Stack tab → Media settings → Lidarr
- Settings tab → All settings → Lidarr
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_LIDARR_URL |
a text box | in this section | — |
HOST1_LIDARR_API_KEY |
a masked box with a Show button | in this section | — |
HOST1_LIDARR_MUSIC_ROOT |
a text box | in this section | — |
HOST1_FANART_API_KEY |
a masked box with a Show button | in this section | — |
HOST1_LASTFM_API_KEY |
a masked box with a Show button | in this section | — |
HOST1_LIDARR_PATH_MAP |
a list, one entry per line | in this section | — |
Media Cleaner
Reachable from:
- Scheduler tab → Media Cleaner → Config → Media Cleaner
- Media Stack tab → Media settings → Media Cleaner
- Settings tab → All settings → Media Cleaner
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_ANIME_CLEAN_FOLDERS |
a list, one entry per line | in this section | — |
HOST1_MEDIA_CLEAN_FOLDERS |
a list, one entry per line | in this section | — |
Media Permissions
Reachable from:
- Scheduler tab → Media Shares Permissions → Config → Media Permissions
- Scheduler tab → Bulk Permissions Repair → Config → Media Permissions
- Scheduler tab → Trailer Folder Migration → Config → Media Permissions
- Media Stack tab → Media settings → Media Permissions
- Settings tab → All settings → Media Permissions
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_MEDIA_PERMISSION_SHARES |
a list, one entry per line | in this section | — |
Monthly Sync Shares
Route: Settings tab → All settings → Monthly Sync Shares
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_MONTHLY_SYNC_SHARES |
a list, one entry per line | in this section | Shares synced by monthly_maintenance.sh. Add here when ready. |
Network Watchdog
Reachable from:
- Scheduler tab → Network Watchdog → Config → Network Watchdog
- Watchdog tab → Watchdog settings → Network Watchdog
- Settings tab → All settings → Network Watchdog
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_NETWORK_WATCHDOG_DDNS_DOMAIN |
a text box | in this section | — |
HOST1_NETWORK_WATCHDOG_DDNS_CONTAINER |
a text box | in this section | — |
HOST1_NETWORK_WATCHDOG_NPM_URL |
a text box | in this section | — |
NginxProxyManager
Reachable from:
- Auth tab → Auth settings → NginxProxyManager
- Settings tab → All settings → NginxProxyManager
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_NPM_URL |
a text box | in this section | Admin API runs on 7818 (not 81 — 81 is the partnership WebUI port). |
HOST1_NPM_USER |
a text box | in this section | NPM admin email |
HOST1_NPM_PASS |
a masked box with a Show button | in this section | NPM admin password |
Notifications
Route: Settings tab → All settings → Notifications
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_DISCORD_WEBHOOK |
a text box | Settings tab | Discord webhook — leave blank to disable. |
Ollama
Reachable from:
- Scheduler tab → Ai Index → Config → Ollama
- Scheduler tab → Ai Query → Config → Ollama
- Settings tab → All settings → Ollama
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_OLLAMA_URL |
a text box | in this section | e.g. http://localhost:11434 — empty if no local Ollama |
HOST1_OLLAMA_GPU_UUID |
a text box | in this section | pins Ollama to one card on multi-GPU hosts |
HOST1_OLLAMA_MODEL |
a text box | in this section | generation — must fully offload; see README-AI.md |
PARTNERSHIP
Reachable from:
- Settings tab → All settings → PARTNERSHIP
- Partnership tab → Array Settings → PARTNERSHIP
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_PARTNERSHIP_AUTH_WEBUIS |
a list, one entry per line | in this section | Auth containers reconfigured on onboard/offboard. Format: "ContainerName|WebUIPort" |
HOST1_PARTNERSHIP_AUTH_STACK |
a list, one entry per line | in this section | XML templates pushed to mirror during onboard — auth stack. Dependencies (databases) must come before apps that depend on them. |
HOST1_PARTNERSHIP_ARR_STACK |
a list, one entry per line | in this section | XML templates pushed to mirror during onboard — arr stack. |
HOST1_PARTNERSHIP_SERVICES_STACK |
a list, one entry per line | in this section | XML templates pushed to mirror during onboard — other services (not auth, not arr). |
HOST1_PARTNERSHIP_MIRROR_BACKUPS |
a list, one entry per line | in this section | Paths the partner should collect during the grace window after offboard. |
HOST1_PARTNERSHIP_OWN_CONTAINERS |
a list, one entry per line | in this section | Containers parked on this server when partnership is active. |
HOST1_PARTNERSHIP_REPLACE_CONTAINERS |
a list, one entry per line | in this section | Containers stopped on THIS server before deploying the mirror's stack on onboard. |
HOST1_PARTNERSHIP_ARR_REPLACE_CONTAINERS |
a list, one entry per line | in this section | Arr containers stopped on this server when mirror's arr stack is deployed. |
HOST1_PARTNERSHIP_PROVISION_EMBY_ADMIN |
a switch | in this section | owner controls whether Emby is shared |
HOST1_PARTNERSHIP_EMBY_PORT |
a number box | in this section | — |
HOST1_PARTNERSHIP_EMBY_ADMIN_USER |
a text box | in this section | this server's desired Emby username |
HOST1_PARTNERSHIP_EMBY_ADMIN_PASS |
a masked box with a Show button | in this section | this server's desired Emby password |
PCIe AER Quiet
Route: Settings tab → All settings → PCIe AER Quiet
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_PCIE_QUIET_DEVICES |
a list, one entry per line | in this section | Only devices bound to vfio-pci or to no driver at all are eligible. Anything with a live driver is refused, so a mistyped address cannot pull an HBA or NIC out from under a running system. Devices claimed by a running VM are refused too. Gated by PCIE_QUIET_ENABLED in master.conf. Empty list = no-op. |
Personal Shares
Route: Settings tab → All settings → Personal Shares
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_PERSONAL_SHARES |
a list, one entry per line | in this section | Private encrypted shares synced for offsite backup, independent of media shares. |
RESOURCE MANAGER
Route: Settings tab → All settings → RESOURCE MANAGER
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_RW_PAUSE_CONTAINERS |
a list, one entry per line | in this section | — |
HOST1_RW_STOP_CONTAINERS |
a list, one entry per line | in this section | — |
Radarr
Reachable from:
- Scheduler tab → Radarr Cleanup → Config → Radarr
- Scheduler tab → Radarr Classification Scan → Config → Radarr
- Scheduler tab → Playback Aware Radarr Discovery → Config → Radarr
- Scheduler tab → Radarr Tmdb Removed → Config → Radarr
- Scheduler tab → Emby To Radarr Sync → Config → Radarr
- Media Stack tab → Media settings → Radarr
- Settings tab → All settings → Radarr
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_RADARR_URL |
a text box | in this section | — |
HOST1_RADARR_API_KEY |
a masked box with a Show button | in this section | — |
HOST1_TMDB_API_KEY |
a masked box with a Show button | in this section | — |
HOST1_RADARR_MOVIES_ROOT |
a text box | in this section | — |
HOST1_RADARR_GENERAL_ROOT |
a text box | in this section | rootFolderPath literal for the general root — target for reverse-kids-leak moves |
HOST1_RADARR_KIDS_ROOT |
a text box | in this section | rootFolderPath literal, as reported by Radarr API |
HOST1_RADARR_ANIME_ROOT |
a text box | in this section | — |
HOST1_RADARR_DOWNLOAD_DIR |
a text box | in this section | — |
HOST1_RADARR_DOWNLOAD_CONTAINER_DIR |
a text box | in this section | — |
HOST1_RADARR_PATH_MAP |
a list, one entry per line | in this section | — |
Rsync Writeback
Reachable from:
- Rsync tab → Rsync settings → Rsync Writeback
- Settings tab → All settings → Rsync Writeback
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_TIER1_WRITEBACK_DELAY |
a number box | in this section | skip Emby writeback if outage under 1hr |
FALLBACK_HOST1_WRITEBACK_TIER1 |
a list, one entry per line | in this section | — |
FALLBACK_HOST1_WRITEBACK_TIER2 |
a list, one entry per line | in this section | — |
FALLBACK_HOST1_WRITEBACK_TIER3 |
a list, one entry per line | in this section | — |
FALLBACK_HOST1_WRITEBACK_TIER4 |
a list, one entry per line | in this section | — |
SMART Health
Reachable from:
- Scheduler tab → Smart Health → Config → SMART Health
- Settings tab → All settings → SMART Health
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_SMART_IGNORE_DRIVES |
a list, one entry per line | in this section | — |
SYSTEM WATCHDOG
Reachable from:
- Scheduler tab → Watchdog Orchestrator → Config → SYSTEM WATCHDOG
- Watchdog tab → Watchdog settings → SYSTEM WATCHDOG
- Settings tab → All settings → SYSTEM WATCHDOG
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_SYS_WATCHDOG_NIC |
a text box | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_DOCKER_DAEMON |
a switch | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_ROOTFS |
a switch | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_KERNEL_OOPS |
a switch | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_FD |
a switch | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_BOOT |
a switch | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_OOM |
a switch | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_RAM |
a switch | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_LOG |
a switch | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_ARC |
a switch | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_CPU_TEMP |
a switch | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_LOAD |
a switch | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_ZOMBIES |
a switch | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_CONTAINERS |
a switch | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_TMP |
a switch | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_MDSTAT |
a switch | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_NETWORK |
a switch | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_SSHD |
a switch | in this section | — |
HOST1_SYS_WATCHDOG_CHECK_RUNAWAY |
a switch | in this section | — |
Sonarr
Reachable from:
- Scheduler tab → Sonarr Cleanup → Config → Sonarr
- Scheduler tab → Sonarr Classification Scan → Config → Sonarr
- Scheduler tab → Playback Aware Sonarr Discovery → Config → Sonarr
- Scheduler tab → Sonarr Tvdb Removed → Config → Sonarr
- Scheduler tab → Emby To Sonarr Sync → Config → Sonarr
- Media Stack tab → Media settings → Sonarr
- Settings tab → All settings → Sonarr
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_SONARR_URL |
a text box | in this section | — |
HOST1_SONARR_API_KEY |
a masked box with a Show button | in this section | — |
HOST1_SONARR_TV_ROOT |
a text box | in this section | — |
HOST1_SONARR_GENERAL_ROOT |
a text box | in this section | rootFolderPath literal for the general root — target for reverse-kids-leak moves |
HOST1_SONARR_KIDS_ROOT |
a text box | in this section | rootFolderPath literal, as reported by Sonarr API |
HOST1_SONARR_ANIME_ROOT |
a text box | in this section | — |
HOST1_SONARR_DOWNLOAD_DIR |
a text box | in this section | — |
HOST1_SONARR_DOWNLOAD_CONTAINER_DIR |
a text box | in this section | — |
HOST1_SONARR_PATH_MAP |
a list, one entry per line | in this section | — |
Storage mode
Route: Settings tab → All settings → Storage mode
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_STORAGE_MODE_INTERNAL |
a switch | Settings tab | Controls where Varaverk stores scripts, conf, and state files. true = internal NVMe/SSD — /boot/config/plugins/varaverk (write-safe, git-direct) false = USB flash boot — /mnt/user/appdata/Varaverk (preserves flash lifetime) Auto-detected from boot device transport on first setup. To change: Settings → Storage → Migrate. |
TRANSCODES
Route: Settings tab → All settings → TRANSCODES
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_RAMDISK_SIZE |
a text box | in this section | — |
HOST1_RAMDISK_WARN_GB |
a text box | in this section | flip to SSD when ramdisk usage reaches this |
HOST1_RAMDISK_LOW_GB |
a number box | in this section | flip back to ramdisk when usage drops to this |
HOST1_TRANSCODE_SSD |
a text box | in this section | — |
HOST1_TRANSCODE_SERVERS |
a list, one entry per line | in this section | — |
Tier Delays — HOST1 Outage Timers
Reachable from:
- Fallback tab → Fallback settings → Tier Delays — HOST1 Outage Timers
- Settings tab → All settings → Tier Delays — HOST1 Outage Timers
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_TIER2_DELAY |
a number box | in this section | 4 hours — NextCloud, Immich |
HOST1_TIER3_DELAY |
a number box | in this section | 12 hours — secondary services |
HOST1_TIER4_DELAY |
a number box | in this section | 24 hours — arrs + downloaders |
Unraid API
Route: Settings tab → All settings → Unraid API
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_UNRAID_API_KEY |
a masked box with a Show button | in this section | Used by the Varaverk plugin to query this server's Unraid GraphQL API. Generate in Unraid: Settings → Management Access → API Keys → + New Key |
Web search
Route: Settings tab → All settings → Web search
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_DEGOOG_URL |
a text box | in this section | e.g. http://localhost:4444 — self-hosted, no key, /api/search |
HOST1_SEARXNG_URL |
a text box | in this section | e.g. http://localhost:8888 — needs format: [json] in its settings.yml |
HOST1_WEB_SEARCH_API_KEY |
a masked box with a Show button | in this section | brave or tavily; unused when the provider is searxng |
HOST1_OLLAMA_EMBED_MODEL |
a text box | in this section | embeddings — the generation model cannot embed |
Weekly Sync Shares
Reachable from:
- Scheduler tab → Weekly Sync Maintenance → Config → Weekly Sync Shares
- Settings tab → All settings → Weekly Sync Shares
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_WEEKLY_SYNC_SHARES |
a list, one entry per line | in this section | Appdata shares synced during the weekly maintenance window. Profiles (emby, critical-data) drive container stops — define in master.conf. |
ZFS Report
Reachable from:
- Scheduler tab → Zfs Memory Snapshot → Config → ZFS Report
- Settings tab → All settings → ZFS Report
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_ZFS_REPORT_IGNORE_POOLS |
a list, one entry per line | in this section | — |
lldap
Reachable from:
- Auth tab → Auth settings → lldap
- Settings tab → All settings → lldap
Saved into host1.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
HOST1_LLDAP_URL |
a text box | in this section | — |
HOST1_LLDAP_USER |
a text box | in this section | lldap admin username |
HOST1_LLDAP_PASS |
a masked box with a Show button | in this section | lldap admin password |
AI Chat Caution
Reachable from:
- AI tab → Settings → Configuration → AI Chat Caution
- Settings tab → All settings → AI Chat Caution
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
AI_CHAT_MY_SYSTEM_PHRASES |
a text box | in this section | Pipe-separated extra phrases for what grammar misses: a nickname for the box, a share name, anything that in practice means "mine". Matched as literal text, not as patterns. |
AI Conf Write Access
Reachable from:
- AI tab → Settings → Configuration → AI Conf Write Access
- Settings tab → All settings → AI Conf Write Access
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
AI_CONF_WRITE_ENABLED |
a switch | in this section | Separate switch from AI_ENABLED, off by default, and an explicit key whitelist. Never paths, never credentials, never a container name. An empty whitelist means no writes regardless of the toggle. |
AI_CONF_WRITE_KEYS |
a list, one entry per line | in this section | — |
AI Feature Toggles
Reachable from:
- Scheduler tab → Ai Token Sync → Config → AI Feature Toggles
- AI tab → Settings → Configuration → AI Feature Toggles
- Settings tab → All settings → AI Feature Toggles
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
AI_ASSIST_REPORTS |
a switch | in this section | tier 1 — digest / coffee report narration |
AI_ASSIST_WATCHDOG |
a switch | in this section | tier 2 — file a finding when a watchdog counter passes its limit (needs AI_REPAIR_ENABLED) |
AI_ASSIST_DISCOVERY |
a switch | in this section | tier 2 — discovery / classification judgement calls |
AI_ASSIST_CLEANUP |
a switch | in this section | tier 2 — orphan and stuck-import triage |
AI_ASSIST_ONBOARD |
a switch | in this section | tier 3 — onboarding / settings assistance |
AI Learned Memory
Reachable from:
- AI tab → Settings → Configuration → AI Learned Memory
- Settings tab → All settings → AI Learned Memory
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
AI_MEMORY_LEARN_ENABLED |
a switch | in this section | Costs nothing while off: the instruction that asks for a candidate is only added to the prompt when this is true, so a disabled feature is genuinely absent rather than merely ignored. |
AI_MEMORY_LEARN_AUTO_ACCEPT |
a switch | in this section | Writes accepted candidates without asking. Cannot outrank its parent — with proposing off this does nothing. Leave it false until the proposals have proven good for a while. |
AI Master Switch
Reachable from:
- Scheduler tab → Ai Index → Config → AI Master Switch
- Scheduler tab → Ai Query → Config → AI Master Switch
- Scheduler tab → Ai Repair Sweep → Config → AI Master Switch
- AI tab → Settings → Configuration → AI Master Switch
- Settings tab → All settings → AI Master Switch
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
AI_OWNER_HOST |
a text box | in this section | Which node runs the model, the retrieval index and the bug store. Every other node borrows it over the mesh, so a box without a GPU still gets the assistant — it just does not get the AI tab. Defaults to host1 when unset or malformed: whoever builds the mesh is host1. |
AI_ENABLED |
a switch | Settings tab | Fail-closed: anything other than the literal "true" means off. |
AI_CONNECT_TIMEOUT |
a number box, in seconds | in this section | seconds — probe when resolving which node has Ollama |
AI_REQUEST_TIMEOUT |
a number box, in seconds | in this section | seconds — must clear a cold model load |
AI_RESOLVE_CACHE_TTL |
a number box, in seconds | in this section | seconds — don't re-probe the mesh every invocation |
AI_MAX_RETRIES |
a number box | in this section | AI is enhancement; do not retry hard |
AI Memory
Reachable from:
- AI tab → Settings → Configuration → AI Memory
- Settings tab → All settings → AI Memory
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
AI_MEMORY_ASSISTED_FILE |
a text box | in this section | AI_MEMORY_FILE is the pre-split name and is still honoured: while the assisted file does not exist, the legacy path is read instead, so an upgrade loses nothing. |
AI_MEMORY_LEARNED_FILE |
a text box | in this section | — |
AI_MEMORY_FILE |
a text box | in this section | — |
AI_MEMORY_ASSISTED_PROFILES |
a text box | in this section | Which profiles each slot is given. "*" is all of them. Narrowing is how a General Chat question about bash syntax stops carrying this machine's PCIe topology and disk serials. |
AI_MEMORY_LEARNED_PROFILES |
a text box | in this section | — |
AI_MEMORY_MAX_CHARS |
a number box | in this section | ~1000 tokens — truncated with a notice if exceeded |
AI_MEMORY_LEARNED_MAX_CHARS |
a number box | in this section | A ceiling on the learned slot alone, well under the total. A store that grows on its own would otherwise end up occupying the whole budget, and the operator's own memory is what would get truncated away — the exact inversion of which one matters. |
AI Repair
Reachable from:
- Scheduler tab → Ai Repair Sweep → Config → AI Repair
- AI tab → Settings → Configuration → AI Repair
- Settings tab → All settings → AI Repair
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
AI_REPAIR_ENABLED |
a switch | in this section | AI_REPAIR_AUTOFIX_ENABLED is what allows a value to be written unattended, and only ever a value a probe has answered on. Never a toggle: whether something should be switched on is a decision about intent, and a probe cannot prove intent the way it can prove a port answers. |
AI_REPAIR_AUTOFIX_ENABLED |
a switch | in this section | — |
AI Repair Findings
Reachable from:
- Scheduler tab → Ai Repair Sweep → Config → AI Repair Findings
- AI tab → Settings → Configuration → AI Repair Findings
- Settings tab → All settings → AI Repair Findings
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
AI_FINDING_RETAIN_DAYS |
a number box | in this section | Misconfigurations found in this installation, as opposed to defects in Varaverk — those go to ai_bugs. A finding is open until the configuration is right, and closes itself when the probe that proved the fault starts passing. Closed ones are kept for a while, because "this happened before and here is what fixed it" is worth more than the disk. Open findings are never pruned: an unresolved probl… |
AI_PROBE_TIMEOUT |
a number box, in seconds | in this section | Seconds a single probe may take. Nothing is written to conf that has not answered a probe, so this is the budget for proving a candidate — kept short because a sweep may try several, and an address worth switching to answers quickly or is not worth switching to. |
AI_REPAIR_NOTIFY_ENABLED |
a switch | in this section | On by default, unlike the two switches above. Those gate reading and writing, which are things to be trusted first. This gates telling someone, which is the reason for having looked. |
AI Repair: what it reads
Reachable from:
- AI tab → Settings → Configuration → AI Repair: what it reads
- Settings tab → All settings → AI Repair: what it reads
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
AI_REPAIR_SYSLOG_ENABLED |
a switch | in this section | Both are bounded by time (since the last pass) and by a line cap, so a flood costs one pass. Tools/ai_log_check.sh replays this host's real logs against the patterns — run it after changing any of them. |
AI_REPAIR_SYSLOG_MAX_LINES |
a number box | in this section | — |
AI_REPAIR_CONTAINER_LOGS_ENABLED |
a switch | in this section | — |
AI_REPAIR_CONTAINER_LOG_LINES |
a number box | in this section | — |
AI Retrieval Index
Reachable from:
- Scheduler tab → Ai Index → Config → AI Retrieval Index
- Scheduler tab → Ai Query → Config → AI Retrieval Index
- AI tab → Settings → Configuration → AI Retrieval Index
- Settings tab → All settings → AI Retrieval Index
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
AI_INDEX_DB |
a text box | in this section | Only git-tracked files are ever indexed. Configurations/, State_Files/ and data/ are gitignored, which is what makes it structurally impossible for a credential to reach the index: the files holding them were never in the repo. Do not "improve" this to a filesystem walk — an embedded secret cannot be rotated out of a vector. |
AI_INDEX_BATCH |
a number box | in this section | chunks per embed request |
AI_INDEX_ON_PULL |
a switch | in this section | re-index after a git pull that changed tracked files |
AI_SEARCH_K |
a number box | in this section | chunks retrieved per query |
AI_SEARCH_PER_FILE |
a number box | in this section | cap per file so one document cannot fill the context |
AI Stored Conversations
Reachable from:
- AI tab → Settings → Configuration → AI Stored Conversations
- Settings tab → All settings → AI Stored Conversations
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
AI_CHAT_HISTORY_MAX |
a number box, in conversations, 1–50 | in this section | conversations kept — clamped to 1-50 |
AI Token Accounting
Reachable from:
- AI tab → Settings → Configuration → AI Token Accounting
- Settings tab → All settings → AI Token Accounting
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
AI_TOKEN_DB |
a text box | in this section | Retention is by row count rather than age: pruning is considered only when the file passes a size threshold, so an ordinary turn costs one stat() and an append. |
AI_TOKEN_RETAIN_ROWS |
a number box | in this section | oldest rows dropped past this — years of ordinary use |
AI_TOKEN_SYNC_ENABLED |
a switch | in this section | AI/ai_token_sync.sh pulls each partner's ledger into the tmpfs cache the tab reads, so the fleet total is a fleet total. Same trick conf_sync.sh uses for partner confs, minus the push: nothing here is needed by anyone else, so the reader fetches its own data and controls its own freshness. An unreachable partner is a quiet skip, not a warning — a partner is expected to be down for long stretche… |
AI Web Search
Reachable from:
- AI tab → Settings → Configuration → AI Web Search
- Settings tab → All settings → AI Web Search
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
AI_WEB_SEARCH_ENABLED |
a switch | in this section | Provider: degoog | searxng | brave | tavily degoog self-hosted, no key — set HOST*_DEGOOG_URL. Aggregates several engines and returns them merged. The default, and the only one verified against a live service here searxng self-hosted, no key, no third party — set HOST*_SEARXNG_URL, and enable format: [json] in its own settings.yml, which the default image ships with off brave HOST*_WEB_SEARC… |
AI_WEB_SEARCH_PROVIDER |
a text box | in this section | — |
AI_WEB_SEARCH_RESULTS |
a number box | in this section | — |
AI_WEB_SEARCH_TIMEOUT |
a number box | in this section | — |
Abort Toggles
Route: Settings tab → All settings → Abort Toggles
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
SYS_WATCHDOG_ABORT_ON_ZFS_UNHEALTHY |
a switch | in this section | rebooting with bad pool risks data loss |
SYS_WATCHDOG_ABORT_ON_PARITY |
a switch | in this section | aborting parity better than crashing mid-check |
SYS_WATCHDOG_ABORT_ON_MOVER |
a switch | in this section | aborting move better than crashing mid-move |
Arr Cleanup
Reachable from:
- Scheduler tab → Radarr Cleanup → Config → Arr Cleanup
- Scheduler tab → Lidarr Cleanup → Config → Arr Cleanup
- Scheduler tab → Sonarr Cleanup → Config → Arr Cleanup
- Media Stack tab → Media settings → Arr Cleanup
- Settings tab → All settings → Arr Cleanup
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
SONARR_VERSION_MAJOR |
a number box | in this section | API versions — update MAJOR version here when script is updated for a new arr version: Sonarr v4 → /api/v3/series → /api/v3/episodefile?seriesId=X Radarr v6 → /api/v3/movie → /api/v3/moviefile?movieId=X Lidarr v3 → /api/v1/artist → /api/v1/trackFile?artistId=X |
RADARR_VERSION_MAJOR |
a number box | in this section | — |
LIDARR_VERSION_MAJOR |
a number box | in this section | — |
ARR_KIDS_PROFILE_NAME |
a text box | in this section | arr_profile_enforcer.sh — quality profile names by root folder type Root folder paths containing "kids" or "anime" → ARR_KIDS_PROFILE_NAME All other root folders → ARR_*_DEFAULT_PROFILE |
ARR_SONARR_DEFAULT_PROFILE |
a text box | in this section | — |
ARR_RADARR_DEFAULT_PROFILE |
a text box | in this section | — |
LIDARR_RELEASE_FIXER_ENABLED |
a switch | in this section | set false to disable without removing from job list |
LIDARR_LOCK_WARN_AGE |
a number box | in this section | 1hr — large libraries take time, not stuck |
LIDARR_ORPHAN_AGE |
a number box, in days | in this section | days — files must be older than this before eligible for deletion |
LIDARR_MAX_DELETE_GB |
a number box | in this section | require --i-know-what-im-doing if deletion exceeds this |
LIDARR_MIN_TRACKED_PCT |
a number box | in this section | abort if tracked count drops below this % of last run |
LIDARR_TRACKED_COUNT_FILE |
a text box | in this section | — |
LIDARR_IMPORT_SCAN_TIMEOUT |
a number box, in seconds | in this section | seconds to wait for pre-flight import scan |
LIDARR_CACHE_FILE |
a text box | in this section | Lidarr tracked-data cache — shared by lidarr_cleanup.sh, lidarr_duplicate_artist_cleanup.sh, lidarr_missing_art.sh, lidarr_release_fixer.sh, and arr_cache_prefill.sh. See lidarr_get_tracked_data() in common.sh for the fresh/stale/rescan-active branching logic. |
LIDARR_RESCAN_DURATION_DB |
a text box | in this section | — |
LIDARR_CACHE_MAX_AGE_DAYS |
a number box | in this section | force a live refresh (or rescan-aware wait) past this age |
ARR_PREFILL_WAIT_MINUTES |
a number box | in this section | array-start prefill: how long to retry reaching each arr |
LIDARR_EXTENSIONS |
a list, one entry per line | in this section | — |
LIDARR_PROTECTED_PATTERNS |
a list, one entry per line | in this section | — |
LIDARR_ART_MIN_SIZE |
a number box | in this section | bytes — reject downloads smaller than this |
LIDARR_ART_MAX_PARALLEL |
a number box | in this section | concurrent background download jobs |
LIDARR_ART_RETRIES |
a number box | in this section | download retry attempts per image |
LIDARR_ART_SLEEP_BETWEEN |
a text box | in this section | seconds between fanart.tv API calls |
LIDARR_ART_RECHECK_DAYS |
a number box, in days | in this section | days before re-querying art that upstream didn't have |
LIDARR_ART_MISS_CACHE |
a text box | in this section | negative cache — art upstream has never had |
LIDARR_DISCOVERY_THRESHOLD |
a number box | in this section | score to accept candidate (0-100) |
LIDARR_DISCOVERY_LOOKBACK_DAYS |
a number box | in this section | Emby play history window in days |
LIDARR_DISCOVERY_MIN_PLAYS |
a number box | in this section | min plays in window before evaluating an artist |
LIDARR_DISCOVERY_USER_CAP_PCT |
a number box | in this section | max % any single user can contribute to play score (prevents one listener dominating) |
LIDARR_DISCOVERY_MAX_ADDS |
a number box | in this section | max artists to add per run — quality over bulk |
LIDARR_DISCOVERY_REJECT_COOLDOWN |
a number box, in days | in this section | days before re-evaluating a rejected artist |
LIDARR_DISCOVERY_HISTORY |
a text box | in this section | — |
SONARR_DISCOVERY_THRESHOLD |
a number box | in this section | score to accept candidate (0-100) |
SONARR_DISCOVERY_LOOKBACK_DAYS |
a number box | in this section | Emby episode play history window in days (shorter than movies — TV watched more frequently) |
SONARR_DISCOVERY_MAX_SEEDS |
a number box | in this section | max seed series from Stage 1 |
SONARR_DISCOVERY_MAX_ADDS |
a number box | in this section | max shows to add per run — TV is a larger commitment than movies |
SONARR_DISCOVERY_MIN_VOTE_COUNT |
a number box | in this section | min TMDB votes (TV has fewer votes than movies at same popularity) |
SONARR_DISCOVERY_MIN_RATING |
a number box | in this section | min TMDB vote_average × 10 (65 = 6.5/10) |
SONARR_DISCOVERY_REJECT_COOLDOWN |
a number box, in days | in this section | days before re-evaluating a rejected show |
SONARR_DISCOVERY_USER_EPISODE_CAP |
a number box | in this section | max episodes any one user contributes to seed volume score |
SONARR_DISCOVERY_MONITOR_MODE |
a dropdown (all, future, first, latest, none) | in this section | Sonarr monitor mode on add: all | future | first | latest | none |
SONARR_DISCOVERY_HISTORY |
a text box | in this section | — |
RADARR_DISCOVERY_THRESHOLD |
a number box | in this section | score to accept candidate (0-100) — lower than Lidarr since diverse seeds rarely overlap |
RADARR_DISCOVERY_LOOKBACK_DAYS |
a number box | in this section | Emby watch history window in days (movies rewatched less often) |
RADARR_DISCOVERY_MAX_SEEDS |
a number box | in this section | max seed movies from Stage 1 |
RADARR_DISCOVERY_MAX_ADDS |
a number box | in this section | max movies to add per run |
RADARR_DISCOVERY_MIN_VOTE_COUNT |
a number box | in this section | min TMDB votes to be considered a candidate |
RADARR_DISCOVERY_MIN_RATING |
a number box | in this section | min TMDB vote_average × 10 (60 = 6.0/10) |
RADARR_DISCOVERY_REJECT_COOLDOWN |
a number box, in days | in this section | days before re-evaluating a rejected movie |
RADARR_DISCOVERY_SEED_LIBRARIES |
a list, one entry per line | in this section | — |
RADARR_DISCOVERY_HISTORY |
a text box | in this section | — |
SONARR_EMBY_LIBRARIES |
a list, one entry per line | in this section | Emby → arr sync library allowlists Only these Emby library names will be considered by the sync tools. Names must match exactly as shown in Emby > Dashboard > Libraries. |
RADARR_EMBY_LIBRARIES |
a list, one entry per line | in this section | — |
SONARR_ORPHAN_AGE |
a number box, in days | in this section | days — files must be older than this before eligible for deletion |
SONARR_MAX_DELETE_GB |
a number box | in this section | require --i-know-what-im-doing if deletion exceeds this |
SONARR_MIN_TRACKED_PCT |
a number box | in this section | abort if tracked count drops below this % of last run |
SONARR_TRACKED_COUNT_FILE |
a text box | in this section | — |
SONARR_IMPORT_SCAN_TIMEOUT |
a number box, in seconds | in this section | seconds to wait for pre-flight import scan |
SONARR_MOVE_POLL_TIMEOUT |
a number box, in seconds | in this section | seconds to wait for a single async MoveSeries command to |
CORRUPTION_SCAN_STATE_FILE |
a text box | in this section | clean-file skip-cache |
CORRUPTION_SCAN_STRIKES_FILE |
a text box | in this section | consecutive corrupt-detection counts, keyed by host path |
CORRUPTION_SCAN_STRIKE_LIMIT |
a number box, in consecutive | in this section | consecutive corrupt detections (across separate scan runs) |
SONARR_EXTENSIONS |
a list, one entry per line | in this section | — |
SONARR_PROTECTED_PATTERNS |
a list, one entry per line | in this section | — |
RADARR_ORPHAN_AGE |
a number box, in days | in this section | days — files must be older than this before eligible for deletion |
RADARR_MAX_DELETE_GB |
a number box | in this section | require --i-know-what-im-doing if deletion exceeds this |
RADARR_MIN_TRACKED_PCT |
a number box | in this section | abort if tracked count drops below this % of last run |
RADARR_TRACKED_COUNT_FILE |
a text box | in this section | — |
RADARR_IMPORT_SCAN_TIMEOUT |
a number box, in seconds | in this section | seconds to wait for pre-flight import scan |
RADARR_MOVE_POLL_TIMEOUT |
a number box, in seconds | in this section | seconds to wait for a single async MoveMovie command to |
RADARR_EXTENSIONS |
a list, one entry per line | in this section | — |
RADARR_PROTECTED_PATTERNS |
a list, one entry per line | in this section | — |
RADARR_DROPPED_ADD_EXCLUSION |
a switch | in this section | add removed movies to import exclusion list |
SONARR_DROPPED_ADD_EXCLUSION |
a switch | in this section | add removed series to import exclusion list |
Arr Content Classification (radarr/sonarr_classification_scan.sh)
Reachable from:
- Scheduler tab → Radarr Classification Scan → Config → Arr Content Classification (radarr/sonarr_classification_scan.sh)
- Scheduler tab → Sonarr Classification Scan → Config → Arr Content Classification (radarr/sonarr_classification_scan.sh)
- Media Stack tab → Media settings → Arr Content Classification (radarr/sonarr_classification_scan.sh)
- Settings tab → All settings → Arr Content Classification (radarr/sonarr_classification_scan.sh)
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
RADARR_ANIME_STUDIOS |
a list, one entry per line | in this section | — |
RADARR_KIDS_STUDIOS |
a list, one entry per line | in this section | — |
RADARR_JUNK_MIN_VOTES |
a number box | in this section | — |
SONARR_ANIME_NETWORKS |
a list, one entry per line | in this section | — |
SONARR_KIDS_NETWORKS |
a list, one entry per line | in this section | — |
Arr Failed/Stalled Recovery
Reachable from:
- Scheduler tab → Arrs Failed Stalled Recovery → Config → Arr Failed/Stalled Recovery
- Media Stack tab → Media settings → Arr Failed/Stalled Recovery
- Settings tab → All settings → Arr Failed/Stalled Recovery
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
ARR_IMPORT_RECOVERY_AGE |
a number box, in hours | Media Stack tab | hours — skip items newer than this |
ARR_RECOVERY_MAX_ATTEMPTS |
a number box, in consecutive | in this section | consecutive failures before an item is flagged chronic |
ARR_SMART_IMPORT_ENABLED |
a switch | in this section | importBlocked items: try importing a clean same-language |
ARR_SMART_IMPORT_PREFERRED_LANGUAGE |
a text box | in this section | only treated as a match/upgrade if the |
Arr Full Library Rescan
Reachable from:
- Scheduler tab → Arr Full Rescan → Config → Arr Full Library Rescan
- Media Stack tab → Media settings → Arr Full Library Rescan
- Settings tab → All settings → Arr Full Library Rescan
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
ARR_FULL_RESCAN_TIMEOUT |
a number box, in seconds | in this section | seconds per arr — a full-library walk, not a single release |
Arr Sync
Reachable from:
- Media Stack tab → Media settings → Arr Sync
- Settings tab → All settings → Arr Sync
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
ARR_SYNC_ENABLED |
a switch | in this section | arr_sync.sh syncs Lidarr/Sonarr/Radarr libraries across all nodes bidirectionally. Runs before rsync — all nodes agree on tracked library before files are transferred. Remote API keys are read live from each node's config.xml via SSH — never stored here. |
ARR_SYNC_BLOCKLIST |
a text box | in this section | — |
ARR_SYNC_CONNECT_TIMEOUT |
a number box, in seconds | in this section | seconds — SSH connect timeout per node |
ARR_SYNC_API_TIMEOUT |
a number box, in seconds | in this section | seconds — curl timeout for library fetches |
DOCKER_APPDATA_BASE |
a text box | in this section | set by platform adapter; override in host*.conf if needed |
ARR_SYNC_LIDARR_PORT |
a number box | in this section | — |
ARR_SYNC_SONARR_PORT |
a number box | in this section | — |
ARR_SYNC_RADARR_PORT |
a number box | in this section | — |
Array Start
Reachable from:
- Scheduler tab → Array Started → Config → Array Start
- Settings tab → All settings → Array Start
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
ARRAY_START_SCRIPTS |
a list, one entry per line | in this section | Scripts launched by array_started.sh when the array comes online. Launched in order — each as a background process. One-shot scripts (ramdisk, syslog, fpm, inotify, network) run and exit naturally. Continuous scripts (failover) run until array stops. Watchdogs (resource_watchdog, docker_watchdog, system_watchdog) are cronned via watchdog_orchestrator.sh — NOT launched here. |
Array Stop
Reachable from:
- Scheduler tab → Array Stopping → Config → Array Stop
- Settings tab → All settings → Array Stop
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
ARRAY_STOP_SCRIPTS |
a list, one entry per line | in this section | Scripts run by array_stopping.sh for a planned shutdown — stops everything cleanly in order. Run sequentially (foreground) — each must complete before the next starts. Order matters: user scripts first (prevents new ops), then data movement, then containers. |
Auth Stack
Reachable from:
- Auth tab → Auth settings → Auth Stack
- Settings tab → All settings → Auth Stack
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
AUTH_STACK |
a dropdown (authelia_lldap, authentik) | in this section | Mesh-wide rather than per host: auth is the one service the partnership treats as shared, owned by the mesh owner and consumed by everyone else, so two nodes disagreeing about which stack is in force would mean two different answers to "who is this person". "authelia_lldap" — Authelia for access rules, lldap for users and groups. Fully implemented. "authentik" — single stack for both. NOT IMPLE… |
Backup Verify
Reachable from:
- Scheduler tab → Backup Verify → Config → Backup Verify
- Settings tab → All settings → Backup Verify
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
BACKUP_VERIFY_SAMPLE |
a number box | in this section | random files to check per share |
BACKUP_VERIFY_MIN_SIZE |
a text box | in this section | minimum file size to include in sample |
Bandwidth Monitor
Reachable from:
- Scheduler tab → Bandwidth Monitor → Config → Bandwidth Monitor
- Settings tab → All settings → Bandwidth Monitor
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
BANDWIDTH_LOG |
a text box | in this section | Called automatically by rsync.sh after each sync — one bounded write per run. Tracks transfer size, duration and profile per sync for weekly summary reporting. |
BANDWIDTH_LOG_RETENTION |
a number box, in days | in this section | days before old entries purged |
BANDWIDTH_WARN_GB |
a number box | Rsync tab | flag syncs larger than this in weekly report |
ARR_CLEANUP_STATS |
a text box | in this section | lidarr/sonarr/radarr orphan stats |
ARR_RECOVERY_STATS |
a text box | in this section | blocklist + re-search stats |
ARR_RECOVERY_FAILURE_COUNTS |
a text box | in this section | per-item chronic-failure tracking |
Bug Reports
Route: Settings tab → All settings → Bug Reports
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
BUG_REPORT_LOCAL_ENABLED |
a switch | in this section | LOCAL ON — reports go to your own Gitea (see HOSTN_BUG_REPORT_* in host*.conf) and stay there. They do NOT reach the Varaverk maintainer. Turn it on if you want your own backlog. LOCAL OFF — reports open a prefilled GitHub issue you submit under your own account. |
BUG_REPORT_GITHUB_REPO |
a text box | in this section | — |
Certificate History
Route: Settings tab → All settings → Certificate History
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
CERT_HISTORY_STRIKES |
a number box | in this section | expired passes before a domain is retired from the active list |
Certificate Monitor
Reachable from:
- Scheduler tab → Cert Monitor → Config → Certificate Monitor
- Scheduler tab → Weekly Health Digest → Config → Certificate Monitor
- Auth tab → Auth settings → Certificate Monitor
- Settings tab → All settings → Certificate Monitor
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
CERT_WARN_DAYS |
a number box | in this section | warn when cert expires within this many days |
CERT_CRIT_DAYS |
a number box | in this section | critical alert within this many days |
CERT_TIMEOUT |
a number box, in seconds | in this section | seconds per domain before giving up |
Clear Logs
Reachable from:
- Scheduler tab → Clear Logs → Config → Clear Logs
- Settings tab → All settings → Clear Logs
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
LOG_FILES |
a list, one entry per line | in this section | Size threshold approach — only clear if log exceeds threshold. Avoids destroying useful recent diagnostic context when logs are small. LOG_MIN_SIZE_MB: skip clearing if log is under this size (not worth clearing) LOG_DOCKER_MAX_MB: clear a container log only if it exceeds this size Docker logs grow fastest on active containers (Emby, SABnzbd, Sonarr) 100MB per container × 30 containers = 3GB be… |
LOG_MIN_SIZE_MB |
a number box | in this section | skip system log if under this size (already small) |
LOG_DOCKER_MAX_MB |
a number box | in this section | clear Docker container log only if over this size (MB) |
Conf Backups
Route: Settings tab → All settings → Conf Backups
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
CONF_BACKUP_RETAIN |
a number box | in this section | Every write through the plugin copies the conf aside first, to CONF_BACKUP_DIR with an ISO-8601 stamp. The confs are gitignored, so that directory is the whole recovery path — there is no history to revert to. A backup that cannot be taken cancels the write. Oldest are pruned past this count, per conf file. |
Conf Sync
Route: Settings tab → All settings → Conf Sync
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
CONF_SYNC_ENABLED |
a switch | in this section | partner conf caching — armed by onboard Step 1d |
Critical Containers
Route: Settings tab → All settings → Critical Containers
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
RW_CRITICAL_CONTAINERS |
a list, one entry per line | in this section | Never paused or stopped regardless of pressure level. Keep DNS, auth, media serving, and live TV always running. |
Critical Sync Maintenance
Reachable from:
- Scheduler tab → Critical Sync Maintenance → Config → Critical Sync Maintenance
- Settings tab → All settings → Critical Sync Maintenance
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
CRITICAL_MAINTENANCE_SCRIPTS |
a list, one entry per line | in this section | critical_sync_maintenance.sh runs every 30 minutes. Order: CRITICAL_MAINTENANCE_SCRIPTS (jobs) → CRITICAL_SYNC_SHARES (rsync) → partnership --check partnership --check always runs last regardless of rsync gate. Comment out entries to disable without removing. |
Daily Sync Maintenance
Reachable from:
- Scheduler tab → Daily Sync Maintenance → Config → Daily Sync Maintenance
- Settings tab → All settings → Daily Sync Maintenance
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
DAILY_MAINTENANCE_SCRIPTS |
a list, one entry per line | in this section | daily_sync_maintenance.sh runs media share sync first, then iterates DAILY_MAINTENANCE_SCRIPTS for all jobs. Schedule: 0 1 * * * (1am daily) |
DAILY_CONTAINER_UPDATES |
a switch | in this section | Pull latest images for DAILY_RESTART_CONTAINERS before the daily restart. Containers keep running during pull — no extra downtime. Set false to skip updates while still running the daily restart. |
Docker Watchdog
Reachable from:
- Scheduler tab → Docker Watchdog → Config → Docker Watchdog
- Watchdog tab → Watchdog settings → Docker Watchdog
- Docker tab → Docker settings → Docker Watchdog
- Settings tab → All settings → Docker Watchdog
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
WATCHDOG_STATE_FILE |
a text box | in this section | Strike state file — /tmp resets on reboot (correct — no stale strikes after reboot) |
SOFT_CPU_THRESHOLD |
a number box | in this section | warn at this % of total system CPU |
HARD_CPU_THRESHOLD |
a number box | in this section | strike at this % of total system CPU |
CPU_FAIL_LIMIT |
a number box, in consecutive | in this section | consecutive hard CPU strikes before container restart |
SOFT_MEM_THRESHOLD |
a number box | in this section | Memory soft threshold — warn when container reaches this % of its hard limit |
RESP_FAIL_LIMIT |
a number box, in consecutive | in this section | consecutive failed checks before restart |
CURL_TIMEOUT |
a number box, in seconds | in this section | seconds per check before timeout |
WATCHDOG_SCAN_ALL |
a switch | in this section | false = only WATCHDOG_CONTAINERS + required containers |
WATCHDOG_RESTART_UNHEALTHY |
a switch | in this section | Individual Tier 2 check toggles |
WATCHDOG_RESTART_DEAD |
a switch | in this section | — |
WATCHDOG_RESTART_CRASHED |
a switch | in this section | — |
WATCHDOG_NOTIFY_OOM |
a switch | in this section | — |
WATCHDOG_NOTIFY_CRASHLOOP |
a switch | in this section | — |
WATCHDOG_CRASH_LIMIT |
a number box | in this section | RestartCount above this = critical crash loop |
WATCHDOG_REQUIRED_STRIKE_LIMIT |
a number box | in this section | Required-container strikes — consecutive down-checks before docker_watchdog.sh attempts a restart |
WATCHDOG_STARTUP_GRACE |
a number box, in seconds | in this section | seconds after boot before watchdog acts on failures |
WATCHDOG_CONTAINER_RESTART_LIMIT |
a number box | in this section | Restart loop protection — prevents watchdog from endlessly restarting a broken container |
WATCHDOG_CONTAINER_RESTART_WINDOW |
a number box | in this section | rolling window in hours |
WATCHDOG_CONTAINER_RESTART_LOG |
a text box | in this section | — |
WATCHDOG_BATCH_NOTIFY |
a switch | in this section | Notification batching — one summary per cycle instead of one ping per event |
WATCHDOG_DAEMON_TIMEOUT |
a number box, in seconds | in this section | seconds — timeout for all docker commands |
WATCHDOG_DAEMON_STRIKE_LIMIT |
a number box, in consecutive | in this section | consecutive failed checks before restart attempt |
WATCHDOG_DAEMON_RESTART_WAIT |
a number box, in seconds | in this section | seconds to wait after restart before verifying |
WATCHDOG_CHECK_APPDATA |
a switch | in this section | HOST*_WATCHDOG_APPDATA_SIZES (in host*.conf) suppresses growth warnings for a container until its dir exceeds the configured ceiling. Only needed when a container legitimately has large stable data and you want to guarantee it never triggers a false alarm. |
WATCHDOG_APPDATA_PATHS |
a list, one entry per line | in this section | — |
WATCHDOG_APPDATA_GROWTH_GB |
a number box | in this section | flag containers growing more than this per cycle |
WATCHDOG_APPDATA_LOG_MAX_GB |
a number box | in this section | flag *.log files exceeding this size (absolute) |
WATCHDOG_APPDATA_TRUNCATE_LOGS |
a switch | in this section | set true to auto-truncate oversized *.log files on action cycle |
WATCHDOG_APPDATA_STRIKE_LIMIT |
a number box | in this section | cycles before action fires (matches existing watchdog pattern) |
WATCHDOG_APPDATA_GROWTH_FILE |
a text box | in this section | — |
STORAGE_WATCHDOG_STATE_FILE |
a text box | in this section | — |
Download Orphan Cleaner (arr_download_orphan_cleaner.sh)
Reachable from:
- Scheduler tab → Arr Download Orphan Cleaner → Config → Download Orphan Cleaner (arr_download_orphan_cleaner.sh)
- Settings tab → All settings → Download Orphan Cleaner (arr_download_orphan_cleaner.sh)
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
DOWNLOAD_ORPHAN_CLEANER_ENABLED |
a switch | in this section | Weekly sweep of the SABnzbd Completed folders Sonarr/Radarr import from — deletes junk and parse-verified already-in-library leftovers the arr queue no longer references, triggers import scans for anything the library is actually missing. Built 2026-07-26 after 755G of orphaned completed downloads (accumulating since 2022) filled HOST1's cache pool to 89%. Per-host dirs: HOST*_SONARR_DOWNLOAD_D… |
DOWNLOAD_ORPHAN_AGE |
a number box, in days | in this section | days — entries younger than this may be mid-import, never touched |
DOWNLOAD_ORPHAN_MIN_VIDEO_MB |
a number box | in this section | no video file above this = junk (par2 debris, samples, dead archives) |
DOWNLOAD_ORPHAN_MAX_DELETE_GB |
a number box | in this section | abort delete pass over this — a partial queue fetch would classify |
Download Webhook
Route: Settings tab → All settings → Download Webhook
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
DOWNLOAD_WEBHOOK_ENABLED |
a switch | in this section | Immediate push to remote nodes on every Sonarr/Radarr/Lidarr Download event. Prevents remotes from searching for content that is already on disk locally. |
Downloaders Reset
Reachable from:
- Scheduler tab → Downloaders Reset → Config → Downloaders Reset
- Settings tab → All settings → Downloaders Reset
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
DOWNLOADER_RETENTION_DAYS |
a number box, in days | in this section | days — purge history older than this |
QBIT_FAILSAFE_MIN_DAYS |
a number box, in days | in this section | days — minimum age before failsafe deletion |
QBIT_FAILSAFE_MIN_RATIO |
a number box | in this section | 0 = age only, no ratio requirement |
Emby Session Report
Reachable from:
- Scheduler tab → Emby Session Report → Config → Emby Session Report
- Media Stack tab → Media settings → Emby Session Report
- Settings tab → All settings → Emby Session Report
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
EMBY_REPORT_DAYS |
a number box, in days | in this section | days to include in the report period |
EMBY_REPORT_TOP_N |
a number box | in this section | number of top content items to show |
FALLBACK
Reachable from:
- Fallback tab → Fallback settings → FALLBACK
- Settings tab → All settings → FALLBACK
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
EXTERNAL_IP |
a text box | in this section | — |
FALLBACK_CHECK_INTERVAL |
a number box, in seconds | Fallback tab | seconds between fallback state checks |
FALLBACK_HANDBACK_STRIKES |
a number box, in consecutive | Fallback tab | consecutive healthy checks before initiating handback (3×30s = 90s) |
FALLBACK_STATE_FILE |
a text box | in this section | — |
FALLBACK_ENABLED |
a switch | Fallback tab | HOST2 back online |
FALLBACK_PARTNERSHIP_SUSPEND_AFTER |
a number box, in minutes | Fallback tab | minutes without active partnership before suspending |
Failover Test
Reachable from:
- Scheduler tab → Fallback Test → Config → Failover Test
- Settings tab → All settings → Failover Test
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
FALLBACK_TEST_BLOCK_WAIT |
a number box, in seconds | in this section | seconds to wait after blocking connectivity |
FALLBACK_TEST_HANDBACK_WAIT |
a number box, in seconds | in this section | seconds to wait before initiating handback |
Health Digest
Reachable from:
- Scheduler tab → Weekly Health Digest → Config → Health Digest
- Settings tab → All settings → Health Digest
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
DIGEST_PROFILE |
a dropdown (always, smart, weekly) | in this section | always | smart | weekly |
DIGEST_DAY |
a text box | in this section | — |
DIGEST_SMART_ON_WATCHDOG |
a switch | in this section | send if any watchdog strikes are active |
DIGEST_SMART_ON_FALLBACK |
a switch | in this section | send if fallback state is not NORMAL |
DIGEST_SMART_ON_CERT_WARN |
a switch | in this section | send if any cert is under CERT_WARN_DAYS |
DIGEST_SMART_ON_BANDWIDTH |
a switch | in this section | send if any transfer exceeded BANDWIDTH_WARN_GB |
Intermediate Sync Maintenance
Reachable from:
- Scheduler tab → Intermediate Sync Maintenance → Config → Intermediate Sync Maintenance
- Settings tab → All settings → Intermediate Sync Maintenance
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
INTERMEDIATE_MAINTENANCE_SCRIPTS |
a list, one entry per line | in this section | — |
LOGGING
Route: Settings tab → All settings → LOGGING
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
ENABLE_LOGGING |
a switch | Settings tab | Controls verbose [LOG] output across all scripts. true = show detailed [LOG] lines — useful for debugging or first-time setup false = show only user-facing output — cleaner for scheduled runs |
Media Cleaner
Reachable from:
- Scheduler tab → Media Cleaner → Config → Media Cleaner
- Media Stack tab → Media settings → Media Cleaner
- Settings tab → All settings → Media Cleaner
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
ANIME_FILE_PATTERNS |
a list, one entry per line | in this section | — |
MEDIA_FILE_PATTERNS |
a list, one entry per line | in this section | — |
Media Permissions
Reachable from:
- Scheduler tab → Media Shares Permissions → Config → Media Permissions
- Scheduler tab → Bulk Permissions Repair → Config → Media Permissions
- Scheduler tab → Trailer Folder Migration → Config → Media Permissions
- Media Stack tab → Media settings → Media Permissions
- Settings tab → All settings → Media Permissions
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
PERMISSIONS_DIR_MODE |
a text box | in this section | directories — traverse + list, no world-write |
PERMISSIONS_FILE_MODE |
a text box | in this section | files — group read/write, no execute |
PERMISSIONS_OWNER |
a text box | in this section | — |
Monthly Maintenance
Reachable from:
- Scheduler tab → Monthly Maintenance → Config → Monthly Maintenance
- Settings tab → All settings → Monthly Maintenance
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
MONTHLY_MAINTENANCE_SCRIPTS |
a list, one entry per line | in this section | monthly_maintenance.sh fires only when BOTH gates pass: 1. Server uptime >= MONTHLY_UPTIME_THRESHOLD_DAYS days 2. Last run was >= MONTHLY_RUN_INTERVAL_DAYS days ago (or never run) Cron: 0 0 15 * * (15th of the month, midnight — script self-gates, so a spare run is safe) NOT in WATCHDOG_ORCHESTRATOR_SCRIPTS — has its own cron entry. Add scripts that require a long-stable settled system — scrubs,… |
MONTHLY_UPTIME_THRESHOLD_DAYS |
a number box | in this section | minimum uptime in days before maintenance fires |
MONTHLY_RUN_INTERVAL_DAYS |
a number box | in this section | minimum days since last run before running again |
MONTHLY_LAST_RUN_FILE |
a text box | in this section | — |
Mover
Reachable from:
- Scheduler tab → Mover Stop → Config → Mover
- Settings tab → All settings → Mover
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
MOVER_STOP_TIMEOUT |
a number box, in seconds | in this section | Seconds to wait before mover_stop.sh sends SIGTERM to the mover process. Gives mover time to finish current file transfer before being interrupted. |
NOTIFICATIONS
Route: Settings tab → All settings → NOTIFICATIONS
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
NOTIFY_UNRAID |
a switch | Settings tab | unRAID native notification system — integrates with the bell icon in the WebGUI. normal = job completed successfully / warning = something failed or needs attention |
WEBHOOK_PORT |
a number box | in this section | Upgrade webhook — standalone PHP listener that receives OnUpgrade events from Sonarr/Radarr/Lidarr and immediately pushes the upgraded file to all mesh nodes. Bypasses Unraid nginx auth — the secret in the URL is the only gate. Run Tools/webhook_setup.sh once to register the connection in each arr. WEBHOOK_PORT 0 disables the listener. |
WEBHOOK_SECRET |
a masked box with a Show button | in this section | auto-generated on first start if empty |
Network Watchdog
Reachable from:
- Scheduler tab → Network Watchdog → Config → Network Watchdog
- Watchdog tab → Watchdog settings → Network Watchdog
- Settings tab → All settings → Network Watchdog
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
NETWORK_WATCHDOG_ENABLED |
a switch | in this section | Services-layer connectivity — internet reachability, DDNS sync, Tailscale, NPM proxy. Host-specific values (domain, container, NPM URL) live in host*.conf. |
NETWORK_WATCHDOG_INTERNET_URL |
a text box | in this section | — |
NETWORK_WATCHDOG_INTERNET_TIMEOUT |
a number box | in this section | — |
NETWORK_WATCHDOG_CHECK_TAILSCALE |
a switch | in this section | — |
NETWORK_WATCHDOG_NPM_TIMEOUT |
a number box | in this section | — |
NETWORK_WATCHDOG_NPM_STRIKE_LIMIT |
a number box | in this section | — |
NETWORK_WATCHDOG_NPM_STATE_FILE |
a text box | in this section | — |
OOM Bypass Settings
Reachable from:
- Scheduler tab → Stability Watchdog → Config → OOM Bypass Settings
- Settings tab → All settings → OOM Bypass Settings
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
SYS_WATCHDOG_OOM_LIMIT |
a number box | in this section | OOM kills in one cycle to trigger bypass |
PARTNERSHIP
Reachable from:
- Settings tab → All settings → PARTNERSHIP
- Partnership tab → Array Settings → PARTNERSHIP
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
PARTNERSHIP_ENABLED |
a switch | Fallback tab | — |
PARTNERSHIP_OWNER_HOST |
a text box | in this section | "HOST1" or "HOST2" — flips on --transfer |
PARTNERSHIP_GRACE_HOURS |
a number box, in hours | in this section | hours after offboard before Tailscale removal |
PARTNERSHIP_OFFLINE_THRESHOLD |
a number box, in days | in this section | days either server unreachable before auto-offboard |
PARTNERSHIP_BLOCKLIST_FILE |
a text box | in this section | Partnership and setup state files — all in STATE_DIR per the project requirement. Scripts use these variables; do not hardcode /boot/config paths in scripts. |
VARAVERK_SETUP_FILE |
a text box | in this section | — |
PARTNERSHIP_REMOVE_TAILSCALE |
a switch | in this section | remove mirror from Tailscale tailnet on offboard |
TAILSCALE_API_KEY |
a masked box with a Show button | in this section | tskey-api-... |
TAILSCALE_TAILNET |
a text box | in this section | your tailnet name (e.g. yourname.github) |
PARTNERSHIP_TRANSFER_CONFIRM |
a text box | in this section | Transfer safety. |
PARTNERSHIP_TRANSFER_STRIKES |
a number box, in consecutive | in this section | consecutive health checks required |
PARTNERSHIP_TRANSFER_MAX_ATTEMPTS |
a number box | in this section | max health check attempts before giving up |
PARTNERSHIP_ONBOARD_VERIFY |
a switch | in this section | verify WebUI reachable after reconfiguration |
PARTNERSHIP_ONBOARD_NOTIFY |
a switch | in this section | notify both servers on completion |
PARTNERSHIP_SYNC_INTERVAL |
a number box, in minutes | in this section | minutes — informational, actual schedule in cron |
SSH_MAX_STRIKES |
a number box, in consecutive | in this section | consecutive SSH auth failures before critical notify |
SSH_STRIKE_RESET_HRS |
a number box, in hours | in this section | hours since last failure before strike counter resets |
PARTNERSHIP_FOLDERVIEW3 |
a switch | in this section | create/remove FolderView3 folder on onboard/offboard |
PARTNERSHIP_FOLDERVIEW3_URL |
a text box | in this section | CA plugin URL — leave empty to skip auto-install |
PCIe AER Quiet
Route: Settings tab → All settings → PCIe AER Quiet
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
PCIE_QUIET_ENABLED |
a switch | in this section | Devices are listed per host in host*.conf as HOST*_PCIE_QUIET_DEVICES. Off by default — turn on only after filling in that list for this host. |
PER-HOST CONTAINER LISTS
Route: Settings tab → All settings → PER-HOST CONTAINER LISTS
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
RW_ENABLED |
a switch | in this section | — |
RW_STATE_FILE |
a text box | in this section | — |
PHP-FPM
Reachable from:
- Scheduler tab → Php Fpm Max Children → Config → PHP-FPM
- Settings tab → All settings → PHP-FPM
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
PHP_CONF |
a text box | in this section | Higher max_children allows more concurrent PHP requests to the unRAID WebGUI. Default is very low — increasing it prevents WebGUI slowdowns under load. 250 is safe for servers with 32GB+ RAM. |
PHP_MAX_CHILDREN |
a number box | in this section | — |
Play State Sync
Reachable from:
- Scheduler tab → Play State Sync → Config → Play State Sync
- Media Stack tab → Media settings → Play State Sync
- Settings tab → All settings → Play State Sync
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
PLAY_SYNC_ENABLED |
a switch | in this section | — |
PLAY_SYNC_REMOTE |
a switch | in this section | sync across hosts via Tailscale |
PLAY_SYNC_TYPES |
a text box | in this section | Audio excluded — music library too large; favorites handled separately |
PLAY_SYNC_FAV_TYPES |
a text box | in this section | union sync — never unmarks; Audio tracks future |
PLAY_SYNC_PROBE |
a switch | in this section | hash fetched state, skip per-item comparison when nothing changed |
PLAY_SYNC_PROBE_MAX_AGE_HOURS |
a number box | in this section | force a full comparison when the fingerprint is older than this |
Play State Sync — Handback
Reachable from:
- Scheduler tab → Play State Sync → Config → Play State Sync — Handback
- Scheduler tab → Fallback → Config → Play State Sync — Handback
- Media Stack tab → Media settings → Play State Sync — Handback
- Settings tab → All settings → Play State Sync — Handback
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
PLAY_SYNC_HANDBACK_RETRIES |
a number box, in attempts | in this section | attempts before giving up and proceeding to DNS cutover |
PLAY_SYNC_HANDBACK_RETRY_DELAY |
a number box, in seconds | in this section | seconds between retry attempts |
Pressure Thresholds
Reachable from:
- Scheduler tab → Resource Watchdog → Config → Pressure Thresholds
- Settings tab → All settings → Pressure Thresholds
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
RW_RAM_SOFT_GB |
a number box | in this section | throttle start — reduce background load |
RW_RAM_MEDIUM_GB |
a number box | in this section | pause background containers |
RW_RAM_HARD_GB |
a number box | in this section | stop optional containers (was SYS_WATCHDOG_MEM_SHUTDOWN_GB) |
RW_RAM_RECOVER_GB |
a number box | in this section | RAM must reach this before restoring hard-stopped containers |
RW_LOAD_SOFT_MULTIPLIER |
a text box | in this section | soft pressure: 2× cores sustained |
RW_LOAD_MEDIUM_MULTIPLIER |
a text box | in this section | medium pressure: 3× cores sustained |
RW_RECOVER_CYCLES |
a number box, in consecutive | in this section | Consecutive runs at lower pressure before de-escalating |
RAM Reboot Threshold
Reachable from:
- Scheduler tab → Stability Watchdog → Config → RAM Reboot Threshold
- Settings tab → All settings → RAM Reboot Threshold
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
SYS_WATCHDOG_MEM_GB |
a number box | in this section | strike system → reboot |
Reboot
Reachable from:
- Scheduler tab → Server Reboot → Config → Reboot
- Settings tab → All settings → Reboot
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
REBOOT_SLEEP |
a number box, in seconds | in this section | Seconds of warning broadcast to logged-in users before server_reboot.sh reboots. Gives users time to save work — 300s = 5 minutes. |
REBOOT_VM_WAIT |
a number box, in seconds | in this section | Seconds to wait for graceful VM shutdown (ACPI signal via virsh) before libvirt stops it anyway — reboot takes priority. |
Remote Docker Daemon
Reachable from:
- Docker tab → Docker settings → Remote Docker Daemon
- Settings tab → All settings → Remote Docker Daemon
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
REMOTE_DOCKER_STRIKE_LIMIT |
a number box, in consecutive | in this section | consecutive failures before critical notify |
Remote Health Checks
Route: Settings tab → All settings → Remote Health Checks
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
ROOTFS_WARN |
a number box | in this section | Pre-flight — aborts if remote rootfs (/) usage is at or above this percentage. When remote array is down, rsync writes land on rootfs and fill it rapidly. |
Rsync Defaults
Reachable from:
- Scheduler tab → Rsync → Config → Rsync Defaults
- Rsync tab → Rsync settings → Rsync Defaults
- Settings tab → All settings → Rsync Defaults
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
BW_LIMIT |
a number box, in kb | Rsync tab | KB/s — 12500 ≈ 100Mbit |
RETRY_COUNT |
a number box | Rsync tab | retry attempts before giving up |
SLEEP |
a number box, in seconds | Rsync tab | seconds between retry attempts |
RSYNC_MAX_RUNTIME_HOURS |
a number box | in this section | cap per transfer attempt — pauses and resumes next scheduled run |
CRITICAL_CONTAINER_NAMES |
a list, one entry per line | in this section | — |
DELAYED_CONTAINERS |
a list, one entry per line | in this section | — |
CONTAINER_DELAY |
a number box, in seconds | in this section | seconds before starting delayed containers |
RESTART_VERIFY_WAIT |
a number box, in seconds | in this section | seconds to wait after restart before checking container is running |
EXCLUDE_DIRS |
a list, one entry per line | in this section | — |
DEFAULT_RSYNC_OPTS |
a list, one entry per line | in this section | --inplace writes directly to destination — delta against existing file, better for large media --partial keep partial file on interrupted transfer so next run resumes, not re-transfers --timeout kill stalled transfers instead of hanging indefinitely --numeric-ids use UIDs/GIDs numerically — prevents ownership mismatches between servers --delete intentionally omitted — the per-arr cleanups (lida… |
Rsync Enable/Disable
Reachable from:
- Scheduler tab → Rsync → Config → Rsync Enable/Disable
- Rsync tab → Rsync settings → Rsync Enable/Disable
- Settings tab → All settings → Rsync Enable/Disable
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
RSYNC_ENABLED |
a switch | in this section | Tier 1 — global gate, overrides everything below |
CRITICAL_RSYNC_ENABLED |
a switch | in this section | Tier 2 — critical_sync_maintenance.sh rsync section |
INTERMEDIATE_RSYNC_ENABLED |
a switch | in this section | Tier 2 — intermediate_sync_maintenance.sh rsync section |
DAILY_RSYNC_ENABLED |
a switch | in this section | Tier 2 — daily_sync_maintenance.sh rsync section |
WEEKLY_RSYNC_ENABLED |
a switch | in this section | Tier 2 — weekly_sync_maintenance.sh rsync section |
MONTHLY_RSYNC_ENABLED |
a switch | in this section | Tier 2 — monthly_maintenance.sh rsync section |
FALLBACK_RSYNC_ENABLED |
a switch | Fallback tab | Tier 2 — fallback.sh writeback jobs on handback |
MEDIA_SEED_ENABLED |
a switch | Partnership tab | Tier 2 — Rsync/media_seed.sh, the onboard first-fill of a new partner |
Rsync Merge Auto-Promote
Reachable from:
- Scheduler tab → Rsync → Config → Rsync Merge Auto-Promote
- Rsync tab → Rsync settings → Rsync Merge Auto-Promote
- Settings tab → All settings → Rsync Merge Auto-Promote
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
RSYNC_MERGE_ENABLED |
a switch | in this section | When enabled, rsync.sh pre-scans the remote before syncing and promotes to merge mode (pull-then-push) if ≥75% of remote top-level entries exist locally. Named profiles are always excluded from auto-promote regardless of this toggle. |
Rsync Profile System
Reachable from:
- Scheduler tab → Rsync → Config → Rsync Profile System
- Rsync tab → Rsync settings → Rsync Profile System
- Settings tab → All settings → Rsync Profile System
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
PROFILE_RSYNC_OPTS |
a list, one entry per line | in this section | — |
PROFILE_BW_LIMIT |
a list, one entry per line | in this section | Per-profile bandwidth limits in KB/s |
PROFILE_SLEEP |
a list, one entry per line | in this section | Seconds between retry attempts — only non-default profiles listed (default SLEEP applies otherwise) |
PROFILE_CRITICAL_CONTAINER_NAMES |
a list, one entry per line | in this section | Containers stopped on BOTH LOCAL and REMOTE before rsync. Local stops first — flushes databases cleanly. Remote stops next — prevents writes. Only running containers get restarted — stopped containers stay stopped. SPACE-SEPARATED STRINGS — converted to array at runtime |
PROFILE_DELAYED_CONTAINERS |
a list, one entry per line | in this section | Containers needing a delay after rsync before starting. SPACE-SEPARATED STRINGS — converted to array at runtime |
PROFILE_CONTAINER_DELAY |
a list, one entry per line | in this section | Seconds before starting delayed containers — only non-default profiles listed (default CONTAINER_DELAY applies otherwise) |
PROFILE_EXCLUDE_DIRS |
a list, one entry per line | in this section | Directories excluded from rsync per profile. SPACE-SEPARATED STRINGS — converted to array at runtime |
PROFILE_REMOTE_RESTART_CONTAINERS |
a list, one entry per line | in this section | Remote restart after dirty sync — restart these on remote IF they were running before sync. Same logic as stop/start — was stopped = stays stopped, was running = gets restarted. Used by dirty sync profiles (critical-fallback) so remote picks up changes. SPACE-SEPARATED STRINGS — converted to array at runtime |
SABnzbd Throttle
Reachable from:
- Scheduler tab → Resource Watchdog → Config → SABnzbd Throttle
- Settings tab → All settings → SABnzbd Throttle
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
RW_SABNZBD_ENABLED |
a switch | in this section | Speed values: "50M" = 50 MB/s, "0" = unlimited |
RW_SABNZBD_SPEED_SOFT |
a text box | in this section | — |
RW_SABNZBD_SPEED_MEDIUM |
a text box | in this section | — |
SMART Health
Reachable from:
- Scheduler tab → Smart Health → Config → SMART Health
- Settings tab → All settings → SMART Health
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
SMART_TEMP_WARN |
a number box | in this section | fallback — Celsius warn threshold |
SMART_TEMP_CRIT |
a number box | in this section | fallback — Celsius critical threshold |
Strike and Reboot Loop Settings
Reachable from:
- Scheduler tab → Stability Watchdog → Config → Strike and Reboot Loop Settings
- Settings tab → All settings → Strike and Reboot Loop Settings
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
SYS_WATCHDOG_STRIKE_LIMIT |
a number box, in consecutive | in this section | consecutive failures before reboot trigger |
SYS_WATCHDOG_REBOOT_LIMIT |
a number box | in this section | Reboot loop protection — if system keeps rebooting something is seriously wrong. After REBOOT_LIMIT reboots in REBOOT_WINDOW_HRS → shutdown instead of reboot. |
SYS_WATCHDOG_REBOOT_WINDOW_HRS |
a number box | in this section | — |
Sunday Morning Coffee Report
Reachable from:
- Scheduler tab → Sunday Morning Coffee Report → Config → Sunday Morning Coffee Report
- Settings tab → All settings → Sunday Morning Coffee Report
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
COFFEE_REPORT_SCRIPTS |
a list, one entry per line | in this section | Orchestrator that runs all Sunday monitor scripts in sequence. Schedule: 0 7 * * 0 (Sunday 7am — after weekly_sync_maintenance.sh finishes at ~3am) Each script runs independently and notifies on its own findings. |
Syslog Filter
Reachable from:
- Scheduler tab → Docker Syslog Filter → Config → Syslog Filter
- Settings tab → All settings → Syslog Filter
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
FILTER_FILE |
a text box | in this section | Path for the rsyslog filter file that suppresses Docker veth interface noise. Docker creates a new veth interface for each container — generates hundreds of log lines per hour that have no diagnostic value. Filter removes them at source. |
System Tuning Monitor
Reachable from:
- Scheduler tab → System Tuning Monitor → Config → System Tuning Monitor
- Settings tab → All settings → System Tuning Monitor
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
INOTIFY_WARN_PCT |
a number box | in this section | warn if inotify instances exceed this % of limit |
PHP_FPM_WARN_PCT |
a number box | in this section | warn if php-fpm workers exceed this % of max_children |
TUNING_MONITOR_LOG |
a text box | in this section | — |
TUNING_LOG_RETENTION |
a number box, in days | in this section | days before old entries are purged |
System Watchdog
Reachable from:
- Scheduler tab → Watchdog Orchestrator → Config → System Watchdog
- Watchdog tab → Watchdog settings → System Watchdog
- Settings tab → All settings → System Watchdog
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
SYSTEM_WATCHDOG_SCRIPTS |
a list, one entry per line | in this section | system_watchdog.sh runs SYSTEM_WATCHDOG_SCRIPTS sequentially each cycle. Called by watchdog_orchestrator.sh — not scheduled directly. |
Thresholds
Route: Settings tab → All settings → Thresholds
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
SYS_WATCHDOG_ROOTFS_PCT |
a number box | in this section | standard strike threshold |
SYS_WATCHDOG_ROOTFS_CRITICAL_PCT |
a number box | in this section | bypass strikes — truly full, writes failing |
SYS_WATCHDOG_LOG_PCT |
a number box | in this section | /var/log usage — log spam indicates something broken |
SYS_WATCHDOG_TMP_PCT |
a number box | in this section | warn + attempt clear |
SYS_WATCHDOG_TMP_CRITICAL_PCT |
a number box | in this section | bypass strikes if clear failed |
SYS_WATCHDOG_ARC_PINNED_PCT |
a number box | in this section | ZFS ARC pinned percentage — ARC not releasing after reclaim = memory stuck |
SYS_WATCHDOG_ARC_RELEASE_PCT |
a number box | in this section | — |
SYS_WATCHDOG_LOAD_MULTIPLIER |
a number box | in this section | Load average multiplier — threshold = MULTIPLIER × CPU core count MULTIPLIER=3 on 16-core = load of 48 before triggering |
SYS_WATCHDOG_ZOMBIE_LIMIT |
a number box | in this section | Zombie process count — large numbers = serious process management failure |
SYS_WATCHDOG_CPU_TEMP_MAX |
a number box | in this section | CPU temperature — sustained high temp causes throttling or kernel panic |
SYS_WATCHDOG_FD_CRITICAL_PCT |
a number box | in this section | bypass strikes — critical tier |
SYS_WATCHDOG_RUNAWAY_CPU_PCT |
a number box | in this section | % single process must sustain |
SYS_WATCHDOG_RUNAWAY_STRIKES |
a number box, in consecutive | in this section | consecutive cycles before warning |
SYS_WATCHDOG_MDSTAT_ERROR_LIMIT |
a number box | in this section | new errors in one cycle before acting |
Timed Mutes
Route: Settings tab → All settings → Timed Mutes
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
WATCHDOG_MUTE_MAX_HOURS |
a number box | in this section | A mute silences one container for a bounded time and then expires on its own. It exists because every other exemption here is permanent — SCAN_IGNORE is a conf edit, an intentional stop lasts until cleared — so a temporary problem gets a permanent workaround that nobody revisits. Capped so "temporary" is enforced rather than intended: a mute longer than this is refused. |
Transcode Management
Reachable from:
- Scheduler tab → Transcode Management → Config → Transcode Management
- Settings tab → All settings → Transcode Management
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
TRANSCODE_MANAGEMENT_SCRIPTS |
a list, one entry per line | in this section | transcode_management.sh runs TRANSCODE_MANAGEMENT_SCRIPTS in order each cron cycle. Schedule: */7 * * * * (every 7 minutes) Order matters — cleanup first so the manager measures real current ramdisk usage, not usage inflated by stale segment files from ended sessions. |
Transcode Manager
Reachable from:
- Scheduler tab → Transcode Management → Config → Transcode Manager
- Scheduler tab → Transcode Manager → Config → Transcode Manager
- Settings tab → All settings → Transcode Manager
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
RAMDISK_PATH |
a text box | in this section | tmpfs mount point — created at array start by ramdisk_setup.sh. Must exist before Emby starts so the symlink resolves correctly. |
TRANSCODE_LINK |
a text box | in this section | Symlink that Emby points at — this path NEVER changes regardless of ramdisk/SSD state. Emby resolves the symlink once per session at start — symlink flips are transparent. Must match the container path configured in Emby's Extra Parameters. |
RAMDISK_SSD_MIN_GB |
a number box | in this section | Minimum free GB on SSD before allowing flip from ramdisk to SSD. |
TRANSCODE_MAX_AGE |
a number box, in minutes | in this section | minutes — HLS segment age before cleanup eligibility |
TRANSCODE_ORPHAN_AGE |
a number box, in minutes | in this section | minutes — files with no matching active session |
TRANSCODE_FLIP_WARN |
a number box | in this section | notify if symlink flips this many times in one hour |
TRANSCODE_OWNER |
a text box | in this section | — |
TRANSCODE_CHMOD |
a text box | in this section | — |
TRANSCODE_MANAGER_MODE |
a text box | in this section | Operating mode — controls symlink direction behaviour. smart — auto-flips between ramdisk and SSD based on thresholds (default) ramdisk — always uses ramdisk, warns if RAMDISK_WARN_GB exceeded but holds ssd — always uses SSD, never flips to ramdisk |
TRANSCODE_STATE_FILE |
a text box | in this section | Daily statistics log — read by weekly_health_digest.sh for transcode summary. |
TRANSCODE_DAILY_LOG |
a text box | in this section | — |
TRANSCODE_LOG_RETENTION |
a number box, in days | in this section | days before old entries purged |
TRANSCODE_CHECK_EMBY |
a switch | in this section | — |
Uptime Probe
Route: Settings tab → All settings → Uptime Probe
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
UPTIME_PROBE_ENABLED |
a switch | in this section | master switch for the per-minute probe |
UPTIME_PROBE_TIMEOUT |
a number box, in seconds | in this section | seconds per domain before it counts as down |
UPTIME_PROBE_LIST_TTL |
a number box, in seconds | in this section | seconds to reuse the domain list from NPM before re-reading it |
Version Parity
Route: Settings tab → All settings → Version Parity
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
UNRAID_VERSION_MISMATCH_ACTION |
a dropdown (warn, abort) | in this section | Controls behaviour when local and remote unRAID versions differ. Major version mismatch always aborts regardless of this setting. "warn" — log warning and continue (safe for minor/patch differences) "abort" — refuse to continue (strict — ensures both sides always match) |
Watchdog Orchestrator
Reachable from:
- Scheduler tab → Watchdog Orchestrator → Config → Watchdog Orchestrator
- Watchdog tab → Watchdog settings → Watchdog Orchestrator
- Settings tab → All settings → Watchdog Orchestrator
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
WATCHDOG_ORCHESTRATOR_SCRIPTS |
a list, one entry per line | in this section | watchdog_orchestrator.sh runs WATCHDOG_ORCHESTRATOR_SCRIPTS in order each cron cycle. Schedule: */15 * * * * (every 15 minutes) NOT in ARRAY_START_SCRIPTS — has its own cron entry. Order matters — resource first (frees pressure), docker second (heals with freed resources), system third (storage + webgui component health), stability last (last line of defense). |
WebGUI Watchdog
Reachable from:
- Scheduler tab → Webgui Watchdog → Config → WebGUI Watchdog
- Watchdog tab → Watchdog settings → WebGUI Watchdog
- Settings tab → All settings → WebGUI Watchdog
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
WEBGUI_URL |
a text box | in this section | Monitors unRAID WebGUI responsiveness — escalates through nginx restart → emhttp restart. Separate from docker_watchdog — this monitors the unRAID UI itself, not containers. |
WEBGUI_TIMEOUT |
a number box, in seconds | in this section | seconds before curl gives up on WebGUI check |
WEBGUI_NGINX_WAIT |
a number box, in seconds | in this section | seconds after nginx restart before rechecking |
WEBGUI_PHP_WAIT |
a number box, in seconds | in this section | seconds after php-fpm restart before rechecking |
WEBGUI_EMHTTP_WAIT |
a number box, in seconds | in this section | seconds after emhttp restart before rechecking |
Weekly Sync Maintenance
Reachable from:
- Scheduler tab → Weekly Sync Maintenance → Config → Weekly Sync Maintenance
- Settings tab → All settings → Weekly Sync Maintenance
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
WEEKLY_MAINTENANCE_SCRIPTS |
a list, one entry per line | in this section | weekly_sync_maintenance.sh stops containers both sides → pulls updates → syncs WEEKLY_SYNC_SHARES → restarts → then iterates WEEKLY_MAINTENANCE_SCRIPTS. Schedule: 30 2 * * 0 (Sunday 2:30am) |
WEEKLY_CONTAINER_UPDATES |
a switch | in this section | Pull updates for WEEKLY_RESTART_CONTAINERS before docker_weekly_restart.sh runs. Set false to skip — docker_weekly_restart.sh still runs regardless. |
MONTHLY_REMAINING_UPDATES |
a switch | in this section | Pull updates for all running containers NOT in daily/weekly managed lists. Ensures every deployed container receives at least one image pull per month. Set false to skip. |
DOCKER_UPDATE_REBUILT_DAILY_FILE |
a text box | in this section | docker_update.sh rebuilds (stop+recreate onto new image) any container whose image changed, in every mode. For daily/weekly, that rebuild is immediately followed by the restart script's own unconditional pass — a container that just got rebuilt would be stopped and started again right after for no reason. docker_update.sh records which containers it rebuilt to these files; docker_daily_restart.… |
DOCKER_UPDATE_REBUILT_WEEKLY_FILE |
a text box | in this section | — |
DOCKER_UPDATE_REBUILT_STALE_HOURS |
a number box | in this section | — |
WEEKLY_SYNC_UPDATES |
a switch | in this section | pull container updates locally during weekly window |
WEEKLY_SYNC_UPDATES_REMOTE |
a switch | in this section | pull container updates on remote via SSH |
ZFS Memory Snapshot
Reachable from:
- Scheduler tab → Zfs Memory Snapshot → Config → ZFS Memory Snapshot
- Settings tab → All settings → ZFS Memory Snapshot
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
ZFS_REPORT_LOG |
a text box | in this section | Weekly ZFS pool health and memory diagnostic report — informational only. |
ZFS_REPORT_ARC_WARN_PCT |
a number box | in this section | warn if ARC using more than this % of its max |
ZFS_REPORT_ARC_FREE_WARN_GB |
a number box | in this section | warn if ARC headroom (max - current) drops below this GB |
ZFS_REPORT_AVAIL_WARN_GB |
a number box | in this section | warn if less than this GB available on ZFS pool |
ZFS_REPORT_DOCKER_TOP |
a number box | in this section | how many top Docker containers to show by memory |
inotify Tuning
Reachable from:
- Scheduler tab → Inotify Tuning → Config → inotify Tuning
- Settings tab → All settings → inotify Tuning
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
INOTIFY_MAX_INSTANCES |
a number box | in this section | default: 128 — max inotify instances per user |
INOTIFY_MAX_WATCHES |
a number box | in this section | default: 8192 — SHARED budget across ALL users/containers |
INOTIFY_MAX_QUEUED_EVENTS |
a number box | in this section | default: 16384 — max events queued before dropping |
qBittorrent Throttle
Reachable from:
- Scheduler tab → Resource Watchdog → Config → qBittorrent Throttle
- Settings tab → All settings → qBittorrent Throttle
Saved into master.conf, which does not need to be opened by hand.
| Setting | Control | Where | What it does |
|---|---|---|---|
RW_QBIT_ENABLED |
a switch | in this section | KB/s — 0 = unlimited |
RW_QBIT_DL_SOFT |
a number box | in this section | 50 MB/s |
RW_QBIT_DL_MEDIUM |
a number box | in this section | 10 MB/s |
Settings deliberately kept out of the UI
These have no control on purpose. They hold the machine's identity and the roots everything else is derived from, and a text box beside a Save button is the wrong shape for a value that decides whether the server recognises itself on next boot.
If one is asked about, give the reason and say it is edited in the conf file directly. Do not describe a route — there is none, and that is the point.
- Cache Roots (
master.conf) —VV_CACHE_ROOT,VV_CACHE_DIR,CONF_RAM_CACHE_DIR,ARR_CACHE_DIR,AI_TOKEN_CACHE_DIR,AI_JOB_DIR,DOCKER_JOB_DIR
The tmpfs half. These must never point at flash, and nothing in a form conveys that. - GIT / REPO (
master.conf) —GITEA_CONTAINER,GITEA_REPO_PATH,GITEA_DOMAIN,TARGET_DIR,GITEA_SSH_KEY,SSH_PORT,GITEA_HTTP_PORT
Where the plugin updates itself from. Wrong here means the next pull is the last one. - HOST IDENTITIES (
master.conf) —HOST1,HOST2
HOST1 and HOST2 are what detect_hosts() matches the local hostname against. Editing one here would change which machine this believes it is. - SHARED HOST CONFIGURATION (
master.conf) —DATA_DIR,DB_DIR,STATE_DIR,AI_DATA_DIR,CACHE_BACKUP_DIR,LOG_ARCHIVE_DIR,BACKUP_DIR,CONF_BACKUP_DIR,PERSISTENT_CONF_CACHE,ARR_CACHE_BACKUP_DIR
DATA_DIR is the single on-disk root — move it and the whole tree follows, including the state the running scripts are holding open. - State Files (
master.conf) —SYS_WATCHDOG_STATE_FILE,DOCKER_WATCHDOG_FAILED_FILE,DOCKER_WATCHDOG_INTENTIONAL_FILE,WATCHDOG_MUTE_FILE,SYS_WATCHDOG_REBOOT_LOG,SYS_WATCHDOG_OOM_FILE
Paths to live state databases, derived from STATE_DIR. Repointing one orphans the state a watchdog is mid-way through writing.