Docker Compose (part of Docker) makes
it possible to orchestrate the configuration of multiple Docker containers
at once using a
Please refer to the Get Started with Docker guide to install Docker for MacOS or Windows. When installing Docker on Linux, please refer to one of the following guides:
To install Docker Compose on Linux, please refer to the Install Compose on Linux systems guide. You can skip this step for MacOS and Windows.
ChirpStack provides an example
docker-compose.yml file that
you can use as a starting-point. This example can be found at
and also contains more documentation.
To clone this repository, you need to execute the following commands:
git clone https://github.com/brocaar/chirpstack-docker.git cd chirpstack-docker
After you have updated the configuration, you can run the following command to start all Docker containers:
Please note that the first time you execute this command, there might be some errors logged as the database needs to be initialized.
As each container has its own hostname, you must use the hostname of the
networkserver container when adding the network-server in the ChirpStack Application Server
When using the above example, it means that you must enter
as the network-server hostname:IP. See Network Servers
for more information.