hyperdxio / hyperdxio/hyperdx

docker-compose.dev.yml hangs on startup, leaves Docker engine unresponsive; containers cannot be removed

Open
#1,413 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
9.9k
Forks
471
Avg merge
2d 4h
Merged PRs (30d)
117

Description

Description:

I can successfully run the all-in-one HyperDX image with:

docker run -p 8080:8080 -p 4317:4317 -p 4318:4318 docker.hyperdx.io/hyperdx/hyperdx-all-in-one

It works perfectly on Ubuntu 25.04 with Docker 29.0.3 (build 511dad6).
However, when using the dev compose setup:

git clone https://github.com/hyperdxio/hyperdx.git
cd hyperdx
docker-compose -f docker-compose.dev.yml up

The following happens:

  1. hdx-oss-dev-ch-server-1 (ClickHouse) starts successfully.
  2. The other containers (db-1, otel-collector-1, otel-collector-json-1) appear to start (Docker shows "Created"), but never become healthy.
  3. The process hangs indefinitely, and eventually Docker itself becomes unresponsive—commands like docker ps, docker stop, or docker-compose down hang or fail.
  4. After this, the only recovery is to restart the Docker engine.
  5. Even after restart, the stuck containers cannot be removed normally—they persist in a limbo state until a full systemctl restart docker and manual cleanup.

The only log output before failure is:

ch-server-1  | /entrypoint.sh: create new user 'default' instead 'default'
ch-server-1  | Processing configuration file '/etc/clickhouse-server/config.xml'.
ch-server-1  | Merging configuration file '/etc/clickhouse-server/config.d/docker_related_config.xml'.
dependency failed to start: container hdx-oss-dev-ch-server-1 is unhealthy

System Info:

OS: Ubuntu 25.04
Docker: 29.0.3, build 511dad6
CPU: 4 cores
RAM: 15.62 GiB
Compose file: docker-compose.dev.yml from main branch

Expected behavior:
All services start cleanly, or at least fail gracefully without destabilizing Docker.

Actual behavior:
Docker engine hangs or crashes; containers become undeletable; full Docker reset required.

Impact:
This makes local development using docker-compose.dev.yml currently unusable for me, despite the all-in-one image working fine.

Request:
Investigate possible race conditions or init loops in MongoDB or OTel collector containers

Happy to provide full logs if helpful!

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the reported command with docker-compose.dev.yml on the stated Ubuntu and Docker versions. Inspect service health and logs, especially ch-server-1 and the db and OTel containers, before testing cleanup commands. Done means the development services start normally or fail without hanging Docker or leaving undeletable containers.

Written by the indexing model from the issue text.

Assessment

Tech stack
clickhouse, docker, docker-compose, mongodb
Domain
devops, infrastructure
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.