← Back to Ahl Control

How to use Ahl Control

One panel for the whole house. It works the moment you open it — on a seeded demo house — then switches to controlling your real devices once you connect your own Home Assistant (see “Connect Home Assistant” below). Your address and token stay on your device.

The three views

Edit mode

Tap ✎ Edit in the header to rearrange everything:

Load your floor plan

  1. Open the Map view → Load plan, and choose a photo or export of your floor plan (a sketch works fine).
  2. Tap ✎ Edit → 📍 Add pin for each device, give it an entity id and type, then drag it where the device sits.

Don't have a Home Assistant account?

Good news: there's nothing to sign up for. Home Assistant is free, open-source software you run yourself on a small device at home — there's no central account to register, no monthly fee to use it, and your data stays in your house. The "account" is simply the admin login you create the first time you open your own Home Assistant. Setting it up is three steps.

  1. Pick where it runs. The no-fuss option is a Home Assistant Green (about $99) — it arrives with Home Assistant already installed, so you just plug in power and your network cable. Prefer to use hardware you own? You can flash Home Assistant OS onto a Raspberry Pi 4/5 (use an SSD/NVMe drive, not a microSD card — SD cards wear out), an old PC or mini-PC, or a virtual machine / NAS.
  2. Install Home Assistant OS. For a Green, it's already done. For your own hardware, follow the official installer at home-assistant.io/installation — it walks you through flashing the OS.
  3. Create your account (onboarding). On the same network, open http://homeassistant.local:8123 in any browser. Home Assistant walks you through creating your name, username and password, setting your home's location and units, and it then auto-discovers the smart devices already on your network.
One thing to set up for Ahl Control: remote access over HTTPS. This app talks to your Home Assistant directly from your browser, which browsers only allow over a secure https:// address. The easiest way to get one is Home Assistant Cloud (by Nabu Casa — being renamed Home Assistant Link in the December 2026 update). It's an optional subscription, $6.50/month or $65/year in the US, and it gives you a ready-made https://…ui.nabu.casa address with no router or certificate fiddling — plus encrypted cloud backups and Alexa/Google voice. Turn it on in Home Assistant under Settings → Home Assistant Cloud. (Tinkerers can instead use a TLS reverse proxy or Tailscale — see "Connect Home Assistant" below.)

In a hurry? You don't need any of this to try Ahl Control — it opens on a full demo house you can tap around immediately, and the location weather tiles work with just a ZIP code, no Home Assistant required. Set up Home Assistant when you're ready to control your real devices.

Run it free — no hardware, no subscription

You can run the whole setup for $0/month on a computer you already own. There are two free pieces: where Home Assistant runs (local, on your own machine), and a secure connection that gives it the https:// address this app needs so you can use it from anywhere. Set up both and you're done — no hardware to buy, no subscription.

1. Install Home Assistant locally (on a computer you already have)

  1. Use any always-on machine — a home PC or laptop, or a virtual machine on your network. Starting on a PC and moving to a VM later works fine.
  2. Download the installer or a VM image from home-assistant.io/installation and follow the steps for your machine.
  3. On the same network, open http://homeassistant.local:8123 in a browser and create your admin login. This is the account that controls your whole home.
🔒 Set a strong password — it's the key to your house. Your Home Assistant login can unlock doors, disarm alarms and see your cameras, so treat it as your most important password. Use a long, unique passphrase (16+ characters) from a password manager — never one you've reused elsewhere — and turn on two-factor authentication (MFA) in Home Assistant under your user profile. Do this before you expose it in step 2.

2. Give it a secure web address (free remote access)

Because Ahl Control is served securely, it needs to reach Home Assistant over https://. A free, secure tunnel gives your Home Assistant a private https address — with no router ports to open and nothing to buy. Several reputable free services do this; pick one you trust and follow its Home Assistant setup guide. Many install as a one-click add-on from inside Home Assistant, so it's often just a few clicks.

Moving from your PC to a VM later? With a tunnel the https address stays the same — you just point the tunnel at the new machine, and Ahl Control needs no change. Then collect the three things in "Connect Home Assistant" below (your https URL, a long-lived token, and the CORS entry) and you're live.

Prefer to pay a little for zero setup instead? Home Assistant's own optional cloud subscription does the same remote-access job with no tunnel to configure — see "Connect Home Assistant" below.

Connect Home Assistant (go live)

Ahl Control talks to your devices through Home Assistant, which already bridges Alexa, Google Home and SmartThings into one place. There are two ways to connect — pick one.

Easiest: bring your own HA (nothing to deploy)

