Home Lab Projects

Self-Hosted Apps That Integrate With Home Assistant: Immich, Donetick and TeslaMate

Compare how Immich, Donetick and TeslaMate connect to Home Assistant, what each one can automate, and the security checks to make before you start.

On this page
  1. How self-hosted apps connect to Home Assistant
  2. Immich: photos in your dashboards
  3. Donetick: chores and to-do lists
  4. TeslaMate: a car data logger, not a remote control
  5. Security checklist
  6. Common mistakes

Home Assistant can read data from apps you run yourself, not only from smart devices. Immich (photos), Donetick (chores) and TeslaMate (Tesla car data) are three self-hosted apps that connect to Home Assistant in different ways. This guide explains those connection routes, what each app can do in Home Assistant, and what to check before you expose any of them outside your home network.

How self-hosted apps connect to Home Assistant

Most of these apps run as their own Docker containers next to Home Assistant. Home Assistant add-ons run only on Home Assistant OS. On other installs, the app runs separately and talks to Home Assistant over your network.

The main connection routes are:

  • A native integration, added from Settings > Devices & services.
  • MQTT, where the app publishes messages to a broker that Home Assistant reads.
  • A REST sensor, which polls an HTTP endpoint on a timer.
  • A webhook, where the app calls Home Assistant when something happens.

Check the app’s documentation to see which routes it supports. Also check whether the integration is official, a HACS custom integration or a community add-on. Official integrations are updated with Home Assistant. HACS integrations are maintained separately, and they can break after a Home Assistant update.

Immich: photos in your dashboards

Immich is a self-hosted photo and video app, often used as an alternative to Google Photos. It runs as several containers: the server, a machine learning container for face recognition and search, PostgreSQL and Redis (or Valkey). Its default web port is 2283. Face recognition, CLIP search and object detection run locally, so the machine learning container doesn’t need a cloud service.

Home Assistant includes an Immich integration. To add it, go to Settings > Devices & services, select Add integration and choose Immich. Enter your Immich URL, such as http://192.168.1.100:2283, and an API key. Create the key in the Immich web interface under Account Settings > API Keys. The integration provides storage and photo and video count sensors, and a media source for browsing albums. Its entities have changed across Home Assistant releases, so check the current documentation for the exact list.

A useful first automation is a notification when the storage sensor passes a level you choose. That gives you time to add disk space before the library fills up.

Immich is not a backup. It organises and serves your library, but it doesn’t replace a second copy. Keep separate backups of the photo files and the database, following a 3-2-1 approach: three copies, on two kinds of media, with one copy off-site.

Donetick: chores and to-do lists

Donetick is a self-hosted chore and task manager. It supports recurring schedules, assigned household members, rotation rules and points. Its default port is 2021.

Home Assistant connects to Donetick through a HACS custom integration. The integration exposes chores as to-do list entities and adds sensors. Enter your Donetick server URL, such as http://<ha-host-ip>:2021, and an API token. The project also publishes a Home Assistant add-on repository. Add-ons run only on Home Assistant OS, so check the project’s current documentation before you choose an install route.

Donetick also supports API tokens and webhooks, and the integration provides actions to create, update, postpone and complete tasks. That makes automations possible, such as marking a chore done when a sensor shows the job has happened. Start with a single chore and check the result before you add more.

TeslaMate: a car data logger, not a remote control

TeslaMate is a self-hosted logger for Tesla data. It is written in Elixir, stores its history in PostgreSQL and includes Grafana dashboards. The TeslaMate web interface usually runs on port 4000, and Grafana on port 3000.

TeslaMate can publish car data to an MQTT broker, often Mosquitto on port 1883. Messages use topics such as teslamate/cars/<car_id>/<metric>, for example battery_level or state. Home Assistant can read those topics with MQTT sensors, or with a HACS TeslaMate integration.

TeslaMate does not control the car. It records data. If you want to lock the car, change climate settings or start charging from Home Assistant, you need a different integration that uses Tesla’s API.

TeslaMate is designed to let the car sleep rather than polling it constantly, which helps avoid the extra battery drain that constant polling can cause. Tesla’s API access rules have changed over time, so check TeslaMate’s current documentation before you connect your Tesla account.

Security checklist

These apps store personal data, including photos, household routines and vehicle location history. Treat them like any other service that holds your files.

  • Don’t expose Immich, Donetick or TeslaMate to the internet without authentication. Use a VPN, or a reverse proxy with TLS and access controls.
  • Protect the TeslaMate database, because it stores location history.
  • Keep Home Assistant’s long-lived tokens and each app’s API keys out of shared files and screenshots. A long-lived token grants full API access.
  • Back up each app’s data and database on a schedule, and test a restore at least once.

To keep these services under watch while you’re away, see how to monitor self-hosted services with Uptime Kuma and Home Assistant. If the apps run in virtual machines, the Proxmox monitoring guide covers the host side. A UPS guide covers protecting the host during power cuts.

Common mistakes

  • Expecting the apps to run inside Home Assistant. Only add-ons run inside it. Most of these apps run in their own containers.
  • Treating Immich as a backup. It serves your library, but it isn’t a second copy.
  • Expecting TeslaMate to control the car. It logs data.
  • Assuming a HACS integration is official. It can break when Home Assistant updates, so check its release notes before you upgrade.

Keep exploring

Guides from other topics

All topics →