Setup ChirpStack using Docker Compose

Go to file

harryhcs f73ca8f1ff local dev		2021-05-05 08:30:56 +02:00
configuration	local dev	2021-05-05 08:30:56 +02:00
test	local dev	2021-05-05 08:30:56 +02:00
.gitattributes	Add .gitattributes to use LF line-endings for *.sh files (#11 )	2019-02-19 18:15:22 +01:00
.gitignore	Add .gitattributes to use LF line-endings for *.sh files (#11 )	2019-02-19 18:15:22 +01:00
docker-compose-env.yml	Add dependencies for services in docker-compose.yml (#41 )	2021-03-18 09:22:30 +00:00
docker-compose.yml	local dev	2021-05-05 08:30:56 +02:00
LICENSE	Add LICENSE file.	2019-07-15 09:52:26 +02:00
README.md	Updates after ChirpStack rename.	2019-11-02 18:35:00 +01:00

README.md

ChirpStack Docker example

This repository contains a skeleton to setup the ChirpStack open-source LoRaWAN Network Server stack using Docker Compose.

Note: Please use this docker-compose.yml file as a starting point for testing but keep in mind that for production usage it might need modifications.

Directory layout

docker-compose.yml: the docker-compose file containing the services
docker-compose-env.yml: alternate docker-compose file using environment variables, can be run with the docker-compose -f flag
configuration/chirpstack*: directory containing the ChirpStack configuration files, see:
configuration/postgresql/initdb/: directory containing PostgreSQL initialization scripts

Configuration

The ChirpStack stack components components are pre-configured to work with the provided docker-compose.yml file and defaults to the EU868 LoRaWAN band. Please refer to the configuration/chirpstack-network-server/examples directory for more configuration examples.

Data persistence

PostgreSQL and Redis data is persisted in Docker volumes, see the docker-compose.yml volumes definition.

Requirements

Before using this docker-compose.yml file, make sure you have Docker installed.

Usage

To start the ChirpStack open-source LoRaWAN Network Server stack, simply run:

$ docker-compose up

Note: during the startup of services, it is normal to see the following errors:

ping database error, will retry in 2s: dial tcp 172.20.0.4:5432: connect: connection refused
ping database error, will retry in 2s: pq: the database system is starting up

After all the components have been initialized and started, you should be able to open http://localhost:8080/ in your browser.

Add Network Server

When adding the Network Server in the ChirpStack Application Server web-interface (see Network Servers), you must enter chirpstack-network-server:8000 as the Network Server hostname:IP.