Skip to content
This repository was archived by the owner on Mar 16, 2026. It is now read-only.
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions docs/general/03_quick_start_guide.rst
Original file line number Diff line number Diff line change
Expand Up @@ -211,6 +211,24 @@ other containers in the network.

``ghcr.io/everest/everest-dev-environment/mosquitto:docker-images-v0.1.0`` is the complete image name

.. note::

If the Mosquitto Docker container fails to start with an error similar to:

.. code-block:: bash

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
mosquitto version 2.0.10 starting
Config loaded from /mosquitto/config/mosquitto.conf.
Opening ipv4 listen socket on port 1883.
Opening ipv6 listen socket on port 1883.
Opening websockets listen socket on port 9001.
Error: Unable to create websockets listener on port 9001.

The root cause might be the lack of file descriptor limit in your Docker configuration.
To resolve this, you may need to set the ``nofile`` limit for Docker.
For instructions, see `this guide <https://ichbinblau.github.io/2019/09/06/Setup-nofile-for-Docker/>`_.

.. note::

The docker container can be controlled with docker compose as well:
Expand Down