Doors & codes

Overview

A LockHub is the gateway that talks to the locks over Bluetooth (TTLock-compatible, e.g. LVD-11 or C001C) and is connected to the LinArt cloud over Wi-Fi. Everything you do to a door in LinArt goes through this gateway. How the gateway is set up and a lock is paired is described in the LockHub manual (DE) and in the product guide for the lock cylinder; this page describes the operation in the dashboard.

• Where: menu item Doors (appears as soon as a LockHub is in the home). The page carries the heading “Doors”. The same Doors card also sits on Home, and the gateway panel is additionally reachable under Devices on the LockHub card. Guests land directly on Doors after signing in.
• Two levels: at the top the Doors card with a dial (“Bolt Dial”) per lock for everyday use; below it one panel per gateway with the management functions (add lock, name, codes, policies, history, Wi-Fi).
• Data in the lock: codes, cards, fingerprints, passage mode and the journal live in the lock itself. Every list is read from the lock over Bluetooth – that takes 5 to 45 seconds.
• Security: changing codes, cards and fingerprints needs the second factor once per 24 hours (Face ID / passkey or authenticator code). The owner can protect remote unlocking per lock with a confirmation.

Door list, states and battery

The Doors card shows a dial per lock with name, state and a hint line. The header carries the summary: “All doors locked”, “Open: …” or “No connection: …”. If two or more doors are open, Lock all appears.

In the gateway panel below, the header shows “gateway offline” or “Add mode active”; members see “family access · owner …” there. Every lock has the buttons Unlock, Lock, Status and More.

Step by step: unlocking and locking a door

1. Open Doors (or the Doors card on Home).
2. Unlock: press and hold the dial (about 0.7 seconds) – hint “Hold to unlock”. If confirmation is switched on for the lock, a tap is enough (“Unlock with Face ID”); the dialog “Confirmation” follows with Use Face ID / passkey or “Code from the authenticator app”.
3. Lock: tap the dial once (“Tap to lock”).
4. While it runs you see “Unlocking…”, “Connecting to the lock…” and, for a sleeping lock, “Waking the lock… 2/3” – LinArt tries up to three times, 2 seconds apart. “The gateway got the command…” means: the command is waiting in the gateway and will run shortly.
5. An error is shown in the hint line with Retry. After “Lock did not answer” or “Lock not responding. Is it near the gateway?” LinArt queries the status after 1.5 seconds, because the door may be open even though the answer was lost.

In the gateway panel it also works via Unlock → dialog “Unlock “Front door”?” → Yes, unlock, as well as Lock and Status. A lock may be unlocked only once every 3 seconds (“Too fast, wait 3 s” / “One moment…”).

Who may unlock a lock in a home where they are not the owner is decided by the policy “Family members may unlock” and the door share under Familie (DE); otherwise “The owner has turned off your access” appears.

Step by step: adding, renaming, removing a lock

Owners and co-admins only. The hardware steps (fitting the cylinder, placing the gateway, setting up Wi-Fi) are in the LockHub manual (DE) and in the guide “Setting up with LinArt” and are not repeated here.

1. In the gateway panel press Add lock. The wizard “Add a lock” searches for 120 seconds (“Looking for a new lock… 95 s left”); Stop cancels.
2. At the lock: “Touch the lock keypad to wake it. The lock must be in setting mode (new or reset).”
3. On success: “Lock added: …” – enter a name right away (up to 40 characters, no quotes) and Save.
4. If the wizard reports “This lock already has an owner.”, the lock must be freed first (TTLock app → delete lock, or hardware reset at the door; the panel unfolds the steps under “Hardware reset at the door”). Details: guide “The lock already has an owner”. For “No new lock found” see “Distance and signal”.

Rename: More → field “Name” → Save. If the gateway is offline at that moment, “name saved — the gateway gets it when it is online” appears.

Sync time: Sync time sets the lock's clock – important for time-limited codes. Members may do this too.

