MQTT broker setup (Mosquitto) in Raspberry Pi - Mini Project: Build & Apply

MQTT Broker Setup with Mosquitto on Raspberry Pi

📖 Scenario: You want to set up a simple MQTT broker on your Raspberry Pi using Mosquitto. MQTT is a messaging protocol used for communication between devices in smart homes and IoT projects.This project will guide you step-by-step to install Mosquitto, configure it, and test the broker by publishing and subscribing to messages.

🎯 Goal: By the end, you will have a working MQTT broker on your Raspberry Pi that can send and receive messages using Mosquitto.

📋 What You'll Learn

Raspberry Pi with Raspberry Pi OS installed

Internet connection to download packages

Basic command line usage

💡 Why This Matters

🌍 Real World

MQTT brokers like Mosquitto are used in smart homes and IoT devices to send messages between sensors, switches, and controllers.

💼 Career

Understanding how to set up and use MQTT brokers is important for roles in IoT development, home automation, and networked device management.

1

Install Mosquitto MQTT Broker

Open the terminal on your Raspberry Pi and install Mosquitto by typing sudo apt update followed by sudo apt install -y mosquitto mosquitto-clients.

Raspberry Pi

# Run the commands to install Mosquitto
# Your code here

Hint

Use sudo apt update to refresh package lists, then install Mosquitto and its clients with sudo apt install -y mosquitto mosquitto-clients.

2

Enable and Start Mosquitto Service

Enable the Mosquitto service to start on boot by typing sudo systemctl enable mosquitto and then start the service immediately with sudo systemctl start mosquitto.

Raspberry Pi

sudo apt update
sudo apt install -y mosquitto mosquitto-clients
# Enable Mosquitto service to start on boot
# Your code here

Hint

Use sudo systemctl enable mosquitto to make Mosquitto start automatically, then sudo systemctl start mosquitto to start it now.

3

Test MQTT Broker by Subscribing to a Topic

Open a new terminal window and subscribe to the topic test/topic by typing mosquitto_sub -h localhost -t test/topic. This will listen for messages on that topic.

Raspberry Pi

sudo apt update
sudo apt install -y mosquitto mosquitto-clients
sudo systemctl enable mosquitto
sudo systemctl start mosquitto
# Subscribe to 'test/topic' to listen for messages
# Your code here

Hint

Use mosquitto_sub with -h localhost to connect to your local broker and -t test/topic to subscribe to that topic.

4

Publish a Message to the Topic

In another terminal window, publish the message Hello MQTT to the topic test/topic by typing mosquitto_pub -h localhost -t test/topic -m "Hello MQTT". You should see the message appear in the subscriber terminal.

Raspberry Pi

sudo apt update
sudo apt install -y mosquitto mosquitto-clients
sudo systemctl enable mosquitto
sudo systemctl start mosquitto
mosquitto_sub -h localhost -t test/topic
# Publish 'Hello MQTT' to 'test/topic'
# Your code here

Hint

Use mosquitto_pub with -h localhost, -t test/topic, and -m "Hello MQTT" to send the message.

Practice

1. What is the primary role of the Mosquitto MQTT broker on a Raspberry Pi?

easy

A. To receive and forward messages between devices

B. To act as a web server for hosting websites

C. To store large files for backup

D. To compile Python programs

Solution

1. Step 1: Understand MQTT broker function

   The MQTT broker acts as a middleman that receives messages from one device and forwards them to others subscribed to the same topic.

2. Step 2: Compare with other options

   The other options describe unrelated functions like web hosting, file storage, and compiling, which are not roles of Mosquitto.

3. Final Answer:

   To receive and forward messages between devices -> Option A

4. Quick Check:

   MQTT broker = message forwarding [OK]

Hint: Broker forwards messages between devices [OK]

Common Mistakes:

• Confusing broker with web server
• Thinking Mosquitto stores files
• Assuming it compiles code

