ChirpStack Docker Container Stops Unexpectedly and Web Interface is Inaccessible

raider11 · August 7, 2025, 9:43am

Hello,

I am facing an issue with the ChirpStack project while running it using Docker. I cloned the Git repository and followed the README instructions step-by-step. After making some modifications for a logo change, I started the containers using docker-compose up -d. The ChirpStack container starts initially but stops unexpectedly with an “exited” status after a short period. During the time it is running, I am unable to access the web interface and receive a connection error in the browser.

Here are the steps I followed:

Cloned the repository: git clone GitHub - chirpstack/chirpstack-docker: Setup ChirpStack using Docker Compose
Made the necessary configurations and logo changes.
Did not modify the docker-compose.yml file (using default settings).
Ran docker-compose up -d to start the containers.

When checking the container status, I notice that the ChirpStack container stops after a while. I couldn’t find any clear error messages in the logs, but I might be missing something due to my limited experience with debugging Docker issues.

Could you please provide insights into possible causes and solutions for this issue? How can I effectively inspect the logs or troubleshoot the web interface access problem? Any help would be greatly appreciated!

brocaar · August 7, 2025, 9:59am

Looking at the services (e.g. kafka, …) I think you are running the docker-compose.yml from the chirpstack repo and not the chirpstack-docker repo.You should use the latter.

raider11 · August 7, 2025, 10:35am

I uploaded the Docker Compose file. Could you please explain this in more detail? What do I need to change?

brocaar · August 7, 2025, 7:35pm

You are looking at the wrong docker-compose, please see:

github.com/chirpstack/chirpstack-docker

docker-compose.yml

master

services:
  chirpstack:
    image: chirpstack/chirpstack:4
    command: -c /etc/chirpstack
    restart: unless-stopped
    volumes:
      - ./configuration/chirpstack:/etc/chirpstack
    depends_on:
      - postgres
      - mosquitto
      - redis
    environment:
      - MQTT_BROKER_HOST=mosquitto
      - REDIS_HOST=redis
      - POSTGRESQL_HOST=postgres
    ports:
      - "8080:8080"

  chirpstack-gateway-bridge:
    image: chirpstack/chirpstack-gateway-bridge:4

This file has been truncated. show original

raider11 · August 8, 2025, 7:02am

Thank you very much for your answer and help.
I want to run the chirststack application that I recompiled. Because I changed the logo here and

I followed all the steps in this link.
After that, I don’t know how to run it and how to docker the chirtstack application that I recompiled. Can you help me with this?

brocaar · August 8, 2025, 10:36am

You need to build your own Docker container, and then update the image reference in the chirpstack-docker/docker-compose.yml file.