Table of Contents
1. Introduction
GokiAirs offers a convenient solution for managing your devices remotely by enabling internet connectivity for your locks. By utilizing GokiAirs, you gain access to additional features that enhance your property management capabilities. For more detailed information on the functionalities and benefits of GokiAirs, please take a look at the documentation provided here.
Before you start:
Download the Spaces App
Make sure you have Bluetooth and Location enabled while connecting the device.
Warning:
If you have a firewall in your network, it is crucial to ensure that it does not block the connection to plug.goki.travel:2999 or its alias, saas-gateways-socket.goki.travel:2999. Blocking this connection can result in a timeout error, preventing successful communication with the Goki system.
2. Steps to connect the GokiAir G2 (Wi-Fi)
GokiAir G2
Model: G2
Dimensions: 70mm x 70mm x 26mm
Network: WiFi 2.4G
IEEE Standard: 802.11 b/g/n
Power Interface: Type C - USB
Power Input: DC 5V / 500mA
Open the Spaces App
Plug in the gateway and power it on, while the light flashes alternately in red and blue
Go to Settings (left-side menu) > select GokiAir > click the “+” button or tap Add Devices from the menu (Connect GokiAir Wi-Fi)
Select your GokiAir device from the list (The device has a default name which you can change to whatever suits you)
Connect the GokiAir to Wi-Fi (Choose Wi-Fi from the list or add it manually if it is not listed).
Enter the password
Your GokiAir is Ready!
3. Steps to connect the GokiAir G3P (Ethernet)
Open the Spaces App
Plug in the gateway and power it on either via Ethernet or USB-C cable, while the light flashes alternately in red and blue
Go to Settings (left-side menu) > select GokiAir > click the “+” button or tap Add Devices from the menu (Connect GokiAir Ethernet).
Select your device from the list (The device has a default name which you can change to whatever suits you).
Your GokiAir is Ready!
4. Additional notes:
GokiAir G2 - user should disconnect and reconnect the power and it will be ready for setup for a minute.
If the Wi-Fi doesn’t show up, it could be one of the following reasons:
The Wi-Fi is hidden (SSID is not broadcasting), but still can connect by entering the name manually
The Wi-Fi is not reachable for the GokiAir (Is it too far?)
The Wi-Fi frequency bands are not supported by the GokiAir, (for example 5G networks are not supported by the GokiAir, but 2.4G frequency is OK)
Once the GokiAir is connected and ready, it will detect nearby Goki devices.
Connected devices show online status and they will be listed once you click on the GokiAir name.
All nearby locks should be detected in a minute automatically.
You won't see the Lock's list until you use the GokiAir for the particular Lock. After doing any action via GokiAir you'll get the list of those Locks.
Unlocking the lock or just entering a PIN may cause it to be detected faster as the lock will send logs.
5-Gokiair signals are weak/Guidelines. How to fix it?
Goki Bluetooth Gateways Installation Guidelines1. OPTIMAL GATEWAY PLACEMENT BY BUILDING TYPE
Standard Construction (Drywall and Wood Frame)
Coverage
: One gateway per 4 guest rooms maximum
Mounting height
: 4 feet (1.2m) from floor level
Maximum range
: 30 feet (9m) from furthest door
Concrete and Brick Buildings
Coverage
: One gateway per 2-3 guest rooms
Mounting height
: 4 feet (1.2m) from floor level
Maximum range
: 15-20 feet (4.5-6m) from furthest door
Additional consideration
: Install supplementary gateways near particularly thick walls
Modern Steel Frame Construction
Coverage
: One gateway per 3-4 guest rooms
Mounting height
: 4 feet (1.2m) from floor level
Special consideration
: Avoid direct mounting on metal surfaces
Universal Placement Principles
Position gateways in corridor centers to maximize coverage on both sides
Maintain line of sight to doors whenever possible
Install within proximity to power or network infrastructure
Maintain consistent height aligned with door hardware
Ensure minimum 3-foot clearance from other electronic equipment
Areas Requiring Additional Coverage
Elevator lobbies
: Install gateways on both sides of elevator banks
Stairwells
: Require one gateway per floor level
Extended corridors
: Additional gateway every 50 feet
Meeting spaces
: Dedicated gateway for each conference room
Building corners
: Signal does not propagate around corners effectively
2. SIGNAL ATTENUATION FACTORS
Complete Signal Barriers
The following obstacles prevent signal transmission entirely:
Elevator shafts and cars
Fire-rated metal doors
Electrical and mechanical rooms
Commercial kitchen areas
(microwave interference)
Severe Signal Reduction (75% Range Loss)
These materials and obstacles significantly impair connectivity:
Reinforced concrete walls
Mirror installations
(large wall-mounted mirrors)
Metal door frames and fire exits
Bathroom walls
(combination of plumbing and tile)
Masonry walls
(particularly thick or historic brick)
Moderate Signal Reduction (50% Range Loss)
Common building elements that reduce effective range:
Multiple gypsum board walls
Metal decorative elements or signage
Storage areas with metal shelving
High-density guest areas
(device interference during peak occupancy)
Installation Verification
A practical rule for installers: If a direct walking path from the gateway to the door is obstructed, signal propagation will be similarly impaired. Additional gateways should be installed to ensure reliable coverage.
RECOMMENDATION
For optimal guest experience and system reliability, we recommend installing one gateway per four guest rooms as a maximum coverage ratio. In buildings with challenging construction materials or layouts, this ratio should be reduced further to ensure consistent connectivity and minimize potential service disruptions.