Remove: Remove lock safely resets the lock to factory settings: “… will be reset to factory settings: codes, cards and fingerprints stored in the lock are deleted. Stand near the lock and touch its keypad.” It always needs the second factor. Only for a broken or lost lock there is “Forget without reset (lock broken or lost)” – afterwards a hardware reset at the door is needed. Possible answers: “The lock is out of range. Touch its keypad and try again. Nothing changed.”, “Lock battery too low (under 15 %). Replace the batteries first. Nothing changed.”, “The lock was not changed. Try again next to the lock.”

Reset gateway: Reset gateway wipes Wi-Fi, local passwords, app keys, lock keys and LED settings; the gateway restarts in setup mode (blue), the cloud identity is kept. If locks are still paired, the dialog warns and offers Remove all locks first. See guide “Removing a lock or resetting the gateway”.

Step by step: opening “Data in the lock”

Everything stored in the lock is managed by owners and co-admins in the window “Data in the lock: <name>”.

1. Doors → at the lock More → Codes, cards, fingerprints….
2. The tabs Codes, Cards, Fingerprints, Passage mode, Lock journal and Settings appear only if the lock supports the function (line “Can do: Code · Card · Fingerprint …” in the panel).
3. In every tab first press Read from the lock (“Reading from the lock… up to 45 s”). Before that it says “Not read yet — the data lives in the lock itself.”; later Refresh.
4. On the first change within 24 hours LinArt asks for the second factor (dialog “Confirmation”). Without a second factor set up, “A second factor is needed — Settings → Security.” appears.

Over the cloud, codes are shown masked (••••15). Only the owner of the home can reveal them for 60 seconds with Show full codes: “The codes are visible for 60 seconds and stored nowhere. Over the cloud the gateway shows only the last 2 digits.”

Step by step: creating a permanent code

1. “Data in the lock” → tab Codes → Read from the lock.
2. In the field “Code (4–9 digits)” type a code or let Generate create a random 6-digit code.
3. Choose the type Permanent and press Add.
4. After “✓” the list is read again; the code is listed as “permanent”.

Error hints: “A code has 4 to 9 digits.”, “This code exists already.”, “The lock refused the code: it exists already or the memory is full.” (see Memory full), “The lock does not answer: it is at the edge of range …”, “The gateway is busy — try again in a few seconds.”

Step by step: creating a time-limited or one-time code

1. Tab Codes, type a code or Generate.
2. Time-limited: fill in the fields “From” and “To” (date and time, local time of the lock). The code is valid only in this window – the lock checks that itself, even without the gateway.
3. One-time: optionally “Valid until (default 24 h)”. The code works exactly once.
4. Add. The list shows the type and the window, e.g. “time-limited · 12.10.2026 15:00 — 14.10.2026 11:00”.

Step by step: code on a weekly schedule (weekly code)

A weekly code is valid every week only on certain days and hours – for example for the cleaning “workdays 8–12”. The lock itself cannot store such a thing; the gateway keeps the code in the lock only for the current or next window and moves it on afterwards. Prerequisite: LockHub firmware 0.7.4 or later (capability “weekly-codes”) – otherwise the section is missing.

1. Tab Codes, section “Weekly schedule” at the bottom → Read from the lock.
2. Enter the code in the field “Code (4–9 digits)” at the top (the hint “(Code: ↑)” points to it).
3. Choose the days: Workdays (Mon–Fri), Every day, Weekend (Sat, Sun) or Pick days with ticks Mon … Sun.
4. Set “Hours” from – to (if the end is before the start, the window runs into the next day).
5. Add a weekly code.

Every entry shows days and time and below it “in the lock now: 13.10.2026 08:00 - 13.10.2026 12:00” or “not in the lock yet (waiting for the window or the gateway)”. If the lock is not reachable at the moment: “Schedule saved; the lock is not reachable yet, the gateway retries every 5 minutes.” When deleting a schedule while the lock is not reachable: “Schedule deleted, but the lock is not reachable right now — the code in the lock stays valid until its window ends.”

Limits and errors: “At most 16 weekly codes per gateway.”, “Invalid days.”, “Invalid time.”, “This code exists already.”. If the gateway is off, the code expires with its window and does not stay valid (fail-closed). Child profiles with a schedule (Familie → Kinder (DE)) create exactly such codes.

