FAQ

Frequently Asked Questions

Does FolderView Plus move or rename containers and VMs?

No. It stores organization, presentation, and eligible action configuration. Native Docker/VM configuration remains in Unraid.

Can one member appear in several folders?

A member should normally have one effective folder. Overlapping rules and legacy labels can create conflicts; use the rule simulator/conflict inspector.

Are Docker and VM folders shared?

No. They use consistent concepts but separate data. Dashboard displays both maps in their corresponding widgets.

Why is a member missing from a collapsed preview?

Preview inclusion is separate from membership. Expand the folder and check the editor Preview tab.

What is the safest import mode?

Merge safely for most migrations. Add new only preserves all existing records. Replace exactly may delete destination folders and should be used only with a verified complete export.

Does Privacy secure the Unraid server?

No. It masks supported rendered values. It is not authentication, authorization, encryption, or a replacement for network security.

Where is configuration stored?

Under /boot/config/plugins/folderview.plus. Runtime package files under /usr/local/emhttp/plugins/folderview.plus are replaceable; /tmp caches are disposable.

Do normal updates delete settings?

No. Normal updates preserve the persistent configuration directory. Uninstall deletes it.

Why will Unraid not reinstall the plugin?

The selected manifest has the same version as the installed plugin. Check branch and version rather than editing version files.

Can I use the development branch permanently?

You can, but it changes frequently and is best-effort prerelease testing. Stable main is recommended for normal operation.

Does the wiki replace release notes?

No. The wiki explains current concepts; GitHub releases describe version-specific changes.

Can I customize CSS?

Yes, but prefer Theme Workspace tokens and documented stable selectors. Broad custom CSS/JS is a common cause of clipping, blank pages, and observer conflicts.

Why does safe mode leave the native Docker page unchanged?

FolderView Plus detected an unknown or future host surface and chose not to inject legacy grouping. This protects native Unraid behavior and saved data.

How do I back up everything?

Copy the entire /boot/config/plugins/folderview.plus directory off-server. Environment export is portable configuration, but it does not contain uploaded custom-icon binaries, saved folder-template files, or local history. Type-specific snapshots remain useful for quick Docker/VM rollback.

Why are there several kinds of templates?

Starter folder templates create an initial layout, rule templates build common matchers, saved folder templates reuse folder settings, and Setup Assistant presets remember wizard choices in the browser. See Automation, Rules, and Templates.

What should I attach to a public issue?

A sanitized support bundle, copied diagnostic summary, reproduction steps, versions, and privacy-reviewed screenshots. Never attach raw environment/configuration exports.

Where do I request a feature?

Use the GitHub issue chooser.