Skip to content

Instances

TaskerHA supports multiple Home Assistant instances. Each action and profile in Tasker is bound to the instance you choose when configuring it, so you can have tasks targeting different servers side by side.

Adding an instance

  1. Open the TaskerHA app.
  2. Tap Add instance and give it a recognisable name.
  3. Enter the URL and access token for that Home Assistant server.
  4. Tap Test, then Save.

Repeat for any additional instances.

URL format

  • Include the scheme and port where needed: http://192.168.1.xxx:8123
  • For remote access via a reverse proxy, no port is usually needed: https://ha.yourdomain.com
  • Do not add a trailing slash.

Actions vs. profiles

Actions (Call Service, Get State, Send Message)Profiles (State Change, Direct Message)
Requires active connectionNo — each call opens its own connectionYes — depends on the WebSocket
Works on all instancesYesOnly on the instance with an active WebSocket

This means you can freely call services or read states on any instance at any time. Profiles are limited to whichever instance currently holds the active WebSocket connection. See the WebSocket page for details.

Automatic URL switching

Each instance can be configured with both a local URL and a remote URL. TaskerHA automatically picks the right one based on your phone's current Wi-Fi network.

  1. In the instance settings, enable URL switching.
  2. Enter the local URL (e.g. http://192.168.1.xxx:8123).
  3. Enter the Wi-Fi SSID(s) of your home network.
  4. Enter the remote URL (e.g. https://ha.yourdomain.com) as the fallback.

When your phone connects to a matching SSID, the local URL is used. On any other network (or mobile data), the remote URL is used automatically. No separate tasks or profiles needed for home vs. away.

Location permissions are required for getting the currently connected Wi-Fi SSID. If you prefer you can revoke the permission after setting up the URL switching

Images

TaskerHA instances main screen
Main screen — instance cards with WebSocket toggle, Edit, and Set Default
Edit instance screen with local URL switching
Edit Instance — local URL and home Wi-Fi network setup
Options screen showing battery optimization
Options tab — battery optimization status and request timeout

Released under the MIT License.