Enter your HA address and a token right in the app. They're saved only in this browser and are never sent to our server — the app talks to your Home Assistant directly.

  1. In Home Assistant: click your user name → Long-lived access tokens → create one.
  2. Make sure HA is reachable over https — Nabu Casa Cloud is easiest (it gives you an https://…ui.nabu.casa address); a TLS reverse proxy or Tailscale also works. A plain http://192.168… address can't be used from this page.
  3. Allow this site to talk to HA: in HA's configuration.yaml, under http:, add cors_allowed_origins: with this app's address, then restart HA.
  4. In Ahl Control: ⋯ menu → Connect Home Assistant → paste the URL and token → Test & connect. The status bar flips to LIVE, and you'll be offered to build your rooms automatically from your HA areas.

Your token lives on this device. To forget it, open the same screen and tap Disconnect. For maximum safety you can self-host these files instead of using a hosted copy.

Self-hosted: server-side token (one household)

If you deploy your own copy to Cloudflare, you can instead hold the token server-side so it never reaches any browser:

  1. Create the long-lived token as above.
  2. In Cloudflare → Workers → ahl-control → Settings → Variables & Secrets, add HA_BASE_URL (e.g. https://xxxx.ui.nabu.casa) and HA_TOKEN.
  3. Redeploy. The status bar flips from DEMO to LIVE for everyone who opens that copy.

Either way: once live, ⋯ menu → Import rooms from Home Assistant builds your rooms and tiles from your HA areas. Need a device name? Open Admin → Entity browser to copy any entity id.

Shopping list & Google

Calendar — two ways

The Cal view shows your day. It starts with sample events; pick a source with 📅 Source in the Cal view. There are two options — one keeps everything on your device, the other adds the full Google features.

Simplest & most private: an iCal link (stays on your device)

Paste your calendar's private .ics link and Ahl Control shows your events — read-only, with nothing stored on any server and no Google sign-in.

  1. In Cal → 📅 Source, choose "iCal link — stays on this device."
  2. Get the link from your calendar. In Google Calendar (on a computer): Settings → click your calendar under "Settings for my calendars" → scroll to Integrate calendar → copy the Secret address in iCal format. (Outlook, iCloud and Yahoo all offer a similar "publish / ICS" link.)
  3. Paste it and Save. Your events appear. Treat that secret link like a password — anyone with it can see your calendar.

Read-only: you can view events (and trigger calendar automations) but not add events or mirror to Google Tasks — those need the Google sign-in below.

Full Google (sign-in): add events + Tasks mirror

This uses Google sign-in so each person sees their own calendar and can add events and mirror the shopping list to Google Tasks. Like your Home Assistant, it's set up per deployment — you register one small Google app, then anyone using that copy signs in with their own Google account.

  1. Create an OAuth client in Google Cloud (free) and set two secrets — GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET — in Cloudflare → Workers → ahl-control → Settings → Variables & Secrets, with the AHL_KV namespace bound. (Note: these are OAuth client credentials, not an "API key.")
  2. Redeploy, then in the Cal view tap Sign in with Google and approve the consent screen.

Because Google stores each signed-in person's tokens on the server, this fits a single-household self-hosted copy best. For a copy shared with many families, the iCal option above keeps things private and avoids Google's app-verification step for the calendar permission.

Amazon links

Backup & restore

Your rooms, tiles, pins, presets and list live in this browser. Use ⋯ menu → Backup configuration to save a JSON file, and Restore to load it on another device.

FAQ

Is Ahl Control free?

Yes. The core panel is free to use. A one-time Pro unlock adds extra tile types (like live camera feeds) — there's no subscription.

Do I need Home Assistant to use it?

Not to look around — it opens on a demo house, and the location weather tiles work with just a ZIP code. To control your real lights, locks, thermostats and so on, you connect your own Home Assistant (see "Don't have a Home Assistant account?" above).

Does it work with Alexa, Google Home and SmartThings?

Yes — through Home Assistant, which already bridges Alexa, Google Home, SmartThings, Matter, Zigbee and more into one place. Ahl Control talks to Home Assistant, so whatever it controls, you control here.

Where are my Home Assistant address and token stored? Are they safe?

In "bring your own HA" mode they're saved only in your browser on this device and are never sent to our server — the app talks to your Home Assistant directly. To remove them, open ⋯ menu → Connect Home Assistant → Disconnect.

What does it cost to run?

Home Assistant itself is free and open-source. The only optional cost is Home Assistant Cloud ($6.50/mo or $65/yr in the US) for easy secure remote access over HTTPS — which is the simplest way to meet Ahl Control's HTTPS requirement.

Why does my Home Assistant need an https:// address?

Browsers block a secure web page (this app) from talking to an insecure http:// address — it's a built-in safety rule called mixed-content blocking. Home Assistant Cloud, a TLS reverse proxy, or Tailscale all give you an https:// address that works.

Can I add a weather tile without Home Assistant?

Yes. In Edit mode, add a device, set the type to Weather, and enter a US ZIP code. The tile shows that location's conditions and a 5-day forecast on its own — no Home Assistant entity needed.

How do I switch between °F and °C?

Tap any ZIP weather tile and use the Show °C / Show °F button in the panel. The choice applies to every location weather tile and is remembered on this device.

Can my whole family use it, with their own simpler screens?

Yes. Settings are per-device, so each phone or wall panel keeps its own layout. ⋯ menu → Family / simple mode lets you show only certain rooms and hide tabs, and you can set a PIN to lock controls — handy for kids, guests or a kitchen wall tablet.

Does it work offline, and can I install it like an app?

It's an installable PWA: use your browser's Add to Home Screen / Install option to get an app icon. The panel shell and your last-known state load offline; actually changing a device, of course, needs a connection to Home Assistant.

← Back to Ahl Control