Setup Guide - Home Access Anywhere

Before You Start

✓

A working Home Assistant OS To verify your architecture, go to Settings > System > Repairs, click the three dots (top right), and select System Information. Look for CPU/Container Architecture; supported architectures are aarch64, amd64 (x86_64), and armv7.

✓

An account on homeaccessanywhere.com (register here) After registration you'll receive your Connection Key. You must verify your email address before your tunnel becomes active.

Installation steps

1

Add the Repository

Go to Settings → Add-ons → Add-on Store

Click the ⋮ menu (top right) → Repositories

Add this URL:

https://github.com/homeaccessanywhere/home-assistant-addon

2

Install the Add-on

Find "Home Access Anywhere" in the add-on store

Click Install and wait for it to complete

Turn on Watchdog to make sure the tunnel stays active

3

Configure

Go to the add-on's Configuration tab

Enter your Connection Key:

connection_key: "your-key-here"

Click Save

4

Start

Go to the Info tab and click Start

Check the Log tab to verify the connection

You should see: "Authenticated as [subdomain], tunnel is active"

Test Your Connection

Once the addon is running, visit your personal URL:

https:// [your-subdomain] .homeaccessanywhere.com

You should see your Home Assistant login page!

Troubleshooting

I see "Home Assistant Offline"

The addon is not connected. Check:

Is the addon running? Check the logs.
Is the Connection Key correct?
Can the addon reach homeaccessanywhere.com?

I see "Request Timeout"

The addon is connected but Home Assistant isn't responding. Check:

Is Home Assistant running?
Is Home Assistant fully started? (Check the logs)

Authentication failed

Your Connection Key is invalid or has been revoked. Generate a new key from your dashboard.

WebSocket errors / App doesn't load fully

Make sure WebSocket connections are working. Check your browser's developer console for errors.

Need Help?

If you're still having issues:

GitHub Issues Report bugs or request features HA Community Ask the community for help