Skip to content
This repository was archived by the owner on Mar 16, 2026. It is now read-only.

Add note on mosquitto Docker startup failure#267

Open
knowack1 wants to merge 1 commit intoEVerest:mainfrom
knowack1:266-add-troubleshooting-guide-for-mosquitto-docker-container-startup-failures
Open

Add note on mosquitto Docker startup failure#267
knowack1 wants to merge 1 commit intoEVerest:mainfrom
knowack1:266-add-troubleshooting-guide-for-mosquitto-docker-container-startup-failures

Conversation

@knowack1
Copy link
Copy Markdown

@knowack1 knowack1 commented Sep 22, 2025

This change adds a note about a possible root cause of mosquitto container startup failures.
The new note points to a guide on how to fix this problem: https://ichbinblau.github.io/2019/09/06/Setup-nofile-for-Docker. This note can save time for future readers facing the same issue.

The problem was observed on Fedora 42 and Docker 28.3.3. The root cause was lack of file descriptor limit, which led to the following mosquitto error:

docker run --name mqtt-server --network infranet_network -p 1883:1883 -p 9001:9001 ghcr.io/everest/everest-dev-environment/mosquitto:docker-images-v0.1.0
1758397856: mosquitto version 2.0.10 starting
1758397856: mosquitto version 2.0.10 starting
1758397856: Config loaded from /mosquitto/config/mosquitto.conf.
1758397856: Config loaded from /mosquitto/config/mosquitto.conf.
1758397856: Opening ipv4 listen socket on port 1883.
1758397856: Opening ipv4 listen socket on port 1883.
1758397856: Opening ipv6 listen socket on port 1883.
1758397856: Opening ipv6 listen socket on port 1883.
1758397856: Opening websockets listen socket on port 9001.
1758397856: Opening websockets listen socket on port 9001.
1758397856: libuv support not compiled in
1758397856: libuv support not compiled in
1758397856: OOM allocating 1073741816 fds
1758397856: OOM allocating 1073741816 fds
1758397856: ZERO RANDOM FD
1758397856: ZERO RANDOM FD
1758397856: Error: Unable to create websockets listener on port 9001.
1758397856: Error: Unable to create websockets listener on port 9001.

Closes #266

@knowack1 knowack1 changed the title Add note on mosquitto Docker startup failure (#266) Add note on mosquitto Docker startup failure Sep 22, 2025
The issue was observed on Fedora 42 with Docker version 28.3.3.
This note can save time for users who face the same issue.

Signed-off-by: Karol Nowacki <karol.nowacki@unifiederrorcodes.org>
@knowack1 knowack1 force-pushed the 266-add-troubleshooting-guide-for-mosquitto-docker-container-startup-failures branch from ccb43df to 7b239ca Compare September 22, 2025 05:46
Copy link
Copy Markdown
Member

@andistorm andistorm left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@knowack1, thanks for your contribution!

Could you add please the exact procedure to reproduce this error in your PR description?

What would be the exact way of reproducing this error?
Running on fedora 42 / docker 28.3.3 the following command?

docker run --name mqtt-server --network infranet_network -p 1883:1883 -p 9001:9001 ghcr.io/everest/everest-dev-environment/mosquitto:docker-images-v0.1.0

@andistorm
Copy link
Copy Markdown
Member

@knowack1, thanks for your contribution!

Could you add please the exact procedure to reproduce this error in your PR description?

What would be the exact way of reproducing this error? Running on fedora 42 / docker 28.3.3 the following command?

docker run --name mqtt-server --network infranet_network -p 1883:1883 -p 9001:9001 ghcr.io/everest/everest-dev-environment/mosquitto:docker-images-v0.1.0

nevermind, just saw the corresponding issue, will move the discussion to the issue

@knowack1
Copy link
Copy Markdown
Author

Hi @andistorm, I see that you've requested changes, but I can't find any specific comments that I need to address. Is there anything I should change in this PR?

@knowack1
Copy link
Copy Markdown
Author

@andistorm could we please proceed with the PR?

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add troubleshooting guide for mosquitto Docker container startup failures

2 participants