Use cases
Reach Home Assistant remotely without opening ports
Open the Home Assistant interface from anywhere through a machine on the same network, and get told when the house goes offline.
For: Home Assistant users who don't want port 8123 on the internet or a paid relay.
Which machine runs the agent
- Home Assistant Container or Supervised on Debian or Raspberry Pi OS: install the agent on that machine and open
127.0.0.1:8123. - Home Assistant OS is an appliance that doesn't take extra software. Put the agent on any other Linux box on the same network (a Pi, the NAS) and open Home Assistant's LAN address, for example
192.168.1.20:8123.
What you get
- The Home Assistant interface in your browser through Web page, no port forward.
- An alert when the house's machine drops off, which usually means power or internet is down.
Good to know
- The page reaches Home Assistant through the agent's machine, as a proxy. If Home Assistant answers 400, set
use_x_forwarded_for: trueunderhttp:and add that machine's IP (or127.0.0.1when it's the same host) totrusted_proxies. - The companion mobile apps expect a fixed URL, so for them a VPN or Home Assistant Cloud fits better.
Start
Create a workspace at fieldhand.dev (the first 5 devices are free, with every feature), click Add devices and run the command on the machine:
curl -fsSL https://api.fieldhand.dev/install.sh | sudo sh -s -- --token fhe_…
Or look around the live demo fleet first.
Something wrong or missing on this page? Tell us.