
* Add auth docs * Minor tweak * ✏️ Spelling * ✏️ Spelling * ✏️ Spelling and grammar * Remove impossible
1.9 KiB
layout | title | description | date | redirect_from | sidebar | comments | sharing | footer |
---|---|---|---|---|---|---|---|---|
page | Authentication | Guide on authentication in Home Assistant. | 2018-08-23 09:40 | /components/auth/ | true | false | true | true |
Access to Home Assistant is secured by our authentication system. Each member of your household will get their own user account to log in and access Home Assistant.
Home Assistant contains two different user types: the owner user account and normal users. The owner user account is created when you start Home Assitant for the first time. This account has some special privileges compared to the other users of the system:
- Manage users
- Configure integrations and other settings (soon)
- Configure Hass.io (soon)
{% linkable_title Authentication %}
When a user wants to use Home Assistant, they have to log in. When navigating to the frontend without authentication, the user is asked for a login. The login page will always show you the website that you're logging in to.

When logging in, make sure that the URL in the URL bar is showing the address of your Home Assistant instance.
{% linkable_title Profile %}
Once you're logged in, you can access the profile page to change your user preferences. Here you can change your preferred language or password. You can also log out. You can access the profile page by clicking on your user badge in the sidebar.

{% linkable_title Multi-factor authentication %} (soon)
As a user, you can setup multi-factor authentication like time-based one-time passwords. This is an extra challenge that you have to solve after you finish your login. You will be able to set up these challenges from the profile page once you're logged in.