IWL MQTT Test Suite

MQTT is a lightweight, low-power/bandwidth, publish/subscribe messaging protocol ideal for sensors, mobile devices, and the Internet of Things (IoT).

The IWL MQTT Test Suite provides MQTT implementers with a robust solution for testing apps and devices with a high quality, commercial test suite.

  • Find MQTT compliance and robustness problems
  • Automatically identify bugs and anomalies in your MQTT broker.
  • Fix your MQTT broker implementation.
  • Deploy your MQTT broker with confidence!

Find Bugs in Your MQTT Broker

Supports all versions of MQTT

The IWL MQTT Test Suite tests MQTT broker (server) implementations using both:

  • MQTT protocol version 3.1.1
  • MQTT protocol version 5

Web and Command Line Interface

Select your user interface:

  • A graphical user interface (via a web browser)
  • Python scripting via the command line interface
  • Shell commands via the command line interface

324 Unique Test Cases

The MQTT broker (server) test cases exercise one or a small number of parameters.

Each test references the “source of authority” for the test.

Test coverage includes tests for protocol compliance, error and exception handling, and boundary condition behavior and functionality.

Test categories:

  • Basic Operations
  • Conformance
  • Robustness

Architecture: Robot Framework

  • A test automation framework for acceptance testing and acceptance test-driven development
  • Permits easy integration of the IWL MQTT Test Suite with other test harnesses and test tools.

Find Bugs in Your MQTT Broker

Test Results

Validate an MQTT Broker

MQTT Setup

  • Use TLS/SSL authentication
  • Select logging options: Info or Debugging
  • Save and reload configuration files


  • Online Help (user manual)
  • Comprehensive List of Tests


  • Full support of the Python language.
  • Tests can be run using Python scripting or as a stand-alone command line program.
  • Easy integration into your test environment.

Test Output

  • Standard Result Codes: Passed, Failed, Warning.
  • XML result file (can be easily parsed using Robotframework Python API)
  • HTML result file and log for display in a Web browser.

Platform Support

The IWL MQTT Test Suite runs in a Docker environment.

The IWL MQTT Test Suite has been installed and tested on the following operating systems platforms with Docker installed:

  • macOS X (10.13 High Sierra and later)
  • Windows 10
  • Linux:
    • A 64-bit installation
    • Version 3.10 or higher of the Linux kernel.
      The latest version of the kernel available for your platform is recommended.

Technical Support and Licensing