Step by step: changing (rotating) or deleting a code

1. Tab Codes → Read from the lock.
2. Set a new code: enter the new code in the field “Code (4–9 digits)” at the top, then press Change in the row of the old code. The old code is replaced by the new one; type and window stay.
3. Delete: Delete in the row → question “Delete ••••15?”.
4. Delete all: Delete all → “Delete ALL codes from the lock "Front door"? This cannot be undone.” This also removes guest codes of the rentals and child codes.

If “The list was out of date — reloaded, please try again.” appears, the list in the lock has changed in the meantime; simply repeat the action. Guest codes of a booking are better changed in the booking with New door code (see Guest codes), a child's code with New code in the profile – then LinArt knows about the change.

Step by step: cards and fingerprints

1. Tab Cards or Fingerprints → Read from the lock. Entries appear as “№ 3 · always” or with a period.
2. Optionally set the fields “From”/“To” under “Validity (optional) — no limit / Change” (for time-limited cards).
3. Add a card: “Preparing the lock…”, then “Hold the card to the lock (30 s)…”.
   Add a fingerprint: “Put the finger on the lock several times (60 s)…” with the progress “touches: 3”.
4. Success: “Done: added, no. 4”. Abort: “Time is up — no card / finger.”, “No card was held to the lock.”, “No finger was put on the lock.”, “The lock refused.”
5. Changing the period later: fill in “From”/“To” and press Change in the row. Removing: Delete or Delete all.

Step by step: passage mode (door stays open)

“During these hours the lock does not lock — the door opens without a key.”

1. Tab Passage mode → Read from the lock.
2. “Days”: Every day or click single days Mon … Sun.
3. Enter “Time” from – to and Add.
4. Removing a window: Delete in the row; all: Delete all.

Step by step: lock journal, sound, screen, admin code

• Lock journal: choose “How many entries” 20 / 50 / 100 / 200, Read from the lock. Every line: time, event, possibly “codes ••15”, card number or fingerprint and “battery 90%”. This is the memory of the lock itself – unlike the history in the panel (see below).
• Settings: “Lock sound” and “Lock screen” with On / Off / Check (“now: On”). Some models answer “This lock cannot do that.”
• Lock admin code (the owner only, not co-admins): Show the admin code and Change the admin code. “The administrator code on the lock keypad. Secret — the owner only.”

History in the gateway panel (More): “History” shows the events of the last 7 days (“No events in 7 days.”), “Who did what” the actions from LinArt with e-mail and result. Anyone who is not owner or co-admin sees only their own entries there – unless the owner has shared the door history for everyone under Familie → Datenschutz (DE).

Step by step: automatic locking (auto-lock)

1. Gateway panel → More at the lock (owner/co-admin).
2. Field “Auto-lock, s (0 = off)”: enter seconds (0 to 900) and Save. Next to it: “now: 30 s”, “off” or “not read yet”.
3. Afterwards the dial shows “locks in 25 s” after unlocking; the event is called “Locked automatically”.

The field appears only if the lock supports auto-lock and the gateway firmware reports the value.

Step by step: confirming unlocks and allowing members (policies)

Owners and co-admins only, in the gateway panel under More:

• “Confirm unlocking (Face ID / code)” – every remote unlock requires the second factor (for everyone who may unlock this door). Switching it on requires a second factor that is set up (Settings → Security); switching it off requires a confirmation.
• “Family members may unlock” – on by default. Off = members and guests no longer see this lock, offline keys already issued are revoked. Switching it back on requires a confirmation.

Which doors an individual member or guest gets is set under Familie → Mitglied → Türen (DE).

Guest codes from the rentals

