---
title: "TTLock"
description: "TTLock is a Marketplace integration for Home Assistant. It has 1.3k installs sharing analytics, needs the vendor's cloud and was last updated October 25, 2026."
canonical: "https://vulpo.app/integrations/marketplace/jbergler-hass-ttlock"
url: "https://vulpo.app/integrations/marketplace/jbergler-hass-ttlock.md"
last-updated: "2026-10-22"
version: "1.4"
---

# TTLock

> TTLock is a Marketplace integration for Home Assistant. It has 1.3k installs sharing analytics, needs the vendor's cloud and was last updated October 25, 2026.

TTLock is a Marketplace integration that connects TTLock based smart locks to Home Assistant through the vendor's cloud. It adds lock entities for locking and unlocking, along with sensors for battery, last operator and reason, and a signal strength sensor for each lock. It can also add and delete pass codes, list them, and show the history of lock and unlock records. Updates arrive through a webhook instead of regular polling, and a repair notice supplies the webhook address to register. Locks within range of Home Assistant's Bluetooth can report their state directly, and this can be turned off in the options so only the cloud is used. Setup is done in the UI with a vendor sign-in, and the options also cover poll interval and detail refresh interval.

Automatic summary of the README and code of jbergler/hass-ttlock. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=jbergler&repository=hass-ttlock&category=integration)

On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=jbergler&repository=hass-ttlock&category=integration)

## Supports

- **Uses the vendor's cloud**: Needs an internet connection and an account with the vendor.
- **Sign in with the vendor**: Connects through the vendor's own sign-in page.
- **From the Marketplace**: Installed through the Marketplace, formerly HACS.
- **Actively maintained**: Its author released or pushed a change in the last six months.

## Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

### Login to TTLock

- **Region**: The TTLock cloud your account and developer app are registered with. EU / International covers everywhere except mainland China.
- **Password**
- **Username**

### After setup

- **Poll interval**: How often to re-check whether each lock is locked or unlocked, in minutes.
- **Detail refresh interval**: How often to refresh slow-changing detail (battery, name, autolock and passage-mode config, gateway signal), in hours.
- **Read locks over Bluetooth**: Read lock state directly from a lock in range of Home Assistant, instead of asking the TTLock cloud. Turn this off to use the cloud only.

Texts from the code of [jbergler/hass-ttlock](https://github.com/jbergler/hass-ttlock).

## Troubleshooting

- **Diagnostics**: Downloads a diagnostics file to attach to a bug report.
- **Repair notices**: Notices it can show in Settings, Repairs:
  Unable to generate webhook URL., Confirm your TTLock webhook URL, Register your TTLock webhook URL

## From the README

> Home Assistant integration for TTLock based locks.

From the README of [jbergler/hass-ttlock](https://github.com/jbergler/hass-ttlock#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened.

## At a glance

- Kind: Marketplace integration
- Category: [Security and safety](https://vulpo.app/integrations/category/security-and-safety.md), Locks and access
- Number: 1.3k installs sharing analytics; 157 GitHub stars
- Connection: Needs the vendor's cloud
- Upkeep: Updated in the last 6 months
- Needs: Needs the Marketplace (HACS on 2026.10 and older)
- Latest version: v0.17.1, last updated October 25, 2026
- Domain: `ttlock`
- Source: <https://github.com/jbergler/hass-ttlock>
- Issues: <https://github.com/jbergler/hass-ttlock/issues>

In Vulpo: Quick Toggle card, Lock card, Chart card, Apple Watch, Control Center

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-10-22. Source: https://vulpo.app/integrations/marketplace/jbergler-hass-ttlock

---

- HTML version of this page: https://vulpo.app/integrations/marketplace/jbergler-hass-ttlock
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml