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…
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
Variants
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
- What do you think of Aegis? : r/privacy - Reddit (reddit)
- Why is no one recommending Aegis 2FA? : r/privacy - Reddit (reddit)
- Using Aegis as 2FA, some newbie questions : r/PrivacyGuides - Reddit (reddit)
- Microsoft is forcing the use of their authenticator? (forum)
- Lost password for my 2FA application (Aegis Authenticator) (forum)
- Which Multi-Factor Authentication for GOS? - GrapheneOS Discussion Forum (forum)
Collected 48 days ago - public community threads