diff --git a/source/_docs/authentication.markdown b/source/_docs/authentication.markdown index 47e2212187d..02d299c9ad5 100644 --- a/source/_docs/authentication.markdown +++ b/source/_docs/authentication.markdown @@ -1,13 +1,23 @@ --- title: "Authentication" -description: "Guide on authentication in Home Assistant." +description: "Documentation on authentication in Home Assistant." --- -Our authentication system secures access to Home Assistant. +The authentication system secures access to Home Assistant. -If you are starting Home Assistant for the first time, or you have logged out, you will be asked for credentials before you can log in. +## Login screen -Screenshot of the login screen +If you log in from within your local network, you are greeted with a login screen showing all the people in Home Assistant. + +Screenshot of the login screen, when logging in from within the local network + +### Privacy: Not showing users when logging in from outside the network + +When logging in from outside your local network, the users are not shown. This is to protect your privacy. In this case, you need to enter your user name. + +You might also see this screen if you are using a Chromium-based browser (Chrome, Edge) and IPv6. Home Assistant might not be able to detect if your are logging in from a local network. This is a known issue with Chromium. + +Screenshot of the login screen, when logging in from within the local network ## User accounts diff --git a/source/images/docs/authentication/login-outside-local-network.png b/source/images/docs/authentication/login-outside-local-network.png new file mode 100644 index 00000000000..369a4d9b777 Binary files /dev/null and b/source/images/docs/authentication/login-outside-local-network.png differ diff --git a/source/images/docs/authentication/login.png b/source/images/docs/authentication/login.png index e1446748c2e..70824522b5d 100644 Binary files a/source/images/docs/authentication/login.png and b/source/images/docs/authentication/login.png differ