If a property under Rentals → Properties has doors assigned (“These locks get the guests' door code automatically.”), LinArt writes one door code to each of these doors for every confirmed booking – without you doing anything. You do not have to create the codes under “Data in the lock”.

Reading the code state

Under Rentals → Today every arrival carries a chip: “Door code active” (on every door), “Door code scheduled” (still to be written), “Door code missing” (at least one door failed), “no door”, “Door code removed”. Under “Needs attention” you find “Door code not on the lock: <property> · <door> · error” and “Gateway offline: …”.

In the booking (Details) the card “Door code: 482915” shows the state per door: “on the lock”, “waiting”, “error”, “being rewritten”, “removed”, “removal failed”, the cause of the error in brackets, below it “valid … – …”. Before the time of writing: “The door code is written to the locks automatically <time>.”; without a door: “No door is assigned to this property yet.”

Writing now or changing the door code

1. Rentals → Bookings (or Today) → Details of the booking.
2. Write now triggers the reconciliation for this booking at once instead of waiting for the next run.
3. New door code → “Create a new door code? The old door code is removed from every door; send the guest the link again afterwards (the card shows the new door code).” Before the first write LinArt answers “There is no door code for this booking yet.”

The guest sees their door code on the stay card from 24 hours before arrival; the message templates never contain the code (“The door code is not in it — the guest sees it on the card from 24 h before arrival.”). The guest's door code is visible only to hosts and co-admins – staff see only first names. Everything else about the host side: Rentals for hosts.

Step by step: the gateway's Wi-Fi networks

Owners and co-admins only, and only while the gateway is online (LockHub 0.6.1 or later). The gateway remembers up to 5 networks and switches to the strongest one by itself.

1. Gateway panel → unfold Gateway Wi-Fi networks at the very bottom. You see “now: <network> (-61 dBm) · remembers up to 5 networks” and the list with “current” / “last used”.
2. Add a network: fill in “Network name (SSID)” and “Password (empty = open network)” → Add network. Answer: “A new network applies the next time the gateway connects.” On “Check the network name (up to 32 bytes) and the password (8–63 characters, no quotes).” correct the input.
3. Forget a network: Forget in the row → “Forget the network “…”?”.
4. Forget all networks: Forget all networks → “The gateway forgets all Wi-Fi networks and opens Bluetooth set-up after a drop-out. Continue?” – needs the second factor. Afterwards set up the Wi-Fi again as in the LockHub manual (DE).

Passwords are never shown. To move to another Wi-Fi: first add the new network, then forget the old one. The gateway's status LED is tested and dimmed there as well (Test (~34 s), “brightness”, on/off; see “The gateway's indicator”).

Step by step: showing or hiding the doors on Home

1. On Home press Hide in the Doors card (“Remove the doors from Home. Bring them back: Locks in the left panel.”).
2. To show them again, tick “Show doors on Home” on Doors. The setting applies to you only.

While the state of all doors is unknown (gateway offline), Home shows only a compact line “Doors · ? No connection: …” with Check.

What happens if …

… a code does not arrive in the lock

A code (guest code, child code, weekly schedule or created by hand) is stored in the lock only if the gateway is online and the lock is reachable over Bluetooth and there is room in the lock. Check in this order:

1. Gateway online? Header of the panel (“gateway offline”) or the hint “Gateway unreachable.” → Gateway offline.
2. Lock reachable? Messages “The lock does not answer: it is at the edge of range. Move closer or put the gateway nearer the lock, and touch the lock keypad to wake it.”, “The lock did not answer in time.”, “Lock out of range” → Lock out of range.
3. Memory full or duplicate code? “The lock refused the code: it exists already or the memory is full.” → Memory full.
4. Gateway busy? “The gateway is busy — try again in a few seconds.” – another command is running (reading lists takes up to 45 s). Wait a moment.
5. Answer still on its way? “The gateway got the command; the answer comes later — press Refresh.”

Guest codes and child codes are then written again by LinArt itself (guest codes on the next reconciliation, children with Write again). If a guest code is still missing 2 hours before arrival, the notice “Door code missing” is sent; the guest then needs a key safe or a mechanical key. Codes you created by hand you create again after fixing the cause.

… the gateway is offline

The dials are locked (“Gateway offline · last 14:05”), lists cannot be read, and automatic codes wait. What keeps working: all codes, cards and fingerprints that are already in the lock (the lock checks them itself, time-limited ones too), the keypad on the lock and offline keys of the iPhone app (owners up to 24 hours, members 8 hours, guests 2 hours from the last fetch). Weekly codes expire with their window and are set again only when the gateway is back.

