From 0f78e11a86b6351c10ef7f123ab59adb317dda4f Mon Sep 17 00:00:00 2001 From: DubhAd Date: Mon, 26 Mar 2018 07:16:45 +0100 Subject: [PATCH] Highlighting the hosting of files (#5015) The use of `www/` is hidden in the middle of the page, it's impossible to direct people to it, and trivial to overlook. It's also wrong for Hass.io ;) Updating to make it possible to link to it, and adding details on where to find it on Hass.io. Also adding a note about needing to restart after creating the folder (there's been lots and lots of feedback about needing to do so) --- source/_components/http.markdown | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/source/_components/http.markdown b/source/_components/http.markdown index 88da4c67386..458e10794e5 100644 --- a/source/_components/http.markdown +++ b/source/_components/http.markdown @@ -75,8 +75,6 @@ To use those kind of [sensors](/components/sensor.http/) or [binary sensors](com All [requests](/developers/rest_api/#post-apistatesltentity_id) need to be sent to the endpoint of the device and must be **POST**. -If you want to use Home Assistant to host or serve static files then create a directory called `www` under the `.homeassistant` configuration path. The static files in `.homeassistant/www/` can be accessed by the following URL `http://your.domain:8123/local/`. - If you want to apply additional IP filtering, and automatically ban brute force attempts, set `ip_ban_enabled` to `True` and the maximum number of attempts. After the first ban, an `ip_bans.yaml` file will be created in the root configuration folder. It will have the banned IP address and time in UTC when it was added: ```yaml @@ -89,3 +87,11 @@ After a ban is added a Persistent Notification is populated to the Home Assistan

Please note, that sources from `trusted_networks` won't be banned automatically.

+ +## {% linkable_title Hosting files %} + +If you want to use Home Assistant to host or serve static files then create a directory called `www` under the configuration path (`/config` on Hass.io, `.homeassistant` elswhere). The static files in `www/` can be accessed by the following URL `http://your.domain:8123/local/`, for example `audio.mp3` would be accessed as `http://your.domain:8123/local/audio.mp3`. + +

+ If you've had to create the `www/` folder for the first time, you'll need to restart Home Assistant. +