The ChirpStack Gateway OS is an embedded OS for LoRa gateways. It is part of the ChirpStack open-source LoRaWAN Network Server stack.

The goal of the ChirpStack Gateway OS is to provide firmware images that are easy to setup, maintain and customize.

An image providing the Semtech Packet Forwarder and ChirpStack Gateway Bridge.

Provides the following features:

• Monit based service monitoring
• ChirpStack Concentratord
• ChirpStack Gateway Bridge

An image providing a complete LoRaWAN network-server running on the gateway.

Provides the following features:

• Monit based service monitoring
• ChirpStack Concentratord
• ChirpStack Gateway Bridge
• ChirpStack Network Server
• ChirpStack Application Server
• Mosquitto MQTT broker
• Redis
• PostgreSQL

• Raspberry Pi Zero W
• Raspberry Pi 1
• Raspberry Pi 3
• Raspberry Pi 4

• IMST - iC880A
• IMST - iC980A
• IMST - Lite Gateway
• Pi Supply - LoRa Gateway Hat
• RAK - RAK2245
• RAK - RAK2246 / RAK2246G
• RAK - RAK831 Gateway Developer Kit
• RisingHF - RHF0M301 LoRaWAN IoT Discovery Kit
• Sandbox Electronics - LoRaGo PORT
• Semtech - SX1302 CoreCell

The default username is admin with password admin.

Execute the following command as admin user:

sudo gateway-config

A Docker based build environment is provided for compiling the images.

Run the following command to fetch the git submodules and setup directory permissions (to write back from the Docker container):

# update the submodules
make submodules

# setup permissions
make permissions

Run the following command to set the /build folder permissions:

# on the host
docker-compose run --rm busybox

# within the container
chown 999:999 /build

Run the following command to setup the build environment:

# on the host
docker-compose run --rm yocto bash

# within the container

# initialize the yocto / openembedded build environment
source oe-init-build-env /build/ /chirpstack-gateway-os/bitbake/


# build the chirpstack-gateway-os-base image
bitbake chirpstack-gateway-os-base

By default, Raspberry Pi3 is configured as the target platform. You need to update the following configuration files to configure a different target:

• /build/config/local.conf
• /build/config/bblayers.conf

Although ChirpStack Network Server and ChirpStack Application Server try to minimize the number of database writes, there will be regular writes to the SD Card (PostgreSQL and Redis snapshots). According to Is it true that a SD/MMC Card does wear levelling with its own controller? it might make a difference which SD Card brand you use.

The major version (major.minor.patch) of this project represents the major version of the provided ChirpStack Network Server stack.