About multi-factor authentication
Multi-factor authentication uses a combination of two or three different ways to authenticate your identity:
- Something you know (like a password).
- Something you have (like a code generated by a device or service only you have access to).
- Who you are (indicated by some biometric such as a fingerprint).
If you enable multi-factor authentication for Home Assistant Cloud, in addition to your password, you will be asked for a code from a multi-factor authentication application such as Google Authenticator.
This page shows you how to enable multi-factor authentication (MFA) for Home Assistant Cloud, and how to disable it again later.
Enabling multi-factor authentication (MFA) for Home Assistant Cloud
Step-by-step instructions on enabling multi-factor authentication (MFA) to log in to your Home Assistant Cloud account.
Prerequisites
- A Home Assistant Cloud account
- Home Assistant version 2025.1.0 or later
- If you're unsure what version you're running, in Home Assistant, open Settings > About.
- If you are running an older version, and have MFA enabled on Home Assistant Cloud, you won't be able to log into Cloud from Home Assistant. You will need to update Home Assistant first.
- Administrator rights in Home Assistant
- A multi-factor authentication application. For example:
- A dedicated authenticator app on your phone, such as
- A password manager with authenticator capabilities, such as
- 1Password
- If you are using a password manager for this, make sure you have added an entry for your Home Assistant Cloud account.
- Then, add a section in that entry for one-time password (OTP)
To enable multi-factor authentication (MFA) for Home Assistant Cloud
- On the Nabu Casa account page, log into your account.
- Under Manage account -> Multi-factor authentication, select Enable MFA.
- Result: A QR code and a setup code are displayed.
- To add Home Assistant Cloud to your authenticator app, follow the instructions on screen:
- Open your authenticator app.
- In the app, either scan the QR code or copy and paste the code manually into the authenticator app.
- If you are not using a dedicated authenticator app but a password manager, in the entry for the Home Assistant Cloud login, enter a section for one-time password and enter the code there.
- Result: The app generates a one-time code.
- On the Nabu Casa website, enter the code.
- Result: Multi-factor authentication is enabled.
- From now on, you need the authenticator app to generate a code every time you log into Home Assistant Cloud.
Disabling multi-factor authentication (MFA) for Home Assistant Cloud
Follow these steps to disable multi-factor authentication (MFA) for your Home Assistant Cloud account.
Prerequisites
- Have multi-factor authentication (MFA) enabled for Home Assistant Cloud
- Have access to the multi-factor authentication application you used to set MFA up
To disable multi-factor authentication (MFA) for Home Assistant Cloud
- Log into your Home Assistant Cloud account.
- Under Manage account > Multi-factor authentication, select Disable MFA.
- Result: Multi-factor authentication is disabled.
- When logging into Home Assistant Cloud, you will no longer be prompted to provide a one-time code.
Troubleshooting
I lost the device that I use to generate the MFA token
Symptom
You have multi-factor authentication enabled to log in to Home Assistant Cloud. Now, you lost the device that is used to generate the multi-factor authentication token. For example, you lost the phone that has the authenticator app installed.
Resolution
Submit a ticket to our Customer Support team.