The http component serves all files and data required for the Home Assistant frontend. You only need to add this to your configuration file if you want to change any of the default settings.
+It’s HIGHLY recommended that you set the api_password, especially if you are planning to expose your installation to the internet.
+
# Example configuration.yaml entry http: diff --git a/components/media_player.onkyo/index.html b/components/media_player.onkyo/index.html index 8f814847ac..28529b1727 100644 --- a/components/media_player.onkyo/index.html +++ b/components/media_player.onkyo/index.html @@ -109,7 +109,7 @@
Configuration variables:
- host (Optional): IP address of the device. Example:192.168.1.2 If not specified, the platform will load any discovered receivers.
-- name (Optional, required if host is specified): Name of the device
+- name (Required if host is specified): Name of the device
- sources (Optional): A list of mappings from source to source name. Valid sources can be found below. A default list will be used if no source mapping is specified.
List of source names: There are various ways to access the stream. One is The simplest way to consume server-sent events is A simplest way to consume server-sent events is
+If you are planing to expose your Home Assistant instance to the internet and don’t set a password then your installation could be accessed by everybody.
+ See the HTTP component documentation for more options like HTTPS encryption.
diff --git a/developers/python_api/index.html b/developers/python_api/index.html
index 959c5d21c6..9052dd98cf 100644
--- a/developers/python_api/index.html
+++ b/developers/python_api/index.html
@@ -124,7 +124,7 @@ living_room = hass.states.get('import homeassistant.remote as remote
-api = remote.API('127.1.0.1', 'password')
+api = remote.API('127.1.0.1', 'YOUR_PASSWORD')
print('-- Available services:')
services = remote.get_services(api)
@@ -151,7 +151,7 @@ entities = remote.get_states(api)
import homeassistant.remote as remote
-api = remote.API('127.1.0.1', 'password')
+api = remote.API('127.1.0.1', 'YOUR_PASSWORD')
office_temperature = remote.get_state(api, 'sensor.office_temperature')
print('{} is {} {}.'.format(office_temperature.attributes['friendly_name'],
office_temperature.state,
@@ -175,7 +175,7 @@ print('
import homeassistant.remote as remote
-api = remote.API('127.1.0.1', 'password')
+api = remote.API('127.1.0.1', 'YOUR_PASSWORD')
switch_livingroom = remote.get_state(api, 'switch.livingroom_pin_2')
print('{} is {}.'.format(switch_livingroom.attributes['friendly_name'],
switch_livingroom.state
@@ -193,7 +193,7 @@ print('
import homeassistant.remote as remote
from homeassistant.const import STATE_ON
-api = remote.API('127.1.0.1', 'password')
+api = remote.API('127.1.0.1', 'YOUR_PASSWORD')
remote.set_state(api, 'sensor.office_temperature', new_state=123)
remote.set_state(api, 'switch.livingroom_pin_2', new_state=STATE_ON)
import time
import homeassistant.remote as remote
-api = remote.API('127.1.0.1', 'password')
+api = remote.API('127.1.0.1', 'YOUR_PASSWORD')
domain = 'switch'
remote.call_service(api, domain, 'turn_on')
@@ -228,7 +228,7 @@ remote.call_service(api, domain, '<
import time
import homeassistant.remote as remote
-api = remote.API('127.1.0.1', 'password')
+api = remote.API('127.1.0.1', 'YOUR_PASSWORD')
domain = 'switch'
switch_name = 'switch.livingroom_pin_2'
@@ -246,7 +246,7 @@ remote.call_service(api, domain, '<
import homeassistant.remote as remote
-api = remote.API('127.1.0.1', 'password')
+api = remote.API('127.1.0.1', 'YOUR_PASSWORD')
domain = 'notify'
data = {"title":"Test", "message":"A simple test message from HA."}
diff --git a/developers/server_sent_events/index.html b/developers/server_sent_events/index.html
index dc1465b480..7275a2e40a 100644
--- a/developers/server_sent_events/index.html
+++ b/developers/server_sent_events/index.html
@@ -98,7 +98,7 @@
curl:$ curl -X GET -H "x-ha-access: 12345" \
+
$ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \
-H "Content-Type: application/json" http://localhost:8123/api/stream
Examples
-curl.httpie.$ curl http://localhost:8123/api/stream?api_password=MYPASS
+
$ http --stream http://localhost:8123/api/stream x-ha-access:YOUR_PASSWORD content-type:application/json
from sseclient import SSEClient
-messages = SSEClient('http://localhost:8123/api/stream?api_password=MYPASS')
+messages = SSEClient('http://localhost:8123/api/stream?api_password=YOUR_PASSWORD')
for msg in messages:
print(msg)
Setting up your phone or tablet
diff --git a/sitemap.xml b/sitemap.xml
index 6e30050668..67c2981a25 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -1993,34 +1993,34 @@