jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-19 15:26:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

nginx rev proxy minimal version 1.3.13 (#4849)

Browse Source 
* nginx rev proxy minimal version 1.3.13

* Some other minor changes
This commit is contained in:
Florian Klien 2018-03-06 21:18:48 +01:00 committed by Fabian Affolter
parent 4ff8107c73
commit 1b266b18a4
1 changed files with 7 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
source/_docs/ecosystem/nginx.markdown
View File

@ -14,13 +14,17 @@ Using NGINX as a proxy for Home Assistant allows you to serve Home Assistant sec
### {% linkable_title 1. Get a domain name forwarded to your IP %} ### {% linkable_title 1. Get a domain name forwarded to your IP %}
Chances are, you have a dynamic IP Address (your ISP changes your address periodically). If this is true, you can use a Dynamic DNS service to obtain a domain and set it up to update with you IP. If you purchase your own domain name, you will be able to easily get a trusted SSL certificate later. Chances are, you have a dynamic IP address (your ISP changes your address periodically). If this is true, you can use a Dynamic DNS service to obtain a domain and set it up to update with you IP. If you purchase your own domain name, you will be able to easily get a trusted SSL certificate later.
### {% linkable_title 2 Install nginx on your server %} ### {% linkable_title 2 Install nginx on your server %}
This will vary depending on your OS. Check out Google for this. After installing, ensure that NGINX is not running. This will vary depending on your OS. Check out Google for this. After installing, ensure that NGINX is not running.
<p class='note'>
You will at least need nginx >= 1.3.13, as WebSocket support is required for the reverse proxy.
</p>
### {% linkable_title 3. Obtain an SSL certificate %} ### {% linkable_title 3. Obtain an SSL certificate %}
There are two ways of obtaining an SSL certificate. There are two ways of obtaining an SSL certificate.
@ -28,7 +32,7 @@ There are two ways of obtaining an SSL certificate.
#### {% linkable_title Using Let's Encrypt %} #### {% linkable_title Using Let's Encrypt %}
If you purchased your own domain, you can use https://letsencrypt.org/ to obtain a free, publicly trusted SSL certificate. This will allow you to work with services like IFTTT. Download and install per the instructions online and get a certificate using the following command. If you purchased your own domain, you can use https://letsencrypt.org/ to obtain a free, publicly trusted SSL certificate. This will allow you to work with services like IFTTT. Download and install per the instructions online and get a certificate using the following command.
``` ```bash
$ sudo ./letsencrypt-auto certonly --standalone -d example.com -d www.example.com $ sudo ./letsencrypt-auto certonly --standalone -d example.com -d www.example.com
``` ```
@ -75,14 +79,13 @@ $ sudo ln ../sites-available/hass default
Double check this configuration to ensure all settings are correct and start nginx. Double check this configuration to ensure all settings are correct and start nginx.
### {% linkable_title 8. Port forwarding. %} ### {% linkable_title 8. Port forwarding. %}
Forward ports 443 and 80 to your server on your router. Do not forward port 8123. Forward ports 443 and 80 to your server on your router. Do not forward port 8123.
### {% linkable_title NGINX Config %} ### {% linkable_title NGINX Config %}
``` ```text
map $http_upgrade $connection_upgrade { map $http_upgrade $connection_upgrade {
default upgrade; default upgrade;
'' close; '' close;