Skip to content

Outdated documentation

You are reading outdated documentation. This page documents ChirpStack v3. ChirpStack v4 is the latest version.

Source

The Yocto recipes can be found at: https://github.com/brocaar/chirpstack-gateway-os.

Building

The ChirpStack Gateway OS uses Docker and Docker Compose. Make sure you have these tools installed.

Initial setup

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

Building

Run the following command to setup the build environment:

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

# within the container

# update the submodules
make submodules

# 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

Configuration

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