Smart Home Setup

Connect your home automation platform to Chalie.

Setting up smart home control

Smart home integration connects Chalie to your existing home automation platform. The setup depends on which platform you use.

Step by step

  1. Open the Brain panel (the ⚙️ icon in the sidebar)
  2. Switch to the Capabilities tab
  3. Find Smart Home and toggle it on
  4. Select your platform from the dropdown
  5. Enter the connection details for your platform (see below)
  6. Click Test Connection to verify Chalie can reach your devices

Home Assistant

Home Assistant is the most popular self-hosted platform and offers the broadest device support.

  • Server URL — your Home Assistant instance URL (e.g. http://homeassistant.local:8123)
  • Access Token — a long-lived access token from your Home Assistant profile
    1. In Home Assistant, go to Profile → Long-Lived Access Tokens
    2. Click Create Token, name it “Chalie”, and copy the token
    3. Paste the token into Chalie’s smart home settings

MQTT

For DIY setups using MQTT-compatible devices:

  • Broker URL — your MQTT broker address (e.g. mqtt://192.168.1.100:1883)
  • Username / Password — if your broker requires authentication
  • Topic prefix — the base topic for your devices (e.g. home/)

Troubleshooting

  • Connection timeout — verify the server URL is reachable from your Chalie instance
  • Devices not appearing — ensure your platform exposes devices through its API; Home Assistant devices must be assigned to areas
  • Commands not working — check that the access token has sufficient permissions to control devices