LibrePortal
Sponsor
Install

Mosquitto

MQTT Broker

Smart HomeWorks with 5 apps

Passes messages between your smart home devices and apps like Home Assistant and Zigbee2MQTT, all on your own server

On this page
  1. At a glance
  2. Addresses and ports
  3. Settings
  4. In its config file
  5. Tools
  6. Works with
  7. Privacy and security
  8. What leaves this server
  9. What LibrePortal turns off
  10. Sources
  11. Under the hood

At a glance#

What it is
MQTT Broker Smart Home
Where it opens
No web page It works in the background
Updates
Automatic A backup is taken first, and it rolls back if the update fails
Backups
Included Part of the daily backup when that's switched on
Copies
One per server

There's no step-by-step guide for Mosquitto here yet. Everything below comes straight from the app catalogue, so it's what LibrePortal really does when you install it. For using Mosquitto itself, its own documentation is the place to go: github.com/eclipse-mosquitto/mosquitto.

Addresses and ports#

Mosquitto has one port. LibrePortal picks a free port number for each when you install, so yours will differ from anyone else's. The Config tab's Network section shows them, and the app's Open button uses the right one.

What it isWho can reach itWith a domain
MQTT TCP local Port only

Settings#

In its config file#

Mosquitto's own settings aren't on the Config tab yet. They live in the app's config file, described here so you know they exist. How to change them.

SettingWhat it doesStarts as
Name
CFG_MOSQUITTO_DISPLAY_NAME		 What this app is called on your dashboards. Leave empty to use its usual name Empty
Show on the LibrePortal Dashboard
CFG_MOSQUITTO_SHOW_ON_DASHBOARD		 Whether this app gets a shortcut on the front page of the LibrePortal WebUI, separate from any Dashy dashboard
Choices: true, false		 false

Tools#

Mosquitto's Tools tab has 1 button for jobs you'd otherwise need a terminal for. Each one runs as a task, so you can watch it on the Tasks page and read what it did. More about Tools.

Let Devices Use MQTTTested on 2.1.2

Lets devices on your network, like Shelly or Tasmota plugs, sign in as the user devices. Its password is with the app's logins.

Asks for: Who can use MQTT (optional)

Works with#

These are the other apps Mosquitto knows how to work with. Once it's installed, its page shows the same list with whether each one is connected. How this works.

  • Grafana: Shows dashboards for the apps that have one. works with every app
  • Home Assistant: Talks to your devices through Mosquitto.
  • Prometheus: Collects metrics from the apps that can export them. works with every app
  • Uptime Kuma: Watches your apps and shows when one goes down. works with every app
  • Zigbee2MQTT: Sends your Zigbee devices' messages through Mosquitto.

Privacy and security#

All clear Mosquitto is a quiet message broker that only talks to the devices you connect. It requires a username and password.

What leaves this server#

Nothing leaves this server on its own.

What LibrePortal turns off#

Nothing needed switching off.

Licence: EPL-2.0 / EDL-1.0. Audited: 21 October 2026. See the privacy of every app and the Promise.

Sources#

Under the hood#

  • It runs this image: eclipse-mosquitto:2.1.2-alpine@sha256:860aeb5d63ce509508f6dcfb2bc8a1c1dd2bc60555b562b45ce90e52d8dabb0f.
  • It can sit behind Authelia's sign-in once Authelia is installed.
  • Its own project and documentation: github.com/eclipse-mosquitto/mosquitto

Ports, settings, tools and connections on this page are read from LibrePortal v0.10.97's app catalogue each time the guide is built.

Next steps

Every appAll the apps in the App Center, with search and categories.App settingsEvery app page has the same tabs for settings, tools and backups.Tools and add-onsButtons for each app's everyday jobs, like adding users.