Skip to content

Settings Reference

FolderView Plus Test edited this page Nov 13, 2026 · 21 revisions

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.

Settings modes

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.

Basic Docker and VM controls

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.

Shared view settings

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.

Custom Docker page title

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.

Dashboard settings

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 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.

Privacy settings

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.

Settings-table columns

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.

Advanced workspace map

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.

Recovery schedule reference

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.

When a setting seems not to save

  1. Wait for the operation or progress surface to finish.
  2. Reload Settings and confirm the normalized value.
  3. Check Advanced Logs for a failure.
  4. Look for a stale-page or conflict banner.
  5. Run Diagnostics before retrying destructive operations.

Next: Folder Management · Compatibility and Performance

Clone this wiki locally