Expose Home Assistant

Access your Home Assistant dashboard remotely through SeaWise.

Prerequisites

• Home Assistant running on your home server

• SeaWise client installed and paired

Step 1: Find Home Assistant's Port

Home Assistant defaults to port 8123.

Step 2: Add Home Assistant to SeaWise

In the client web UI at http://your-server-ip:8082:

1. Click Add Service

2. Name: Home Assistant

3. Host: localhost

4. Port: 8123

5. Click Add

Step 3: Configure Trusted Proxies

Home Assistant blocks requests from unknown proxies by default. You need to add the SeaWise client as a trusted proxy.

Add this to your configuration.yaml:

http:
  use_x_forwarded_for: true
  trusted_proxies:
    - 127.0.0.1
    - 172.16.0.0/12
    - 192.168.0.0/16
    - 10.0.0.0/8

Restart Home Assistant after making this change.

Note: The IP ranges above cover common Docker network ranges. If you know the specific IP of your SeaWise container, you can use that instead for tighter security.

Step 4: Access Home Assistant

Your Home Assistant is now available at:

https://your-subdomain.seawise.dev

Sign in with your Home Assistant credentials.

Tips

• Mobile app: The Home Assistant mobile app works with SeaWise — just enter your SeaWise URL as the external URL in the app's connection settings

• Automations: All automations, scenes, and scripts work normally — SeaWise doesn't affect Home Assistant's functionality

• Low bandwidth: Home Assistant uses minimal bandwidth (mostly small API calls and dashboard rendering), so it works well even on slow connections

Troubleshooting

"400 Bad Request"

This usually means the trusted proxy configuration is missing or incorrect. Make sure you've added the http section to configuration.yaml and restarted Home Assistant.

"Unable to connect"

Verify Home Assistant is running:

curl -s http://localhost:8123

If this works locally but not through SeaWise, check the Service Not Accessible guide.