2. Which command correctly installs Mosquitto on a Raspberry Pi running Raspberry Pi OS?

easy

A. install mosquitto sudo

B. sudo mosquitto install apt-get

C. mosquitto install sudo apt-get

D. sudo apt-get install mosquitto

Solution

1. Step 1: Recall correct package installation syntax

   On Raspberry Pi OS, the correct command to install a package is 'sudo apt-get install package-name'. Here, the package is mosquitto.

2. Step 2: Check each option's syntax

   Only sudo apt-get install mosquitto follows the correct syntax. The other options have incorrect word order or missing keywords.

3. Final Answer:

   sudo apt-get install mosquitto -> Option D

4. Quick Check:

   Install command = sudo apt-get install [OK]

Hint: Use 'sudo apt-get install mosquitto' exactly [OK]

Common Mistakes:

• Mixing command word order
• Omitting 'sudo' or 'install'
• Using incorrect package manager commands

3. After installing Mosquitto, you run the command mosquitto_sub -h localhost -t test/topic in one terminal and mosquitto_pub -h localhost -t test/topic -m "Hello" in another. What will appear in the subscriber terminal?

medium

A. Error: Connection refused

B. Hello

C. mosquitto_sub

D. test/topic

Solution

1. Step 1: Understand subscriber and publisher commands

   The subscriber listens on topic 'test/topic' on localhost. The publisher sends message 'Hello' to the same topic.

2. Step 2: Predict subscriber output

   The subscriber will receive and display the message 'Hello' published to 'test/topic'. No error occurs if Mosquitto is running.

3. Final Answer:

   Hello -> Option B

4. Quick Check:

   Subscriber shows published message [OK]

Hint: Subscriber shows message sent to its topic [OK]

Common Mistakes:

• Expecting topic name instead of message
• Confusing command names with output
• Assuming connection error without checking broker status

4. You try to start Mosquitto with sudo systemctl start mosquitto but get an error saying the service is not found. What is the likely cause?

medium

A. Mosquitto is not installed or service not enabled

B. You need to run the command without sudo

C. The Raspberry Pi is out of storage space

D. The MQTT topic name is incorrect

Solution

1. Step 1: Analyze the error message

   The error 'service not found' means the system does not recognize the mosquitto service, usually because it is not installed or the service is not enabled.

2. Step 2: Evaluate other options

   Running without sudo won't help as service commands require sudo. Storage space or topic name do not affect service recognition.

3. Final Answer:

   Mosquitto is not installed or service not enabled -> Option A

4. Quick Check:

   Service error = missing install or enable [OK]

Hint: Check if Mosquitto is installed and service enabled [OK]

Common Mistakes:

• Trying without sudo
• Blaming storage space
• Confusing service error with topic issues

5. You want to allow remote devices to connect to your Mosquitto broker on Raspberry Pi. Which configuration change is necessary?

hard

A. Install a web server alongside Mosquitto

B. Change the MQTT topic to a public name

C. Edit /etc/mosquitto/mosquitto.conf to allow connections on all interfaces

D. Disable the Raspberry Pi firewall completely

Solution

1. Step 1: Identify how Mosquitto listens for connections

   By default, Mosquitto listens only on localhost (127.0.0.1). To allow remote devices, you must configure it to listen on all network interfaces.

2. Step 2: Understand configuration changes

   This is done by editing /etc/mosquitto/mosquitto.conf to set 'bind_address' or comment it out to listen on all interfaces. Changing topic names or installing web servers does not affect network access. Disabling firewall completely is unsafe and unnecessary if configured properly.

3. Final Answer:

   Edit /etc/mosquitto/mosquitto.conf to allow connections on all interfaces -> Option C

4. Quick Check:

   Config file change = allow remote connections [OK]

Hint: Edit config to listen on all interfaces [OK]

Common Mistakes:

• Changing topic names instead of network settings
• Thinking web server is needed
• Disabling firewall without proper rules