Repository navigation
Settings Reference
Open Settings -> FolderView Plus. Settings search matches visible labels and common aliases; change search scope to include all Advanced workspaces when needed.
Search supports non-Latin text. Search and filtering remain presentation controls and do not change saved folder membership.
| Mode | Purpose |
|---|---|
| Basic | Everyday Docker/VM folder lists, search, filters, sorting, add, import, export, clear, folder defaults, view/display preferences, and Setup Assistant. |
| Advanced | Workflows: Operations, Bulk assignment, Rules, Docker start order. Appearance: Themes, then Appearance. Support: Recovery, Diagnostics, Logs. |
Preferences save automatically. Operations that can replace or delete configuration use a separate preview, confirmation, safety backup, or progress flow.
Background reloads preserve pending folder-tree choices and newer Appearance drafts instead of replacing them with an older response. Wait for a reported save to complete before leaving; a visible failure still requires review.
On initial loading, saved folder tables are prepared first. Background Docker/VM inventory enrichment waits for core bootstrap, then for localization to settle or its bounded fallback wait to expire. Live counts, status, and inventory-dependent details can finish afterward; this does not remove saved folders or assignments. Explicit manual and diagnostic refreshes retain their normal completion behavior and wait for current runtime data. Startup failures still need investigation; no fixed load time is promised.
On desktop, select a section from the grouped left navigation rail. On a phone, use the section picker above the content. Sections show their full contents; old Compact/Expand section controls are removed.
Screenshot placeholder — current Advanced navigation: capture the grouped rail and mobile picker in stable 2026.11.13.05 with Themes above Appearance and fictional configuration. The previous Advanced image no longer represents this layout.
Each type has its own folder map and preferences.
- Search folders: filters the visible Settings table without deleting anything.
- Filters/View settings: opens layout, badges, runtime, defaults, Dashboard, health, privacy, and column controls.
- Add folder/group: creates one folder, preconfigured groups, or your own saved group of folder names and icons. Open a created folder's editor for its hierarchy, membership, and other settings. See Create a folder.
- Setup Assistant: starts guided setup or migration.
- Export all: downloads the selected type's configuration.
- Import: validates and previews an import.
- Clear: creates a safety point and removes the selected folder configuration after confirmation.
- Sort: Created order, Created newest, Created oldest, Last updated, Manual, Name A–Z, or Name Z–A.
- Quick filters: Pinned, Stopped, Empty, No rules, and Has updates where supported. These filter Settings temporarily; they do not delete or reorder folders.
- Order controls: desktop drag handles and tree-move actions, plus Mobile reorder for touch/small screens. Before/after moves switch sorting to Manual.
- Hierarchy controls: Tree scan, Tree repair, and inline tree undo/redo.
- Folder defaults: Edit folder defaults opens the saved Docker/VM starting profile directly. Save as defaults changes future folders; Apply to all explicitly updates existing folders; Clear removes the saved starting profile.
Each Basic source has a responsive toolbar with search, sort, Add Folder Group, Export all, Import, Restore, and Clear. Folder names include direct-member and immediate-child counts. The former Path bar and redundant Filters button are removed; Filters and view settings remains available from its heading.
Advanced -> Logs records recent operations. What Changed displays categorized notes for the installed version and can be dismissed without changing settings or update state.
| Group | Setting | Default / choices | What it changes |
|---|---|---|---|
| Layout | Application/name width | Compact, Standard, Wide | Space reserved for names on runtime pages. |
| Layout | Hide empty folders | Off | In Manage Folders, hides a folder only when it and every descendant have no effective containers or VMs. Populated child branches keep their ancestors visible. |
| Status | Calculation | Summary or Dominant | How member state becomes a folder state. |
| Status | Display detail | Simple, Balanced, Detailed | Amount of status information shown. |
| Status | Trend and attention accent | On | Adds state-change context and visual attention. |
| Status | Stopped warning threshold | 60%, range 0–100 | Warning point for stopped-member summaries. |
| Badges | Running | On | Shows the running status indicator. |
| Badges | Stopped | On | Shows the stopped status indicator. The one-time migration introduced in 2026.10.20.11 enables it when older Docker/VM preferences first load; it does not repeat on every update, and later opt-outs remain saved. |
| Badges | Updates | Docker only, on | Shows update availability. |
| Runtime | Live refresh | Off | Periodically reconciles runtime state. |
| Runtime | Refresh interval | 20 seconds, range 10–300 | Frequency when live refresh is enabled. |
| Runtime | Performance profile | Standard, Adaptive, Maximum | Motion, preview, refresh, and restoration safeguards. |
| Runtime | Lazy preview | Off | Defers heavier preview work beyond a threshold. |
| Runtime | Lazy threshold | 30, range 10–200 | Folder/member scale at which lazy preview begins. |
| Runtime | Theme compatibility | Auto, Host, Safe, High contrast | How runtime colors/tokens are resolved. |
Docker also provides FolderView, Host list, and Command page-view modes. The eight-card Docker grid keeps title appearance in Layout and status calculation/detail, attention, warning, empty-folder, and badge controls in Status and badges. Other cards remain Runtime, Folder defaults, Dashboard, Health summary & Docker scoring, Privacy masking, and Columns.
All badge types are enabled for a new configuration. Existing Running and Docker Updates choices remain saved; the Stopped choice is enabled once on upgrade, after which user changes persist. Badge and empty-folder visibility changes update already-open Docker/VM pages, including from another tab. Docker page-view changes also refresh the open page. Global badge choices control the corresponding indicators; per-folder update-column overrides remain authoritative.
Open Settings -> FolderView Plus -> Basic -> Docker -> Filters and view settings -> Layout and enable the Docker page title. It is disabled by default; enabling it starts with Change Me!. Set the text, font, size, color, and any combination of Bold, Italic, Underline, and Strikethrough. Changes save automatically and the live preview shows the appearance. Reset appearance restores the title formatting defaults.
The title appears at the far left above the Docker containers while the existing right-side controls keep their position. On narrow screens it sits above the controls. Disabling the title retains the saved text and formatting. Privacy with Mask names and icons hides the title.
The font picker offers 22 choices, including 18 bundled fonts, and displays each font name in its typeface. Fonts are served from your Unraid host. Use arrows to navigate, type a font name to find it, Enter to select, or Escape to cancel. Text supports up to 100 characters; size accepts 14–48 px and defaults to 28 px.
Screenshot placeholder — Docker title: capture the Layout controls, compact font previews, all four formatting options, and the left-aligned Docker heading on desktop and phone using fictional text.
Docker and VM widgets support Classic, Legacy, Full Width, Accordion, Inset, Compact Matrix, and Embossed layouts. Controls also cover expand toggle, dimmed collapsed cards, folder labels, and privacy masks. Docker additionally supports native or advanced preview context, click or hover trigger, graph selection, and graph time window. Choosing graph None stays selected after saving and reopening Settings.
- Health cards are enabled by default.
- Runtime summary badges are optional.
- Docker offers strict, balanced, and lenient scoring presets, stopped thresholds, update handling, and all-stopped handling. A warning threshold of 0 is valid. The critical threshold is normalized to at least warning + 5 percentage points, capped at 100; normalized values appear in Settings and remain consistent after reload. Per-folder overrides remain available.
- VM health uses warning/critical vCPU and memory thresholds. Defaults are 16/32 vCPU and 32/64 GiB.
Numeric entries in Filters and view settings keep your active edit if a background refresh or earlier save completes. Commit an entry by moving to the next field; validated or normalized values then appear in the control. Paired sliders stay synchronized with the entry.
The centered Docker Alerts group shows the update button only when the folder has available updates. Health details opens readable member/update/score cards with an inline score such as 85/100, policy thresholds, and reasons. Status color supplements the written health label. The footer includes the matching health filter and Close; long details scroll inside the dialog.
Docker can mask names/icons, LAN IPs, ports, volume paths, image registries, public IPs, network interfaces, and external URLs. VM privacy can mask names/icons, disk paths, MAC addresses, public IPs, network interfaces, and external URLs. See Privacy.
Required columns include Order, Name, and Actions. Optional Docker columns include Members, Status, Rules, Last changed, Pinned, and Alerts. Optional VM columns include Members, Status, Rules, Last changed, Pinned, Autostart, and Resources. Column visibility and widths are presentation preferences; they do not alter folder data.
| Workspace | Contains |
|---|---|
| Bulk assignment | Docker/VM destination, member table, folder/status filters, move preview, confirmation, and retry/undo. |
| Rules | Ordered auto-assignment rules, simulator, conflicts, and troubleshooting. |
| Recovery | Readiness summary, manual/scheduled snapshots, chooser-based compare, restore, download/delete, environment import/export, and Undo latest change. Additional tools offers installed/full-export FolderView3 migration with replacement preview; server-recorded outcomes appear in Logs. |
| Operations | Folder runtime actions and reusable templates. |
| Docker start order | Docker autostart order from folders or custom batches. |
| Themes | Host identity source, palette adaptation, native control sizing, separate managed-theme status/count, GitHub scan/import, activation, disabling, update checks/plans, updates, and deletion. Host themes remain configured in Unraid. |
| Appearance | Customization layer: named profiles with Global/Docker/VM/Dashboard scopes, color presets, token editing, preview, and custom CSS. |
| Diagnostics | Health, recommended repairs, performance retest, runtime captures, integrity, update check, issue report, and support bundle preview/export. |
| Logs | Up to 100 browser-local actions and selected server-recorded events for 30 days, with clear and refresh controls. |
Themes appears directly above Appearance in desktop navigation and the mobile section picker. Aurora can appear as the active host theme with zero imported managed themes. Switching between the tabs retains the customization draft, and operation feedback remains visible in the relevant tab.
Rules previews use the current shared matching contract. Applying assignments requires the reviewed plan to remain current and can explicitly move existing manual assignments; previewing alone writes nothing. See simulator and conflicts before Apply. Diagnostics now includes retained Aurora/column-movement evidence and the known retired-file update cleanup; see Logs, Diagnostics, and Support.
Appearance also provides color preset previews, Undo preset preview, and Save as new profile. Preview changes are not persisted until saved. Auto and Host modes retain saved color overrides through theme refreshes; Safe and High contrast keep recovery colors. See Appearance profiles.
New Docker and VM schedules are enabled every hour with retention of 25 snapshots. Existing saved schedules keep their enabled state and interval. Interval accepts 1–168 hours and retention accepts 1–200. The five-minute cron poll only checks whether a type is due. Run scheduler now runs that due-check; it does not override the configured interval. Routine moves, reorders, preference changes, and pins do not create one snapshot per action.
When due, a scheduled check saves only changed folders/preferences relative to the latest usable backup. Unchanged or empty configurations show Skipped and the reason in Logs. Existing snapshots are retained. Routine check timestamps and server history stay in memory and reset at restart, while saved backup files remain. Recent unchanged checks count toward backup health without treating a stopped scheduler as healthy.
Saving defaults replaces the complete saved starting profile; clearing defaults removes it for future folders. Apply to all reports Updated, Unchanged, and Skipped counts, including a no-op with zero updates.
Restore Latest skips zero-folder snapshots. Direct restore remains available when an empty selected snapshot is intentionally required. See Backup, Recovery, and Migration.
- Wait for the operation or progress surface to finish.
- Reload Settings and confirm the normalized value.
- Check Advanced Logs for a failure.
- Look for a stale-page or conflict banner.
- Run Diagnostics before retrying destructive operations.
FolderView Plus Wiki · Stable releases · Report an issue · Unraid forum · Security reporting