Check: power at the gateway, the router, then Refresh in the panel. If the gateway has had no network for more than 10 minutes, it shows blue and waits for set-up over Bluetooth (guide “Distance and signal”). Changing the Wi-Fi: Gateway Wi-Fi networks; setting up again: LockHub manual (DE).

… the lock is out of range

The gateway has not heard the lock in the last minute. Touch the keypad to wake it and repeat – LinArt tries commands three times anyway. Permanently: place the gateway at most two walls away from the lock, ideally with a line of sight; metal and concrete dampen strongly. The link How to fix this → below the error message opens the matching section of the guide. Very weak batteries also show up as a range problem (Battery).

… the lock's memory is full

Message “The lock refused the code: it exists already or the memory is full.” (for guest codes the cause code_rejected). What to do: tab Codes → Read from the lock → remove old time-limited, one-time and no longer needed codes with Delete; likewise old cards and fingerprints. If the new code is already in the list, it is already valid. For weekly codes the limit of 16 per gateway applies as well.

… the battery is low

From 25 % the dial shows “Battery 22%” underneath, red from 10 %. Below 15 % LinArt refuses removing/resetting (“Lock battery too low (under 15 %). Replace the batteries first. Nothing changed.”). Replace the batteries, then press Status. The battery level is also shown per event in the lock journal. Replacement and emergency power: “Batteries and power”.

… the state stays “unknown”

Tap the dial = Check. If it stays that way: gateway online? Lock in range? A lock reports its state only while it is awake – a tap on the keypad helps.

… the second factor is asked for or none is set up

Codes, cards, fingerprints and the admin code: “Confirmation” once per 24 hours. Removing, resetting, “Forget all networks” and relaxing a policy: always. Without a factor set up: “This action needs a second factor. Set up Face ID or an authenticator app: Settings → Security.” – see Konto & Sicherheit (DE).

… the gateway was reset to factory settings

For 14 days the panel shows “Gateway factory-reset on …: set up Wi-Fi and add the locks again. Offline keys were revoked.”; the owner gets a push notification and an e-mail. If this was not intended, someone had physical access. If another account tries to add the gateway, you are asked whether to release it or keep it (see Geräte (DE)).

… a member is removed or gets fewer doors

Access through the cloud ends immediately, offline keys of the app are revoked (the gateway rejects them as soon as it is online). Codes, cards or fingerprints that this person had in the lock stay there – check “Data in the lock” and delete them if needed. Details: Familie → Mitglied entfernen (DE).

Who may do what (roles) · What is in the plan

Plans: The Doors section is included in every plan as soon as a LockHub is in the home; there is no limit on locks other than the plan's device limit (see Tarif & Abrechnung (DE)). How many people and guests may be invited is under Familie → Rollen und Tarife (DE). Guest codes from the rentals need a property under Rentals (Rental plan, or 1 property in Family / Power / Unlimited) – see Rentals for hosts.

Frequently asked questions

Why don't I see the door code, only “••••15”?

Over the cloud the gateway shows only the last two digits. Only the owner of the home can see all digits for 60 seconds with Show full codes; co-admins always see codes masked. Child codes are shown in plain text to owners and co-admins on the page Familie → Kinder (DE); guest door codes are in the booking under Rentals.

Why don't I see a lock that exists in the home?

As a family member or guest you see only doors that have been shared with you under Family and for which “Family members may unlock” is on. Viewers see no doors at all. In the rentals, managers and staff see only the doors of their properties. As a guest the visibility ends with “Access until”. Ask the owner or use Ask for more access on Familie (DE).

Why does reading the codes take so long?

Lists and the journal are fetched from the lock over Bluetooth – 5 to 30 seconds, the server waits up to 45 seconds. That is normal. If “The gateway got the command; the answer comes later” appears, simply press Refresh.

Does a code work if the internet or the gateway fails?

Yes. Permanent, time-limited and one-time codes, cards and fingerprints live in the lock and are checked there – the time window too. Only weekly codes need the gateway: without the gateway they expire with their current window. Unlocking doors remotely does not work without the gateway; the iPhone app unlocks over Bluetooth with an offline key (owners 24 h, members 8 h, guests 2 h).

