Smart Home Setup

Connecting to Home Assistant

Chalie connects to your Home Assistant instance via its REST API using a long-lived access token.

Step by step

1. Open the Brain dashboard (the 🧠 brain icon in the top-right corner)
2. Go to the Capabilities page in the Brain sidebar
3. Find the Home capability and click Setup
4. Fill in the Home Setup form:
   • Home Assistant URL — your Home Assistant instance URL (e.g. http://homeassistant.local:8123)
   • Long-Lived Access Token — a long-lived access token (see below)
   • Verify SSL — leave on for normal HTTPS setups; turn it off if your instance uses a self-signed certificate
5. Click Connect to verify Chalie can reach your devices

Creating an access token

1. Open your Home Assistant dashboard
2. Click your profile icon (bottom-left) to open Profile
3. Scroll to Long-Lived Access Tokens
4. Click Create Token and name it “Chalie”
5. Copy the generated token and paste it into Chalie’s smart home settings

The token does not expire unless you revoke it. Keep it private — anyone with this token can control your devices.

Troubleshooting

• Connection timeout — verify the Home Assistant URL is reachable from the machine running Chalie (try opening it in a browser on that machine)
• Devices not appearing — make sure your devices are assigned to areas in Home Assistant; Chalie uses areas to organise devices by room
• Commands not working — check that the access token belongs to a user with admin privileges, or at least permission to control the target devices
• SSL errors — if your Home Assistant uses HTTPS with a self-signed certificate, turn off the Verify SSL toggle in the Home Setup form