Download and verify
Download the image below. Compare its SHA-256 value before writing it to storage.
Primary system image
GeoBridge OS
Prepare a new Raspberry Pi deployment or recovery drive. Read the steps first, then download and flash the image to the intended storage device.
!
Flashing erases the selected drive.Disconnect unrelated USB drives first and confirm the destination device by both name and capacity.
Installation
The compressed image can be written directly; manual extraction is not required.
Write the image
Open Raspberry Pi Imager or balenaEtcher, choose the downloaded .img.gz file, then select the correct SD card or SSD.
Validate and eject
Let the writer finish its verification pass. Safely eject the media only after validation completes.
Connect the hardware and boot
Insert the prepared media, attach the supported receiver using the intended USB, Ethernet or AP-mode path, connect the internet path, then power on. First boot may take several minutes.
Open first-time setup
Join the GeoBridge-Setup Wi-Fi network from a phone or computer. The setup page should open automatically; if it does not, browse to http://10.42.0.1.
Select the receiver path
Choose the real receiver model and its data connection. Confirm every cable endpoint; a link light alone cannot identify whether a cable leads to the receiver or router.
Configure internet
Select Ethernet or router Wi-Fi for the device uplink. If the receiver itself uses AP mode, keep a separate wired internet path available.
License and local access
Enter the GeoBridge license and create the dashboard administrator password. Add optional Onocoy or Tailscale settings only when they are required for this deployment.
Apply the configuration
Review the summary, keep power connected and start setup. The setup Wi-Fi can disappear while the device joins its final network; this is expected.
Reconnect to the dashboard
Return your phone or computer to the normal network. Open the device using the address shown by setup, its router address, or its Tailscale name/IP if enabled. Sign in with the administrator password.
Confirm the device is active
Do not stop at a green network light. Confirm the final state in the dashboard and Diagnostics.
License reports activeReceiver link is connectedLive data counters advanceRequired uploader is connectedTime and network are healthyNo critical Diagnostics error
Ready to flash?
GeoBridge OS 2.2.8 · compressed Raspberry Pi image
cf5c5f024f811ff45f1fc45b92d91a9a6fd9426003f8219cf17770d5336ab963