Automatic Disk Unlock

Automatic Disk Unlock is an Unraid plugin that automatically unlocks your encrypted array and encrypted disks at boot time.

  • Plugins
  • Security
  • Tools & Utilities
Automatic Disk Unlock is an Unraid plugin that automatically unlocks your encrypted array and encrypted disks at boot time. The plugin protects your disk encryption key using Shamir's Secret Sharing. Your disk encryption key is stored encrypted on the flash drive, protected by a randomly-generated wrapping key. This wrapping key is split into multiple pieces—you configure how many pieces to create and how many are needed to unlock your drives. At boot, the plugin retrieves the required number of pieces from locations you specify (such as web servers, Secure Shell (SSH) hosts, or DNS (Domain Name System) records), reconstructs the wrapping key, decrypts your disk encryption key, and unlocks your array automatically.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

49/100 Fair

Maintained
79last commit 24 days ago
Popular
209 GitHub stars
Easy to install
251 install platform, install notes
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 4 days ago

GitHub stars
9
Open issues
5
Last commit
2026-10-28
Latest release
2026.05.24.1622
License
GPL-3.0
Activity
rising

Checked today - source: GitHub (dkaser/unraid-auto-unlock)

Resources & Compatibility

Requirements not published yet.

First-install notes

  • Set up the license key first Before first use, activate your license key with the WP-CLI (WordPress command-line) commands `wp acss license set` and `wp acss license activate`, then verify with `wp acss license get --format=json`; without this, the plugin may not be fully usable. Keep the key out of visible files and use a safe place or temporary variable if you are automating, because it is a paid credential. source
  • Know where the logs are saved If settings do not seem to apply, run the WP-CLI command `wp acss logs path` to find the activity/debug log file, often under `wp-content/uploads/automatic-css/`; this shows what the plugin did when something goes wrong. source
  • Use built-in command help Before guessing at a failing command, use WP-CLI's built-in help with `wp help acss` or `wp help acss settings`; this prevents failed setups caused by mistyping flags or missing required values. source
  • Configure unlock before boot Before relying on automatic boot unlock, set the required number of secret-sharing pieces and the locations used to retrieve them. source

Fetched 5 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How do I install and configure Automatic Disk Unlock?

Use the setup instructions to install the plugin and configure it to unlock your encrypted Unraid array at boot time.

Where is the disk encryption key stored?

The disk encryption key is stored encrypted on the flash drive. It is protected by a randomly generated wrapping key.

What external locations can hold key pieces?

You can configure the plugin to retrieve pieces from web servers, SSH hosts, or DNS records.

Can I choose how many key pieces are required to unlock the drives?

Yes. You configure how many pieces to create and how many are needed to reconstruct the wrapping key.

What happens at boot when the plugin runs?

The plugin retrieves the required pieces, reconstructs the wrapping key, decrypts the disk encryption key, and unlocks the array automatically.

Answers sourced from edac.dev, github.com

Community

Collected 48 days ago - public community threads