How to enable 2FA on Home Assistant
Protect your Home Assistant account with two-factor authentication (2FA). Once enabled, signing in also requires a one-time code from your authenticator app — not just your password.
Step-by-step setup
- 1
Sign in to Home Assistant and open your Home Assistant account security settings.
- 2
Turn on two-factor authentication and choose the authenticator-app option.
Look for "Authenticator app", "Authentication app", or "TOTP" rather than SMS.
- 3
Scan the QR code with MS Authenticator App.
Open MS Authenticator App, tap add, and point your camera at the QR code Home Assistant displays. Can't scan? Enter the setup key manually instead.
- 4
Enter the 6-digit code to confirm.
Type the code MS Authenticator App generates to verify and link your Home Assistant account.
- 5
Save your backup codes.
Store the recovery codes Home Assistant gives you somewhere safe — you'll need them if you lose your phone.
Menu names on Home Assistant can change — the official Home Assistant 2FA documentation ↗ always has the exact, current path.
Frequently asked questions
- Does Home Assistant work with authenticator apps like MS Authenticator App?
- Yes. Home Assistant supports TOTP authenticator apps, so you can generate its two-factor codes in MS Authenticator App.
- Is Home Assistant two-factor authentication free?
- Yes. Enabling authenticator-app 2FA on Home Assistant is free — you only need the free MS Authenticator App.
- What if I lose access to my Home Assistant 2FA codes?
- Use the backup or recovery codes you saved during setup. If you didn't save them, contact Home Assistant support to regain access, then re-add the account to MS Authenticator App.
Generate your Home Assistant codes in MS Authenticator App
Free, offline, and encrypted. One tap for every 6-digit code.
Get the appMore IoT guides
Novaz is not affiliated with, endorsed by, or sponsored by Home Assistant. Home Assistant and its logo are trademarks of their respective owner and are used here for identification only.