Install GateStride yourself, free for one door
If you are comfortable with a Raspberry Pi and a command line, you can run GateStride on your own hardware. Everything below is the same software our installers use. The free licence covers one door with no end date; contact us for more doors or for an installer near you.
What you need
| For the building | One computer that stays on, on the same network as your access control: Windows 10/11 (x64), or Linux with systemd (x86_64 or arm64, e.g. a Raspberry Pi 4/5 or a mini PC). This runs gsmain. |
|---|---|
| For each door | Raspberry Pi 4/5 (2 GB+) with Raspberry Pi OS 64-bit, an ESP32-WROOM-32U board with a 2.4 GHz antenna, and an HLK-LD2450 24 GHz radar. This is a gsnode. Wire the radar to the ESP32: LD2450 TX → GPIO16, RX → GPIO17, 5V, GND. The ESP32 plugs into the Pi by USB. |
| Phones | Android 8 or later for GateStride Pass (staff) and GateSmith (you, for setup). |
| Access control | An operator account in your access control system reserved for GateStride (one session, not shared with a person). |
Downloads
| File | For | SHA-256 |
|---|---|---|
| gsmain 2026.11.11, Windows x64 24.3 MB · signature | gsmain | f074c35fd4abe0ec89be5f08dee83568508c4efc1fce84137292bb5f8e2d4357 |
| gsmain 2026.11.11, Linux x86_64 21.8 MB · signature | gsmain | bc59bd1c3cc1ed8b088fe7cd465743742e8c8d51dd160b03332061d212b88092 |
| gsmain 2026.11.11, Linux arm64 18.3 MB · signature | gsmain | 04010156c0092b29dcc734822659517f404243699d6874cbe1a53e6f6189395d |
| gsnode 2026.10.25 119 KB · Raspberry Pi / Debian · signature | each door | eb4c18067ea1bd9b7c516a3f55d8105a0a79005936824f4895829b3202baa3aa |
| ESP32 door firmware 2.1 MB · version + signature | each door | f8c7e6ca02c894e37d5188e78493905fabbfde9bef533f4b9ab12ccd49428dbe |
| GateSmith 0.85 (Android) 125 MB · installer app | you | 204e2259cbb314aa02907ae3f976393288349edab2efaeba6c86b18237321ca1 |
| GateStride Pass 1.21 (Android) 5.3 MB · staff app | staff | 67584a02a3d682525cee503ebc89ffe72f698313957287bd1ad3473f67a8538f |
1. Install gsmain
Windows: unzip, then in PowerShell as Administrator:
powershell -ExecutionPolicy Bypass -File gsmain\install.ps1
Linux:
tar xzf gsmain-2026.11.11-linux-*.tar.gz && cd gsmain && sudo ./install.sh
It runs as a service that starts at boot. The installer prints a one-time password for the owner
account: sign in at https://<that-computer>:8790/ and change it. gsmain carries its own Python;
nothing else needs installing.
2. Register (free, one door)
In gsmain open Backup → Licence → Activate. It shows a link and a code: open the link on any device, sign in with Google, confirm. gsmain registers itself within seconds. No internet on that computer? Use Offline request and email the file to [email protected].
3. Connect your access control
In Underlying system, pick your system, enter its address and the operator account reserved for GateStride, then use Test. The health view shows each link (server, login, gateway, door) and, if one fails, whose equipment it is.
4. Build the door node
- Flash the ESP32 once from the Pi (afterwards the node keeps it updated by itself, with signed firmware):
wget https://gatestride.com/download/firmware/esp32_node.bin sha256sum esp32_node.bin # compare with the table above sudo apt install -y esptool python3 -m esptool --chip esp32 --port /dev/ttyUSB0 write_flash 0x0 esp32_node.bin - Install gsnode:
On the same network it finds gsmain by itself. Elsewhere, create a Remote node claim code in gsmain (Door nodes) and runtar xzf gsnode-2026.10.25.tar.gz && cd gsnode && sudo ./install.shsudo ./install.sh --claim <code>. - In gsmain → Door nodes, approve the new node and pick the door it opens. It takes its door identity and signed credentials from gsmain within seconds.
5. Calibrate and add people
Open GateSmith next to the door: it finds the node and walks you through the radar calibration (where the door line is, which side is inside). Then add people in gsmain and send each one an invite: they open it on their phone, GateStride Pass installs their badge, and the door opens as they walk up.
Check a download
Every installer has a .sig file: an Ed25519 signature by the GateStride release key over the file.
python3 - gsnode-2026.10.25.tar.gz <<'EOF'
import base64, sys
from cryptography.hazmat.primitives.serialization import load_pem_public_key
pub = load_pem_public_key(b"-----BEGIN PUBLIC KEY-----\nMCowBQYDK2VwAyEACeCbYu6fl67waUI68d/SW9HjeMSzp1Dng4MhfewYWGc=\n-----END PUBLIC KEY-----\n")
pub.verify(base64.b64decode(open(sys.argv[1] + ".sig").read()), open(sys.argv[1], "rb").read())
print("signature OK")
EOF
The Android apps are signed with their own keys: GateStride Pass certificate SHA-256
20b2f66e…608b, GateSmith 0338ed10…faa5. Android refuses an update signed by anyone else.
Self-installed GateStride is provided as is. You are responsible for using it with access control you are allowed to operate. Kantech, EntraPass and other names are trademarks of their owners; GateStride is independent and not affiliated with or endorsed by them.