tipi/app-store
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
app-store/apps/eclipse-mosquitto/metadata/description.md
Wraithers bb4405c05c
Eclipse Mosquitto updates (#3463) 
* Update config.json

* Update Cedalo image to version stated in their docs

Reference: https://docs.cedalo.com/management-center/installation/#solo-installation

* Rename caledo_mgm_center.png to cedalo_mgm_center.png

* Update description.md

Fix Typos and image link

* Update short description and Cedalo Management Center security

* Added Cedalo Management Center Password env variable

* Revert update

* Update apps/eclipse-mosquitto/metadata/description.md

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: JigSaw <JigSawFr@users.noreply.github.com>
2024-06-23 01:27:37 +02:00

3.9 KiB
Executable File
Raw Permalink Blame History

Eclipse Mosquitto MQTT Broker with UI

This app consists of two images providing an MQTT broker and a UI for managing access to the broker. The configuration is adapted from the GitHub repo: shantanoo-desai/mqtt-rbac-docker-init

Eclipse Mosquitto

Eclipse Mosquitto is an open source (EPL/EDL licensed) message broker that implements the MQTT protocol versions 5.0, 3.1.1 and 3.1. Mosquitto is lightweight and is suitable for use on all devices from low power single board computers to full servers.

Mosquitto is part of the Eclipse Foundation, and is an iot.eclipse.org project. The development is driven by Cedalo.

The broker is configured by default that it listens to the port 1883 for tcp connections. To also use websocket connection you can enable it by edit the /runtipi/app-date/eclipse-mosquitto/data/config/moscquitto.conf with the following content:

listener 9001
protocol websockets

Note WebSockets, while powerful, can introduce vulnerabilities if left unsecured. They should be secured using TLS/encryption. For more detailed information the mosquitto documentation.

Cedalo Management Center

Cedalo Management Center allows to easily manage, monitor and inspect instances of Eclipse Mosquitto. There are some pro features that can only be activated by getting a license from cedalo.

cedalo_mgm_center.png

By default the following features are provided:

  • A system dashboard to view key figures, showing broker traffic, license and client infos.
  • Table of clients, which have connected to the broker, for inspection purposes.
  • A topic tree, displaying those topics that have been addressed, while the MMC is running.
  • Management of broker security allowing to modify clients, group and roles.
  • A terminal to execute commands related to the dynamic security API
  • Management Center infos and settings

The access to the broker is handled by the dynamic-security plugin in the mosquitto broker. The configuration is stored in the file /runtipi/app-date/eclipse-mosquitto/data/config/dynamic-security.json. This file is generated during the first launch of the the mosquitto image.

Links

See the following links for more information on MQTT:

Mosquitto project information is available at the following locations:

There is also a public test server available at https://test.mosquitto.org/

More information about the management center is available at the following locations: