Outdated documentation
You are reading outdated documentation. This page documents ChirpStack v3. ChirpStack v4 is the latest version.
Source
Source-code can be found at https://github.com/brocaar/chirpstack-geolocation-server.
Building
With Docker
The easiest way to get started is by using the provided Docker Compose environment. To start a bash shell within the docker-compose environment, execute the following command from the root of this project:
docker-compose run --rm chirpstack-geolocation-server bash
Without Docker
It is possible to build ChirpStack Geolocation Server without Docker. However this requires to install a couple of dependencies (depending your platform, there might be pre-compiled packages available):
Go
Make sure you have Go installed (1.11+). As ChirpStack Geolocation Server uses Go modules, the repository must be cloned outside the $GOPATH
.
Go protocol buffer support
Install the C++ implementation of protocol buffers and Go support by following the GO support for Protocol Buffers installation instructions.
Example commands
A few example commands that you can run:
# install development requirements
make dev-requirements
# run the tests
make test
# compile
make build
# compile snapshot builds for supported architectures
make snapshot