Aegis MFA

Aegis MFA is an Unraid plugin that adds two-factor authentication to the Unraid webGUI, using a one-time code from any authenticator app or a passkey to…

  • Plugins
  • Security
  • Tools & Utilities
Aegis MFA is an Unraid plugin that adds two-factor authentication to the Unraid webGUI, using a one-time code from any authenticator app or a passkey to protect the root account.

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.

59/100 Fair

Maintained
82last commit 26 days ago
Popular
2721 GitHub stars
Easy to install
251 install platform, install notes
Light to run
No data
Security check
85no serious findings, tests

Based on 4 of 5 factors.

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

GitHub stars
21
Open issues
0
Last commit
2026-10-26
Latest release
2026.10.26
License
GPL-3.0
Activity
declining

Checked 4 days ago - source: GitHub (Lazaros-Chalkidis/unraid-aegis-mfa)

Resources & Compatibility

Requirements not published yet.

First-install notes

  • Start by initializing the project Run aegis_init_detect with the full path to your project folder, then confirm it using the preview hash it gives you. This creates Aegis's knowledge base (its storage area for project notes and rules); without it, Aegis doesn't know which project to manage. source
  • Deploy adapter rules after init After initialization, run the deploy-adapters command in a normal terminal, not through Aegis's admin page. This writes the rule files that let AI coding tools follow Aegis's process; without them, those tools may not use the setup at all. source
  • Check that context compilation works Test the setup by compiling context for one file you care about. If the result is empty, check that your edge_hints (link rules pointing to folders or file patterns) match the actual file paths, because Aegis uses them to find related documents. source
  • Installation Install the plugin from the Unraid community apps list, scan the generated QR code with any TOTP authenticator app, and enter the 6-digit code after your password to access the webGUI. Backup codes and a trusted-LAN bypass are available for recovery or convenience. source
  • Enable Aegis MFA Install the Unraid plugin, scan the QR code with any authenticator app, and enter a 6-digit code after the password. source
  • Install and enable Install the plugin, scan the QR code with an authenticator app, and enter the 6-digit code after the password. source

Fetched today - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Do I need a reverse proxy or separate subdomain for Aegis MFA?

No. It hooks into Unraid's existing authentication instead of adding a separate Authelia-style reverse-proxy container. The login flow only adds a TOTP code after the password.

Does it protect share users or only root?

On current Unraid, root is the only account the webGUI login accepts, so root enrolls with its own secret and backup codes. Share users appear in the list as having no webGUI sign-in and are outside the enrollment count.

How can I recover access if I lose my phone?

You can use one of the ten single-use backup codes shown during enrollment. Reissue backup codes later by going through the same path, and the old codes keep working until you confirm the new ones.

Can I skip the code from a trusted network?

Yes, you can add IPv4 and IPv6 CIDR networks as trusted LAN bypasses. The password is still required, and the browser's address is shown ready to add with one click.

Where are lockout counters stored?

Lockout counters live in RAM, so brute-force attempts from many addresses do not reach the boot device. Lockout history can optionally persist across reboots through a snapshot written by a ten-minute cron only when something changed.

Answers sourced from github.com

Community

Collected 48 days ago - public community threads