How to Install Mosquitto Broker on Raspberry Pi

Introduction

The Mosquitto MQTT Broker is a lightweight and powerful messaging protocol designed for IoT (Internet of Things) devices. It efficiently handles messaging between connected devices, making it an ideal choice for Raspberry Pi projects.

In this guide, you’ll learn how to install the Mosquitto MQTT Broker on your Raspberry Pi, configure it for secure connections, and test it with simple commands.

Prerequisites

Before starting, ensure you have the following:

• Raspberry Pi (any model)
• Raspberry Pi OS (formerly Raspbian) installed and updated
• Internet Connection
• SSH Access (optional but recommended)

Step 1: Update Your Raspberry Pi

First, ensure your Raspberry Pi system is updated with the latest packages:

sudo apt update
sudo apt upgrade -y

Updating your system ensures compatibility with the latest Mosquitto version.

Step 2: Install Mosquitto Broker

Install the Mosquitto broker and its client utilities by running the following command:

sudo apt install mosquitto mosquitto-clients -y

Once the installation is complete, Mosquitto will automatically start as a background service.

Step 3: Enable Mosquitto Service

Ensure Mosquitto starts automatically on boot by enabling the service:

sudo systemctl enable mosquitto

To verify the service is running, use:

sudo systemctl status mosquitto

If Mosquitto is active, you’ll see an “active (running)” status.

Step 4: Basic Mosquitto Configuration

By default, Mosquitto does not require authentication. For better security, follow these steps to create a password file and update the configuration:

Step 4.1: Create a Password File

sudo mosquitto_passwd -c /etc/mosquitto/passwd YOUR_USERNAME

Enter your desired password when prompted.

Step 4.2: Edit the Mosquitto Configuration File

Open the configuration file with nano:

sudo nano /etc/mosquitto/mosquitto.conf

Add the following lines at the end of the file:

allow_anonymous false
password_file /etc/mosquitto/passwd
listener 1883

Save the file by pressing CTRL + X, then Y, and Enter.

Step 4.3: Restart the Mosquitto Service

Restart Mosquitto to apply the changes:

sudo systemctl restart mosquitto

Step 5: Testing Mosquitto Broker

To test if Mosquitto is working correctly:

Step 5.1: Open Two Terminal Windows

In one terminal, run the following command to subscribe to a test topic:

mosquitto_sub -h localhost -t "test/topic" -u YOUR_USERNAME -P YOUR_PASSWORD

In another terminal, publish a test message to that topic:

mosquitto_pub -h localhost -t "test/topic" -m "Hello, MQTT!" -u YOUR_USERNAME -P YOUR_PASSWORD

You should see “Hello, MQTT!” appear in the subscriber window, confirming the setup is successful.

Step 6: Configuring Mosquitto for Remote Access

By default, Mosquitto only listens to localhost. To allow remote connections:

1. Edit the Mosquitto configuration file:

   sudo nano /etc/mosquitto/mosquitto.conf
   

2. Add this line to allow connections from any IP:

   listener 1883 0.0.0.0
   

3. Restart Mosquitto:

   sudo systemctl restart mosquitto
   

Make sure to adjust your firewall settings if you plan to connect remotely over the network.

Step 7: Useful Mosquitto Commands

• Start Mosquitto Service: sudo systemctl start mosquitto
• Stop Mosquitto Service: sudo systemctl stop mosquitto
• Restart Mosquitto Service: sudo systemctl restart mosquitto
• Check Mosquitto Logs: sudo journalctl -u mosquitto -f

Step 8: Applications of Mosquitto MQTT

Mosquitto is highly versatile and is used in various IoT applications:

• Smart Home Automation Systems
• Sensor Data Collection
• Real-Time Monitoring
• Home Security Systems

Conclusion

By following this guide, you have successfully installed and configured the Mosquitto MQTT Broker on your Raspberry Pi. This setup enables efficient communication between your IoT devices, ensuring secure and scalable messaging.

If you encounter any issues or want to explore advanced features, feel free to ask for further guidance!

---

Recommended:

• How To Create Secure MQTT Broker
• Mosquitto MQTT broker | Install Broker in AWS | Setting Up
• How To Use Raspberry pi in a truely  headless mode
• Raspberry Pi – Introduction | Overview | Setup and Management | Tutorials