AutoCompress

A Docker container for Unraid (or any Docker host) that scans folders on a schedule and compresses every sub-folder into its own RAR archive:

• compression level, solid archives, dictionary size, recovery record, RAR threads, optional split volumes and optional password,
• tests each archive and compares it with the folder before anything is removed,
• adds a CRC32 to the file name (Show [14337E9B].rar) or writes an SFV file next to the archive,
• then moves the original folder to the share's Recycle Bin, deletes it, moves it to a trash folder, or keeps it.

Everything is set up in the web UI, which has a live status page, settings, scan history, statistics and themes.

Created entirely by AI (Claude). It has been tested, but not in every situation. It can delete your original folders: try a Dry run first, keep backups of data you can't replace, and do your own due diligence before exposing the web UI to the internet.

Install (Unraid)

Install AutoCompress from the Apps tab, or download the template by hand:

wget -O /boot/config/plugins/dockerMan/templates-user/my-AutoCompress.xml \
  https://raw.githubusercontent.com/rcodehub/Unraid-CA-Apps/main/templates/autocompress.xml

then Docker → Add Container → Template: my-AutoCompress.

Keep only my-AutoCompress.xml in templates-user. If you also have another copy, such as autocompress.xml, Unraid may load it when you edit or update the container, and your paths go back to the defaults.

Template settings

Only change the Host Path side of the paths. On first start /source is set as the source; if /output is mapped the archives go there, and if /trash is mapped compressed folders are moved there. Everything else is configured in the web UI and saved in /data.

Recycle Bin

By default a compressed folder is moved to .Recycle.Bin at the root of its share, with its sub-folder path kept (<share>/.Recycle.Bin/<path inside the share>). This is where the Unraid Recycle Bin plugin keeps files deleted over SMB, so the plugin lists them and empties them on its own schedule. The plugin does not have to be installed; without it the folder simply waits in .Recycle.Bin until you remove it. A name that already exists there gets .1, .2, ... added.

The share's root must be reachable inside the container: map the share itself as the source (instant move), or map all shares (/mnt/user, see the table above). If it is not reachable the run stops before touching anything and Settings explains why. On a fresh install where it is not reachable the folders are kept instead of deleted.

Web UI

• Status – next/last scan, where compressed folders and archives go (including the Recycle Bin location on your server and how many items are in it), progress, what each job is doing (with percent), problems and a live log. Buttons: Run now, Dry run (shows what would happen without changing anything), Compress folder…, Stop, Check CRCs.
• Settings – all options below, with a folder picker and live checks that show each folder's real location on the server.
• History – every scan with counts, sizes and problems.
• Stats – lifetime totals (data compressed, space saved, success rate, speed), a 30-day chart, results per compression level and records.
• Theme – 11 colour themes with light and dark versions, plus corner rounding, spacing, font, shadows and page width. Use ☾/☀ to switch light/dark for your browser.

Settings (web UI)

How it works

For each source folder, every direct sub-folder is a candidate. Empty folders, folders on the skip list, symbolic links and folders that already have an archive of the same name (name.rar, name [CRC].rar or name.part1.rar) are skipped.

Each archive is built in a hidden work folder (.autocompress-…) next to its final place, then:

1. tested with rar t, and the number of files inside is compared with the folder (skipped when Leave out of the archives is used);
2. the CRC32 is calculated and the archive is moved into place under its final name (or an SFV file is written);
3. the folder is checked again – if anything in it changed while it was compressing, the archive is discarded and the folder is left alone, to be tried again on the next scan;
4. only then is the folder moved to the Recycle Bin, deleted or moved.

Nothing is ever overwritten. A folder that fails is left untouched and listed with the reason; scheduled scans do not retry it until its contents change, Run now always does. Symbolic links inside a folder are stored as links, not followed.

Compress folder… is a one-off job that does not depend on the scanned folders or the schedule: choose any folder inside the container and compress it as one archive, or compress each of its sub-folders. It uses the compression settings from the Settings page; for that run you can override what happens to the folder afterwards (delete, move, keep) and the output folder. Folders you pick this way are compressed regardless of the exclude list and the minimum age. It cannot start while a scan is running.

Check CRCs recalculates the CRC of every archive that has one in its name or in an SFV file in the source/output folders and reports any that no longer match.

RAR licence

The rar program is proprietary software by RARLAB (installed from Debian's non-free repository). It runs in trial mode until you register it. If you own a licence, put your rarreg.key in the app data folder (/data) and restart the container.

Versions

The build number (top left of the web UI, and in the container log at start) goes up with every published image. Hover it to see the commit and build time. What changed is in CHANGELOG.md, and the newest entries are also shown in Community Applications. Images are tagged latest and build-N, so you can pin a specific build by setting the repository to ghcr.io/rcodehub/autocompress:build-N.

Docker Compose

See docker-compose.yml.

License

MIT – see LICENSE. (This covers AutoCompress itself, not the RAR program.)