TTLock gateway setup: adding a G2, 2.4 GHz Wi-Fi and common problems
A TTLock lock only speaks Bluetooth. To manage it from the other side of town it needs a go-between that sits near the door and has internet access. That go-between is the gateway, and the most common one is the G2 on Wi-Fi.
In short A G2 gateway is added in the TTLock app in six steps: a 2.4 GHz Wi-Fi network, locks on the same account, power, the Gateway item in the menu, the Wi-Fi password and a remote test. The gateway finds nearby locks by itself and connects to those that belong to the same administrator account. If adding it fails, the vendor's advice is to cut the power and try again. The usual causes of trouble are a 5 GHz network, a lock on a different account and too much distance from the door.
What a gateway adds
The TTLock help centre lists eight things that only work with a gateway. All of them are about working from a distance.
| Function | With a gateway | Without one |
|---|---|---|
| Remote unlock | yes | no |
| Editing and deleting a passcode remotely | yes | no |
| Creating a custom passcode remotely | yes | no |
| Adding, editing and deleting cards remotely | yes | no |
| Managing fingerprints remotely | yes | no |
| Unlock records uploaded automatically | yes | no |
| Changing lock settings remotely | yes | no |
| Reading the lock's time and status remotely | yes | no |
Without a gateway the lock still opens with a code, a card and a phone at the door. Not every code needs a gateway either: the difference between random and custom codes is explained in TTLock passcode types. Locks with built-in Wi-Fi connect to the network themselves and do not need a gateway.
What the G2 gateway needs
- A 2.4 GHz Wi-Fi network. The G2 manual linked from the TTLock documentation specifies 2.4 GHz Wi-Fi, IEEE 802.11 b/g/n. The gateway will not join a 5 GHz band.
- Power. The same manual gives a USB Type-C socket and a 5 V, 500 mA input. Versions sold under other brands can differ, so use the adapter that came in the box.
- A spot near the door. The help centre gives a range of 10 metres with no obstacles. Walls and floors shorten it.
- A phone with the TTLock app and the account that already holds the locks.
How to add a G2 gateway to the app: six steps
1. Prepare a 2.4 GHz Wi-Fi network
Check in the router that the 2.4 GHz band is switched on and have the password ready. If the router broadcasts both bands under one name and the gateway will not connect, set up a separate 2.4 GHz network, for example a network for devices.
2. Log in to the account that holds the locks
According to the TTLock Open Platform documentation, a gateway connects only to locks that belong to the same administrator account. You do not bind locks by hand, but a gateway added on a different account will not see them at all.
3. Plug the gateway in and wait for the light
Power the gateway in the place where it is going to work. The G2 manual describes the stand-by state, ready for pairing: the light flashes alternately in red and blue.
4. Open the Gateway item in the app
The help centre gives the path: the menu button with three lines, then Gateway, then the plus sign at the top right of the gateway page. From the list of types choose G2, the Wi-Fi gateway. The app looks for the gateway nearby.
5. Choose the network, enter the password and name the gateway
Select the 2.4 GHz network and type its password. Give the gateway a name that says where it is, such as "Corridor, first floor". With a dozen gateways a good name saves you from hunting through serial numbers.
6. Check the locks on the gateway and run a test
On the gateway page the app shows its type, its status and the number of nearby locks. The gateway also appears in the lock's settings. Finally close the doors and run one remote operation on the farthest lock, ideally by adding a custom passcode and opening the door with it. Only that confirms the whole path from the internet to the lock.
Common problems and what to do
| Symptom | Most likely cause | What to do |
|---|---|---|
| Adding the gateway times out | the gateway left pairing mode or did not join the network | power it off, power it on and add it again, as the manual and the help centre advise |
| The gateway will not join the Wi-Fi | a 5 GHz network, or one name shared by both bands | connect it to a 2.4 GHz network |
| The gateway is online but cannot see the lock | the lock is on another account or too far away | check which account administers the lock and move the gateway closer to the door |
| A remote operation is slow or fails | weak signal between the gateway and the lock | shorten the distance, remove obstacles, wait and try again |
| The gateway went offline after a new router or password | it only knows the old network | set up its network again |
The developer documentation explains why remote operations can be temperamental. The gateway reaches the lock over Bluetooth, and setting up that connection takes several seconds. A gateway and a lock hold one connection at a time, so commands have to be sent one after another: a second one sent before the first has finished is bound to fail. Touching the lock's keypad during an operation also breaks the connection. The server waits up to 30 seconds for an answer.
What happens to codes when the gateway or the internet goes down is covered in the guide on a dead battery or no internet.
How many locks per gateway
The TTLock documentation says a gateway can connect to many locks and sets no limit on their number. When a lock is within reach of several gateways on the same account, the server picks the one with the best signal. BH WANDEX, which installs these gateways in Poland, works with a more cautious figure: one gateway for six hotel locks. A technical limit and the number at which everything runs reliably are two different things, because distance and walls decide the outcome. In practice every group of doors close together, such as a corridor, a floor or a separate building, gets at least one gateway.
By hand in the TTLock app or automatically with PinRoom
By hand in the TTLock app. The gateway gives you remote access, but you still do every task yourself: you create the code, change it when the dates move, delete it after a cancellation, and you find out that the gateway has dropped off the network on your own, usually when the next code refuses to save.
Automatically with PinRoom. PinRoom uses the same gateway and does the work for you. It writes codes from bookings to the locks remotely and reads the state of the locks every hour. When a lock has no connection on two readings in a row, the owner gets an SMS and an email with its name. If a code could not be saved because the gateway was briefly unavailable, PinRoom retries after 5, 10, 20 and 40 minutes and then every hour. PinRoom does not work without a gateway within range of every lock, which is why choosing and placing gateways is part of the quote from BH WANDEX for properties in Poland.
Already have TTLock locks and wondering how many gateways your building needs? Write to us through the contact form. Gateways and locks are listed in the lock catalogue, the routes from a reservation to a code are on the page about TTLock and Booking.com, and the whole plan, from counting doors to the first guests, is in how to switch from keys to door codes.
Sources, read on 13 November 2026: TTLock help centre, devices; TTLock Open Platform, unlock via network (gateway) with the linked G2 manual; wandex.pl, hotel code locks (in Polish). The description of PinRoom comes from the software as of 13 November 2026. PinRoom is not affiliated with the maker of the TTLock app.
Questions about the TTLock gateway
Does the TTLock G2 gateway work on 5 GHz Wi-Fi?
No. The G2 manual specifies a 2.4 GHz Wi-Fi network, IEEE 802.11 b/g/n. If your router broadcasts both bands under one name, the safest fix is a separate 2.4 GHz network for the gateway.
Why can my gateway not see the lock?
According to the TTLock documentation a gateway connects only to locks on the same administrator account, so first check whose account the lock is on. The second cause is distance: the help centre gives a range of 10 metres with no obstacles.
How close to the lock should the gateway be?
The TTLock help centre gives 10 metres in open space. Inside a building, load-bearing walls, floors and heavy doors shorten that, so test the spot with a remote operation while the doors are closed.
What should I do when adding the gateway fails?
Unplug the gateway, plug it back in, wait until the light flashes alternately in red and blue, and add it again. This is what the G2 manual and the TTLock help centre advise.
Can one gateway handle every lock in the property?
The TTLock documentation sets no limit on the number of locks per gateway, but Bluetooth range does. BH WANDEX plans one gateway for six hotel locks that are close together, and separate buildings and floors get their own gateways.
Can I give a guest a code without a gateway?
Yes. A random passcode, such as a timed one, is created without a gateway. What you cannot do without one is change or delete a code remotely, add a custom passcode remotely or unlock the door from a distance.
See also
- TTLock passcode types explainedPermanent, timed, one-time, recurring, erase and custom: when to use which.
- Smart lock battery dead or no internetWhat still works offline, how to open a lock with a flat battery, a backup plan.
- How to switch from keys to door codesSeven steps: doors, internet, bookings, installation, testing and the first weeks.
- Lock catalogueCode and card locks, entrance readers and Wi-Fi gateways from BH WANDEX.
- TTLock and Booking.comThree ways to turn a Booking.com reservation into a TTLock code.
See the panel on a demo property
The demo opens without login and nothing you do there is saved or sent. The panel is in Polish for now.