Setup Guide - Home Access Anywhere

Before You Start

✓

A working Home Assistant OS 64-bit To verify your architecture, go to Settings > System > Repairs, click the three dots (top right), and select System Information. Look for CPU/Container Architecture; it must be aarch64 or x86_64.

✓ An account on homeaccessanywhere.com (register here) - you'll receive your Connection Key immediately after registration

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

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"

1

Pull the Docker Image

docker pull ghcr.io/homeaccessanywhere/haa-addon-amd64:latest

Use -aarch64 for Raspberry Pi 4, -armv7 for Pi 3

2

Run the Container

docker run -d \
  --name haa-addon \
  --restart unless-stopped \
  -e ConnectionKey="YOUR-CONNECTION-KEY" \
  -e HomeAssistantUrl="http://homeassistant:8123" \
  -e ServerUrl="https://homeaccessanywhere.com" \
  ghcr.io/homeaccessanywhere/haa-addon-amd64:latest

Replace YOUR-CONNECTION-KEY with your actual key

Adjust HomeAssistantUrl to match your HA address

3

Verify

docker logs -f haa-addon

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

Or use Docker Compose

version: '3.8'
services:
  haa-addon:
    image: ghcr.io/homeaccessanywhere/haa-addon-amd64:latest
    restart: unless-stopped
    environment:
      - ConnectionKey=YOUR-CONNECTION-KEY
      - HomeAssistantUrl=http://homeassistant:8123
      - ServerUrl=https://homeaccessanywhere.com

1

Install .NET 8 Runtime

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install -y dotnet-runtime-8.0

# Or download from https://dotnet.microsoft.com/download

2

Download the Addon

wget https://github.com/homeaccessanywhere/home-assistant-addon/releases/latest/download/haa-addon-linux-x64.zip
unzip haa-addon-linux-x64.zip -d /opt/haa-addon

3

Create a Systemd Service

Create /etc/systemd/system/haa-addon.service:

[Unit]
Description=Home Access Anywhere Addon
After=network.target

[Service]
Type=simple
WorkingDirectory=/opt/haa-addon
ExecStart=/usr/bin/dotnet /opt/haa-addon/HAA.Addon.dll
Environment=ConnectionKey=YOUR-CONNECTION-KEY
Environment=HomeAssistantUrl=http://localhost:8123
Environment=ServerUrl=https://homeaccessanywhere.com
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

4

Enable and Start

sudo systemctl daemon-reload
sudo systemctl enable haa-addon
sudo systemctl start haa-addon
sudo systemctl status haa-addon

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 the HomeAssistantUrl correct in your configuration?

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