Appdata Cleanup Plus

Appdata Cleanup Plus is a cleanup and recovery plugin for Unraid. It finds orphaned Docker appdata folders, explains why each folder was found, shows size and age information, and lets you quarantine or permanently delete only the folders you select. It is built for servers that have accumulated old containers, renamed apps, template leftovers, and appdata folders that are hard to audit by hand.

• Find orphaned appdata folders from configured appdata sources.
• Review saved-template and filesystem-discovery results in one clean table.
• Use Safe Mode to quarantine first, restore later, and purge only when ready.
• Permanently delete with confirmation when Safe Mode is disabled.
• Track cleanup, quarantine, restore, purge, and failed action results in audit history.

Quick links: Install | Features | Getting Started | Safety Model | Advanced Tools | Documentation | Support

Why Appdata Cleanup Plus

Unraid appdata shares can collect folders long after containers are removed. Manually deciding what is safe to clean means comparing Docker templates, live container mappings, appdata share contents, filesystem paths, and old folder sizes. Appdata Cleanup Plus brings that review into one Settings page with a safer action flow: scan, review, select, dry run, quarantine, restore, purge, or permanently delete with confirmation.

The plugin is intentionally conservative around filesystem operations. Actions use server-side scan snapshots and candidate IDs instead of trusting paths posted from the browser, and protected locations such as share roots, mount points, symlinked paths, quarantine roots, live container mappings, and VM Manager storage paths are guarded before cleanup runs.

Features

Install

Install from Unraid:

1. Open Plugins.
2. Choose Install Plugin.
3. Paste the stable plugin URL:

plugin install https://raw.githubusercontent.com/alexphillips-dev/Appdata-Cleanup-Plus/main/plugins/appdata.cleanup.plus.plg

Dev testing branch:

plugin install https://raw.githubusercontent.com/alexphillips-dev/Appdata-Cleanup-Plus/dev/plugins/appdata.cleanup.plus.plg

Requirements:

• Unraid 7.0.0+
• Docker templates stored in the normal Unraid templates-user path for saved-template detection
• A current major Chrome, Edge, Firefox, or Safari browser
• Manual review before destructive actions

Getting Started

1. Open Settings -> Appdata Cleanup Plus.
2. Use Appdata Sources to confirm the appdata roots the plugin should scan.
3. Click Rescan.
4. Review the ready-to-clean table, folder sizes, last-used ages, paths, and source badges.
5. Select the rows you want to act on.
6. Use Dry Run to preview the action without changing files.
7. Keep Safe Mode on to quarantine selected folders first, then restore or purge from Show Quarantine.

Recommended first cleanup:

• Start with Safe Mode on.
• Select only folders you recognize.
• Run a dry run before the first real cleanup.
• Quarantine instead of deleting until you are comfortable with the results.
• Use History after cleanup to confirm what happened.

Safety Model

Appdata Cleanup Plus is designed to make cleanup understandable before it becomes destructive.

• Safe Mode is on by default, so selected folders are quarantined instead of permanently deleted.
• Permanent delete is only used after Safe Mode is disabled and the delete confirmation checkbox is checked.
• Dry run previews the current action without modifying folders.
• Actions run against server-side scan snapshots.
• Browser requests submit candidate IDs, not arbitrary filesystem paths.
• CSRF validation is required for action requests.
• Share roots, mount points, symlinked path segments, VM Manager managed paths, quarantine roots, and active live container mappings are protected.
• Restore operations preflight collisions before moving folders back out of quarantine.
• ZFS-backed rows require permanent delete and exact dataset mountpoint resolution.

Quarantine And Restore

Quarantine gives you a reversible buffer before permanent removal. When Safe Mode is on, selected folders are moved into a hidden quarantine root and tracked in the quarantine manager.

Default quarantine root:

/mnt/user/appdata/.appdata-cleanup-plus-quarantine

Quarantine manager tools:

• Restore selected folders to their original path.
• Purge selected folders permanently.
• Set or clear purge timers.
• Review original paths, quarantine paths, age, and size.
• Recover tracked entries from quarantine markers when possible.

Restore behavior:

• If the original path is free, the folder is moved back.
• If the original path already exists, the plugin stops and shows a conflict flow.
• Conflicts can be skipped or restored with a generated suffix where supported.

ZFS-Backed Appdata

ZFS support is available for appdata layouts where the visible user-share path and the real dataset mountpoint are different.

Example:

User share root: /mnt/user/appdata
Dataset root:    /mnt/docker_vm_nvme/appdata

Supported behavior:

• Add mappings from user-share roots to real dataset roots.
• Resolve exact dataset mountpoint matches.
• Preview child dataset and snapshot impact before destructive actions.
• Use standard or recursive zfs destroy only when required.
• Keep ZFS-backed rows out of quarantine, because dataset-backed rows cannot be moved like normal folders.

Recommended workflow:

1. Add the ZFS mapping.
2. Rescan.
3. Run Dry Run.
4. Disable Safe Mode only when you intentionally want permanent dataset destroy.
5. Confirm the delete action.

Advanced Tools

Documentation

• CA Store Readiness
• Bug report
• Feature request
• Release / update problem

Support

• Forum support thread: https://forums.unraid.net/topic/197975-plugin-appdata-cleanup-plus/
• GitHub issues: https://github.com/alexphillips-dev/Appdata-Cleanup-Plus/issues

When reporting a problem, include:

• Unraid version
• Appdata Cleanup Plus version
• Browser and browser version
• Screenshot or screen recording if the issue is visual
• The action you were running: scan, dry run, quarantine, restore, purge, or delete
• Relevant modal text or audit history result for failed filesystem actions

Sponsor

If Appdata Cleanup Plus helps your Unraid setup, you can support ongoing development here:

https://buymeacoffee.com/alexphillipsdev