# 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 protect the root account. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/4228/aegis-mfa

## Description

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.

## Health score

59/100 (Fair), based on 4 of 5 factors.
- Maintained: 82 (last commit 26 days ago)
- Popular: 27 (21 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Security check: 85 (no serious findings, tests)

## Links

- GitHub: https://github.com/Lazaros-Chalkidis/unraid-aegis-mfa
- Unraid: https://ca.unraid.net/apps/aegis-mfa-1jqpihe1bgiv8u?q=Aegis%20MFA

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/4228/aegis-mfa), the self-hosted and open-source app directory.
