Update docs.md

This commit is contained in:
Yegor Vialov 2019-02-08 17:00:02 +02:00 committed by GitHub
parent 3ec38140be
commit 3ee3e36ca8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

19
docs.md
View File

@ -1,8 +1,9 @@
# Table of content # Documentation
## Table of content
- [Requirements](#requirements) - [Requirements](#requirements)
- [Home Assistant general](#home-assistant-general) - [Home Assistant general](#home-assistant-general)
- Port - [Port](#port)
- HTTP or HTTPS - [HTTP or HTTPS](#http-or-https)
- SSL Certificates - SSL Certificates
- Android - Android
- Authentication - Authentication
@ -10,8 +11,8 @@
- Lovelace UI - Lovelace UI
- Log Viewer - Log Viewer
# Requirements ## Requirements
## Home Assistant general ### Home Assistant general
To check if you are using right configuration for app, try to access your Home Assistant web interface with the same protocol (http:// or https://), the same domain or IP and port. If it is not loading the app will not work as well. To check if you are using right configuration for app, try to access your Home Assistant web interface with the same protocol (http:// or https://), the same domain or IP and port. If it is not loading the app will not work as well.
To connect to your Home Assistant instance with HA Client you need `http` and `websocket_api` components to be enabled as well as [remote access](https://www.home-assistant.io/docs/configuration/remote/) configured. If you are using `frontend` component (Home Assistant web interface actually) `websocket_api` is enabled by default and `http` component is already configured on your server, but still you need to double check. To connect to your Home Assistant instance with HA Client you need `http` and `websocket_api` components to be enabled as well as [remote access](https://www.home-assistant.io/docs/configuration/remote/) configured. If you are using `frontend` component (Home Assistant web interface actually) `websocket_api` is enabled by default and `http` component is already configured on your server, but still you need to double check.
@ -26,3 +27,11 @@ http:
websocket_api: websocket_api:
``` ```
## Port
By default your Home Assistant is using port number `8123`. But to access your instance from outside of your home network, probably you configured some port forwarding rules on you router. If you forward some other port from outside to `8123` port on Home Assistant IP, you need to use that port instead.
If you are accessing your web interface without port, then you need to try port `80` or `443` in app.
## HTTP or HTTPS
It is not required to use secure connection. Just remember: if you are accessing your web interface with http, you need to switch “Use ssl” off in app settings as well.
But if you are using ssl (accessing web interface with https://) your certificate should be valid (not self-signed).