Skip to content

Outdated documentation

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

Debian / Ubuntu installation

These steps have been tested on:

  • Ubuntu 18.04 LTS
  • Debian 10 (Buster)

ChirpStack Debian repository

ChirpStack provides pre-compiled binaries packaged as Debian (.deb) packages. In order to activate this repository, execute the following commands:

sudo apt-key adv --keyserver --recv-keys 1CE2AFD36DBCCA00

sudo echo "deb stable main" | sudo tee /etc/apt/sources.list.d/chirpstack.list
sudo apt-get update

Install ChirpStack Geolocation Server

In order to install ChirpStack Geolocation Server, execute the following command:

sudo apt-get install chirpstack-geolocation-server

After installation, modify the configuration file which is located at /etc/chirpstack-geolocation-server/chirpstack-geolocation-server.toml.

Settings you probably want to set / change:

  • geo_server.backend.collos.subscription_key

Starting ChirpStack Geolocation Server

How you need to (re)start and stop ChirpStack Geolocation Server depends on if your distribution uses init.d or systemd.


sudo /etc/init.d/chirpstack-geolocation-server [start|stop|restart|status]


sudo systemctl [start|stop|restart|status] chirpstack-geolocation-server

ChirpStack Geolocation Server log output

Now you've setup ChirpStack Geolocation Server, it is a good time to verify that it is actually up-and-running. This can be done by looking at the ChirpStack Geolocation Server log output.

Like the previous step, which command you need to use for viewing the log output depends on if your distribution uses init.d or systemd.


All logs are written to /var/log/chirpstack-geolocation-server/chirpstack-geolocation-server.log. To view and follow this logfile:

tail -f /var/log/chirpstack-geolocation-server/chirpstack-geolocation-server.log


journalctl -u chirpstack-geolocation-server -f -n 50