Back to Blog
tutorialIntermediate10 min read

Home Assistant OS Reverse Proxy

A guide on how to set up a reverse proxy for Home Assistant OS on Proxmox using Nginx Proxy Manager.

Overview

Home Assistant OS is a great way to run Home Assistant, but it can be a bit tricky to set up a reverse proxy for it. This guide will walk you through the process of setting up a reverse proxy for Home Assistant OS on Proxmox using Nginx Proxy Manager.

Prerequisites

  • Proxmox installed and running
  • Home Assistant OS installed and running
  • Nginx Proxy Manager installed and running

Install File Editor

In order to set up the reverse proxy, we will need to install the File Editor add-on in Home Assistant OS. This will allow us to edit the configuration files for Home Assistant OS.

Click "Settings" and then "Add-ons"

add-ons
add-ons

Then click "Add-on Store" in the bottom right.

add-on-store
add-on-store

Then search for "File Editor".

file-editor
file-editor

Click on it and then click "Install".

install
install

Then toggle "Show in sidebar" and click "Start" to start the add-on.

start
start

Wait for the add-on to start and then click the side menu item "File editor".

menu-item
menu-item

Update Configuration File

Click the "Folder" icon at the top left.

folder
folder

Then find the file configuration.yaml and click on it.

configuration
configuration

Update the configuration file to look like this:

http:
  use_x_forwarded_for: true
  trusted_proxies:
    - 192.168.10.4 # Your Nginx Proxy Manager IP

config
config

Then click "Save" in the top right.

save
save

Click "Settings" in the left sidebar and then the "Vertical Dots" icon in the top right and then restart Home Assistant.

restart
restart

Accept any prompts regarding restarting Home Assistant.

Update Nginx Proxy Manager Configuration

Make sure to have an SSL certificate for your domain. You should have Nginx Proxy Manager SSL configured before proceeding.

cert
cert

Then click "Hosts" in the left sidebar and then "Proxy Hosts".

hosts
hosts

Then click "Add Proxy Host"

add
add

Then enter the following information

configure-proxy
configure-proxy

Then configure SSL as follows:

configure-ssl
configure-ssl

Then click "Save" in the bottom right.

Update Pi-hole Configuration

Finally, add a DNS record for your domain to point to the IP address of your Nginx Proxy Manager. This will allow you to access Home Assistant OS using your domain name.

local-dns
local-dns

Add record

add-record
add-record

Home Assistant OS should now be accessible via your domain name.

proxy
proxy