Manage control reference¶
Generated by Torrentarr.ConfigSchemaGenerator. All maintenance controls are available in Manage. Optional tools stay disabled until configured. Advanced settings preserve custom policies and limits.
| Key | Kind | Default | Meaning |
|---|---|---|---|
Maintenance.Enabled | checkbox | false | |
Maintenance.Scope | select | "managed" | |
Maintenance.Schedule | text | "*/15 * * * *" | |
Maintenance.PlanTtlMinutes | number | 30 | |
Maintenance.MinimumTorrentAgeMinutes | number | 10 | |
Maintenance.ExplicitCategories | tags | [] | |
Maintenance.ExcludedCategories | tags | [] | |
Maintenance.ExcludedTags | tags | [] | |
Maintenance.Orphans.Enabled | checkbox | false | Recycles unreferenced files when recycling is enabled; otherwise permanently deletes them. Requires complete ownership inspection and local path mappings. |
Maintenance.Orphans.MinimumAgeMinutes | number | 1440 | |
Maintenance.Orphans.MaxFilesPerRun | number | 10 | |
Maintenance.Orphans.ExcludePatterns | tags | [] | |
Maintenance.Hardlinks.Enabled | checkbox | false | |
Maintenance.Hardlinks.Tag | text | "noHL" | |
Maintenance.Hardlinks.CountLinksInsideRoot | checkbox | false | Unsupported: leave disabled. Root-scoped hardlink inspection cannot currently run. |
Maintenance.Hardlinks.Categories | tags | [] | |
Maintenance.Hardlinks.ExcludedTags | tags | [] | |
Maintenance.AutomaticManagement.Enabled | checkbox | false | Enables client automatic management, which may relocate content according to category paths. |
Maintenance.AutomaticManagement.IgnoredTags | tags | [] | |
Maintenance.AutomaticManagement.PrivateTag | text | "" | Blank disables private tagging. Existing tags are not automatically removed. |
Maintenance.AutomaticManagement.TrackerErrorTag | text | "issue" | Blank disables tracker-error tagging. Existing tags are not automatically removed. |
Maintenance.Repair.Enabled | checkbox | false | Complete paused torrents are resumed, including intentionally paused torrents. Incomplete torrents are rechecked. |
Maintenance.Repair.MaxPerRun | number | 10 | |
Maintenance.Unregistered.Enabled | checkbox | false | |
Maintenance.Unregistered.GraceMinutes | number | 10 | |
Maintenance.Unregistered.MaxPerTrackerPerRun | number | 10 | |
Maintenance.Unregistered.CompletedOnly | checkbox | false | |
Maintenance.Unregistered.Messages | tags | ["unregistered torrent","torrent not registered","torrent not found","torrent not authorized"] | |
Maintenance.RecycleBin.Enabled | checkbox | false | |
Maintenance.RecycleBin.Path | text | "" | Absolute path visible to Torrentarr. Blank uses .torrentarr-recycle inside the first mapped local root. |
Maintenance.RecycleBin.RetentionDays | number | 30 | Expired recycle files are permanently deleted after this many days. |
Maintenance.RecycleBin.MaxTorrentMovesPerRun | number | 10 | |
Maintenance.RecycleBin.SplitByClient | checkbox | true | |
Maintenance.RecycleBin.SplitByCategory | checkbox | false | |
Maintenance.RecycleBin.ResumeDataPath | text | "" | Optional resume-data backup directory, used when the client supports export. |
Maintenance.Operations.OrphanScan.Enabled | checkbox | false | Explicit operation override. Existing configs without an override retain their legacy enablement. |
Maintenance.Operations.OrphanScan.ExecutionMode | select | "manual" | Manual applies a reviewed preview once. Automatic runs on the saved schedule and remains enabled after restart; no restart is required. |
Maintenance.Operations.OrphanScan.Schedule | text | "15 3 * * *" | Five-field cron expression in UTC. Blank inherits the client schedule. |
Maintenance.Operations.OrphanScan.IncludedCategories | tags | [] | Blank inherits client-wide scope. Entries narrow that scope. |
Maintenance.Operations.OrphanScan.ExcludedCategories | tags | [] | |
Maintenance.Operations.OrphanScan.ExcludedTags | tags | [] | |
Maintenance.Operations.OrphanScan.MaxActionsPerRun | number | null | Blank preserves operation limits. Zero permits no mutations. |
Maintenance.Operations.HardlinkAudit.Enabled | checkbox | false | Explicit operation override. Existing configs without an override retain their legacy enablement. |
Maintenance.Operations.HardlinkAudit.ExecutionMode | select | "manual" | Manual applies a reviewed preview once. Automatic runs on the saved schedule and remains enabled after restart; no restart is required. |
Maintenance.Operations.HardlinkAudit.Schedule | text | "15 4 * * *" | Five-field cron expression in UTC. Blank inherits the client schedule. |
Maintenance.Operations.HardlinkAudit.IncludedCategories | tags | [] | Blank inherits client-wide scope. Entries narrow that scope. |
Maintenance.Operations.HardlinkAudit.ExcludedCategories | tags | [] | |
Maintenance.Operations.HardlinkAudit.ExcludedTags | tags | [] | |
Maintenance.Operations.HardlinkAudit.MaxActionsPerRun | number | null | Blank preserves operation limits. Zero permits no mutations. |
Maintenance.Operations.UnregisteredCleanup.Enabled | checkbox | false | Explicit operation override. Existing configs without an override retain their legacy enablement. |
Maintenance.Operations.UnregisteredCleanup.ExecutionMode | select | "manual" | Manual applies a reviewed preview once. Automatic runs on the saved schedule and remains enabled after restart; no restart is required. |
Maintenance.Operations.UnregisteredCleanup.Schedule | text | "*/30 * * * *" | Five-field cron expression in UTC. Blank inherits the client schedule. |
Maintenance.Operations.UnregisteredCleanup.IncludedCategories | tags | [] | Blank inherits client-wide scope. Entries narrow that scope. |
Maintenance.Operations.UnregisteredCleanup.ExcludedCategories | tags | [] | |
Maintenance.Operations.UnregisteredCleanup.ExcludedTags | tags | [] | |
Maintenance.Operations.UnregisteredCleanup.MaxActionsPerRun | number | null | Blank preserves operation limits. Zero permits no mutations. |
Maintenance.Operations.CategoryReconcile.Enabled | checkbox | false | Explicit operation override. Existing configs without an override retain their legacy enablement. |
Maintenance.Operations.CategoryReconcile.ExecutionMode | select | "manual" | Manual applies a reviewed preview once. Automatic runs on the saved schedule and remains enabled after restart; no restart is required. |
Maintenance.Operations.CategoryReconcile.Schedule | text | "*/15 * * * *" | Five-field cron expression in UTC. Blank inherits the client schedule. |
Maintenance.Operations.CategoryReconcile.IncludedCategories | tags | [] | Blank inherits client-wide scope. Entries narrow that scope. |
Maintenance.Operations.CategoryReconcile.ExcludedCategories | tags | [] | |
Maintenance.Operations.CategoryReconcile.ExcludedTags | tags | [] | |
Maintenance.Operations.CategoryReconcile.MaxActionsPerRun | number | null | Blank preserves operation limits. Zero permits no mutations. |
Maintenance.Operations.AutomaticManagement.Enabled | checkbox | false | Explicit operation override. Existing configs without an override retain their legacy enablement. |
Maintenance.Operations.AutomaticManagement.ExecutionMode | select | "manual" | Manual applies a reviewed preview once. Automatic runs on the saved schedule and remains enabled after restart; no restart is required. |
Maintenance.Operations.AutomaticManagement.Schedule | text | "*/30 * * * *" | Five-field cron expression in UTC. Blank inherits the client schedule. |
Maintenance.Operations.AutomaticManagement.IncludedCategories | tags | [] | Blank inherits client-wide scope. Entries narrow that scope. |
Maintenance.Operations.AutomaticManagement.ExcludedCategories | tags | [] | |
Maintenance.Operations.AutomaticManagement.ExcludedTags | tags | [] | |
Maintenance.Operations.AutomaticManagement.MaxActionsPerRun | number | null | Blank preserves operation limits. Zero permits no mutations. |
Maintenance.Operations.PrivateTagging.Enabled | checkbox | false | Explicit operation override. Existing configs without an override retain their legacy enablement. |
Maintenance.Operations.PrivateTagging.ExecutionMode | select | "manual" | Manual applies a reviewed preview once. Automatic runs on the saved schedule and remains enabled after restart; no restart is required. |
Maintenance.Operations.PrivateTagging.Schedule | text | "*/30 * * * *" | Five-field cron expression in UTC. Blank inherits the client schedule. |
Maintenance.Operations.PrivateTagging.IncludedCategories | tags | [] | Blank inherits client-wide scope. Entries narrow that scope. |
Maintenance.Operations.PrivateTagging.ExcludedCategories | tags | [] | |
Maintenance.Operations.PrivateTagging.ExcludedTags | tags | [] | |
Maintenance.Operations.PrivateTagging.MaxActionsPerRun | number | null | Blank preserves operation limits. Zero permits no mutations. |
Maintenance.Operations.TrackerErrorTagging.Enabled | checkbox | false | Explicit operation override. Existing configs without an override retain their legacy enablement. |
Maintenance.Operations.TrackerErrorTagging.ExecutionMode | select | "manual" | Manual applies a reviewed preview once. Automatic runs on the saved schedule and remains enabled after restart; no restart is required. |
Maintenance.Operations.TrackerErrorTagging.Schedule | text | "*/30 * * * *" | Five-field cron expression in UTC. Blank inherits the client schedule. |
Maintenance.Operations.TrackerErrorTagging.IncludedCategories | tags | [] | Blank inherits client-wide scope. Entries narrow that scope. |
Maintenance.Operations.TrackerErrorTagging.ExcludedCategories | tags | [] | |
Maintenance.Operations.TrackerErrorTagging.ExcludedTags | tags | [] | |
Maintenance.Operations.TrackerErrorTagging.MaxActionsPerRun | number | null | Blank preserves operation limits. Zero permits no mutations. |
Maintenance.Operations.RepairPaused.Enabled | checkbox | false | Explicit operation override. Existing configs without an override retain their legacy enablement. |
Maintenance.Operations.RepairPaused.ExecutionMode | select | "manual" | Manual applies a reviewed preview once. Automatic runs on the saved schedule and remains enabled after restart; no restart is required. |
Maintenance.Operations.RepairPaused.Schedule | text | "*/30 * * * *" | Five-field cron expression in UTC. Blank inherits the client schedule. |
Maintenance.Operations.RepairPaused.IncludedCategories | tags | [] | Blank inherits client-wide scope. Entries narrow that scope. |
Maintenance.Operations.RepairPaused.ExcludedCategories | tags | [] | |
Maintenance.Operations.RepairPaused.ExcludedTags | tags | [] | |
Maintenance.Operations.RepairPaused.MaxActionsPerRun | number | null | Blank preserves operation limits. Zero permits no mutations. |
Maintenance.Operations.RecycleRetention.Enabled | checkbox | false | Explicit operation override. Existing configs without an override retain their legacy enablement. |
Maintenance.Operations.RecycleRetention.ExecutionMode | select | "manual" | Manual applies a reviewed preview once. Automatic runs on the saved schedule and remains enabled after restart; no restart is required. |
Maintenance.Operations.RecycleRetention.Schedule | text | "45 4 * * *" | Five-field cron expression in UTC. Blank inherits the client schedule. |
Maintenance.Operations.RecycleRetention.IncludedCategories | tags | [] | Blank inherits client-wide scope. Entries narrow that scope. |
Maintenance.Operations.RecycleRetention.ExcludedCategories | tags | [] | |
Maintenance.Operations.RecycleRetention.ExcludedTags | tags | [] | |
Maintenance.Operations.RecycleRetention.MaxActionsPerRun | number | null | Blank preserves operation limits. Zero permits no mutations. |
Maintenance.Operations.ErrorRecovery.Enabled | checkbox | false | Explicit operation override. Existing configs without an override retain their legacy enablement. |
Maintenance.Operations.ErrorRecovery.ExecutionMode | select | "manual" | Manual applies a reviewed preview once. Automatic runs on the saved schedule and remains enabled after restart; no restart is required. |
Maintenance.Operations.ErrorRecovery.Schedule | text | "*/5 * * * *" | Five-field cron expression in UTC. Blank inherits the client schedule. |
Maintenance.Operations.ErrorRecovery.IncludedCategories | tags | [] | Blank inherits client-wide scope. Entries narrow that scope. |
Maintenance.Operations.ErrorRecovery.ExcludedCategories | tags | [] | |
Maintenance.Operations.ErrorRecovery.ExcludedTags | tags | [] | |
Maintenance.Operations.ErrorRecovery.MaxActionsPerRun | number | null | Blank preserves operation limits. Zero permits no mutations. |
Maintenance.ErrorRecovery.Enabled | checkbox | false | |
Maintenance.ErrorRecovery.Outcome | select | "keep" | |
Maintenance.ErrorRecovery.States | tags | ["error","missingFiles"] | |
Maintenance.ErrorRecovery.MaxRepairAttempts | number | 1 | |
Maintenance.ErrorRecovery.MaxPerRun | number | 2 | |
Maintenance.ErrorRecovery.RetryMinutes | number | 10 | |
Maintenance.ErrorRecovery.RecheckTimeoutMinutes | number | 60 | |
Maintenance.ErrorRecovery.SustainedFailureMinutes | number | 1440 | |
Maintenance.ErrorRecovery.HealthyResetMinutes | number | 60 | |
Maintenance.RecycleBin.RetentionEnabled | checkbox | true | Independent of recycle storage. Off preserves recycled files indefinitely. |
Maintenance.RecycleBin.MaxFilesDeletedPerRun | number | 100 | |
Maintenance.Orphans.ScanRoots | tags | [] | Explicit local roots to scan. Each must match a path mapping. Blank disables filesystem scanning. |
Maintenance.Orphans.MaxInspectedFilesPerRun | number | 10000 | |
Maintenance.Hardlinks.MaxInspectedTorrentsPerRun | number | 1000 | |
Maintenance.Hardlinks.RemoveClearedTag | checkbox | false | Remove only tags recorded as applied by Torrentarr, when additional hardlinks are found. |
Maintenance.AutomaticManagement.RemoveClearedTrackerErrorTag | checkbox | false | Remove only Torrentarr-owned tags when a tracker is healthy again. |
Maintenance.Repair.ResumeCompleted | checkbox | true | |
Maintenance.Repair.RecheckIncomplete | checkbox | true | |
Maintenance.CategoryMappings | collection | [] | Assign categories by save path; the longest matching path wins. |
Maintenance.CategoryMappings[].ClientPath | text | "" | Absolute path as seen by the torrent client. |
Maintenance.CategoryMappings[].Category | text | "" | Target category. |
Maintenance.CategoryTransitions | collection | [] | Change completed torrents' categories after a delay. |
Maintenance.CategoryTransitions[].From | text | "" | Current category. |
Maintenance.CategoryTransitions[].To | text | "" | Target category. |
Maintenance.CategoryTransitions[].DelayMinutes | number | 0 | |
Maintenance.TrackerAssignments | collection | [] | Assign categories and tags when a tracker URL contains the configured text. |
Maintenance.TrackerAssignments[].TrackerContains | text | "" | Case-insensitive tracker URL match. |
Maintenance.TrackerAssignments[].Category | text | "" | |
Maintenance.TrackerAssignments[].Tags | tags | [] | |
Maintenance.PathMappings | collection | [] | Translate torrent client paths into paths visible to Torrentarr. This does not mount folders or move files. The longest matching client prefix wins. Saved mappings apply at the next worker processing cycle. |
Maintenance.PathMappings[].ClientPath | text | "" | Folder as seen by the torrent client. |
Maintenance.PathMappings[].LocalPath | text | "" | The same folder as seen by Torrentarr, including inside its Docker container. |
Trackers[].Protection.Policy | select | "custom" | |
Trackers[].Protection.MinimumSeedHours | number | 48 | |
Trackers[].Protection.MinimumRatio | number | 1 | |
Trackers[].Protection.AllowClientRatioClearance | checkbox | false | Off by default: a client ratio does not prove tracker credit. OnlyEncodes never clears on ratio. |
Trackers[].Protection.PartialPolicy | select | "preserve" | |
Trackers[].Protection.DownloadThresholdPercent | number | 10 | |
Trackers[].Protection.ThresholdInclusive | checkbox | true | |
Trackers[].Protection.FulfillmentHours | number | null | Blank means no deadline, except OnlyEncodes uses an explicitly unconfirmed 168-hour warning window. A missed deadline never clears protection. |
Trackers[].Protection.DeadlineStart | select | "added" | |
Trackers[].Protection.AdditionalSeedHours | number | 6 | |
Trackers[].Protection.AccountingGraceMinutes | number | 60 | |
Trackers[].Protection.RecoveryReserveHours | number | 6 |