Why am I asked for Face ID or a code when unlocking?

“Confirm unlocking (Face ID / code)” is switched on for this lock (shield symbol). The owner or a co-admin can change that in the gateway panel under More. Anyone without a second factor yet sets it up under Settings → Security.

How do I give the cleaner or the babysitter a code?

For fixed times every week: weekly code. For a period: time-limited code. For one visit: one-time code. If the person should unlock with their phone instead, invite them as a guest with “Access until” (Familie → einladen (DE)). In the rentals, cleaners get their code automatically per cleaning task.

The guest arrives in two hours and the code is missing – what now?

Press Write now in the booking and read the state per door. If it says “error (gatewayUnreachable)”, the gateway is offline (Gateway offline); for “lock_out_of_range” wake the lock (Range); for “code_rejected” delete old codes (Memory full). If it does not work in time, tell the guest about the key safe or a mechanical key – or create a time-limited code by hand on site as soon as the lock is reachable.

Can I leave a door permanently open at certain times?

Yes, with the passage mode: during the set hours the lock does not lock.

What does “as of 2 h ago” under a door mean?

The last known state is older than 30 minutes. The lock reports only on events; with Check (tap on the dial) you fetch the current state.

What happens to the codes when I remove a lock?

Remove lock resets the lock: all codes, cards and fingerprints in the lock are deleted. Only “Forget without reset” leaves the lock unchanged – it then keeps an admin without keys and needs a hardware reset at the door.

How do I move the gateway to a new Wi-Fi?

While it is still online: add the network, then forget the old one. If it is already offline: set-up over Bluetooth as in the LockHub manual (DE) (the gateway shows blue after more than 10 minutes without a network).

Terms

LockHub (gateway)

The device that talks to the locks over Bluetooth and to LinArt over Wi-Fi. One per site; several locks per gateway.

Dial (“Bolt Dial”)

The round control per door on Home and Doors: hold = unlock, tap = lock or check.

Data in the lock

Codes, cards, fingerprints, passage mode, journal and settings that live in the lock itself and are read over Bluetooth.

Permanent / Time-limited / One-time

Types of a code: without an end; with a from–to window (checked by the lock itself); valid exactly once (default 24 h).

Weekly code

A code that is valid every week only in a day/hour window; the gateway puts it into the lock window by window. At most 16 per gateway, LockHub 0.7.4 or later.

Passage mode

Times during which the lock does not lock.

Auto-lock

The lock bolts itself after the set number of seconds (0–900 s).

Policy

Per lock: “Confirm unlocking (Face ID / code)” and “Family members may unlock”.

Second factor / confirmation

Face ID / passkey or authenticator code, for codes once per 24 h, for removing and resetting always.

Guest door code

The code LinArt writes automatically to the doors of the property for a booking (48 h before arrival until departure + 30 min).

Code state

“Door code active” (present), “Door code scheduled” (pending), “Door code missing” (failed), “Door code removed” (removed) – per booking; per door additionally “being rewritten” and “removal failed”.

Offline key (grant)

A key signed by the server in the iPhone app that unlocks the door over Bluetooth even without internet; lifetime by role (24 h / 8 h / 2 h).

History / Who did what

The lock's events of the last 7 days and the actions from LinArt with person and result (retention as per the privacy setting (DE)).

See also

• Familie & Team (DE) – sharing doors per member
• Familie & Team (DE) – child profiles with door code and schedule
• Rentals for hosts – properties, doors, bookings and the guest's door code
• For guests – the stay card and the door code from the guest's point of view
• Zuhause (DE) – the Doors card on Home
• Geräte (DE) – adding a LockHub, releasing the gateway after a reset
• Konto & Sicherheit (DE) – Face ID, passkey, authenticator app
• Alarme (DE) – notifications about battery and gateway
• Tarif & Abrechnung (DE)
• Help
• LockHub gateway (DE) – hardware, set-up, console commands
• Product guide lock cylinder – fitting, batteries, range, reset