diff --git a/source/_docs/authentication.markdown b/source/_docs/authentication.markdown index 6838a31a622..1d55d6b38f3 100644 --- a/source/_docs/authentication.markdown +++ b/source/_docs/authentication.markdown @@ -50,6 +50,24 @@ While you should hopefully be storing your passwords in a password manager, if y When you start Home Assistant next you'll be required to set up authentication again. +### {% linkable_title Error: invalid client id or redirect url%} + +Screenshot of Error: invalid client id or redirect url + +You have to use a domain name, not IP address to remote access Home Assistant; otherwise you will get **Error: invalid client id or redirect url** error on the login form. However, you can use the IP address to access Home Assistant in your home network. + +It because we only allow using IP address as client ID when your IP address is one of internal network address (e.g., 192.168.0.1) or loopback address (e.g., 127.0.0.1). + +If you don't have a valid domain name for your Home Assistant instance, you can modify the `hosts` file on your computer to fake one. For example, if you are on Windows, edit `C:\Windows\System32\Drivers\etc\hosts` file with administrator privilege, add following entry. + +```text +12.34.56.78 hassbian.home +``` + +(Please replace `12.34.56.78` with your Home Assistant's public IP address) + +It will allow you to open Home Assistant instance by access `http://hassbian.home:8123/` + ### {% linkable_title Stuck on Loading data %} Some advert blocking software, such as Wipr, also blocks web sockets. If you're stuck on the Loading data screen, try disabling your ad blocker. diff --git a/source/_docs/configuration/remote.markdown b/source/_docs/configuration/remote.markdown index f0d981b116e..00f9e276b35 100644 --- a/source/_docs/configuration/remote.markdown +++ b/source/_docs/configuration/remote.markdown @@ -15,6 +15,10 @@ If you're interested in logging in to Home Assistant while away, you'll have to Remember to follow the [securing checklist](/docs/configuration/securing/) before doing this.

+

+Home Assistant no longer support remote access via IP address since release 0.77, you have to use domain name. +

+ The most common approach is to set up port forwarding (for any port) from your router to port 8123 on the computer that is hosting Home Assistant. General instructions on how to do this can be found by searching ` port forwarding instructions`. You can use any free port on your router and forward that to port 8123. A problem with making a port accessible is that some Internet Service Providers only offer dynamic IPs. This can cause you to lose access to Home Assistant while away. You can solve this by using a free Dynamic DNS service like [DuckDNS](https://www.duckdns.org/). diff --git a/source/images/docs/authentication/error-invalid-client-id.png b/source/images/docs/authentication/error-invalid-client-id.png new file mode 100644 index 00000000000..9f543b92395 Binary files /dev/null and b/source/images/docs/authentication/error-invalid-client-id.png differ