Skip to content

Quick start

From a blank Raspberry Pi to an adopted gateway. For a RAK or GL.iNet unit, see its hardware page: those boot from soldered flash and install differently.

Take the image for your board from the latest release:

File Use it for
PulzrOS-<version>-<board>.img.xz writing a blank card
PulzrOS-<version>-<board>.img.gz the same, for a writer that does not take xz
PulzrOS-<version>-<board>-sysupgrade.img.gz upgrading a gateway that already runs PulzrOS
*.pulzr.json the image’s signature, checked by the gateway on upgrade
sha256sums.txt checking the download

Raspberry Pi Imager: Choose OS > Use custom, pick the .img.xz, write. Leave Imager’s OS customization off; OpenWrt does not read it. Etcher, Rufus and dd work as well.

Or, from a clone of this repository:

Terminal window
./flash.sh --download rpi4

It refuses internal disks and asks you to type the disk identifier. See Flashing.

Give it a minute on first boot. Then either:

  • Plug it into a network with internet. It registers itself and appears in the pending list of the cloud it adopts into.
  • Plug a laptop straight into its ethernet port and open https://pulzr-<serial>.local, or https://192.168.61.1 when mDNS is blocked. Your laptop self-assigns 169.254.x.x and says it has no internet; that is expected.

The initial password is on the card’s boot partition as pulzr-initial-password.txt. The console makes you change it.

The console, the serial banner and the SSH banner all show a claim code. Scan it or enter it at https://app.pulzr.net/adopt, sign in and pick the organization. The gateway finishes adopting itself: it takes its MQTT credentials, enrols its management tunnel and turns off local password sign-in. See One-touch provisioning.

To adopt into your own cloud instead, build with your own endpoints: see Building from source.