Due to some maintenance issues, this service has been switched in read-only mode, you can find more information about the why

and how to migrate your plugin documentation in this blogpost

Skip to end of metadata
Go to start of metadata

Plugin Information

View MQTT Notification on the plugin site for more information.

A simple notifier that can publish build notifications to a topic on a MQTT broker.


MQTT is a machine-to-machine (M2M)/"Internet of Things" connectivity protocol. It was designed as an extremely lightweight publish/subscribe messaging transport. 

The following details are configurable per Jenkins job:

  • Broker hostname/port
  • Topic
  • Message

Both the topic and the message may also include certain dynamic variables. These include:

  • PROJECT_URL - The relative URL to the Jenkins project to which this job belongs (e.g. "job/my-build").
  • BUILD_RESULT - The result of the Job (e.g. SUCCESS, FAILURE, ABORTED, etc.)
  • BUILD_NUMBER - The build number
  • CULPRITS - Comma-separated list of build culprits

All other build variables and environment variables can also be used (JENKINS-41839).

The default topic when no value is specified is "jenkins/PROJECT_URL".

The default message when no value is specified is "BULD_RESULT".


1.7 (2017-06-27)

The MqttNotifier can now be used in a jenkins pipeline, too. (Thanks michaelknigge!)

1.6 (2017-03-15)

Fixed credentials problem introduced while refactoring for unit testing in previous release (JENKINS-42764)

1.5 (2017-03-06)

  • Fixed problem with variable substitution (JENKINS-41974)
  • Started using StrSubstitutor for variable substitution
  • Added a unit test, but it's not doing much yet. Need to improve this.

1.4.2 (2017-02-12)

  • Reverted language level to Java 7 following failed integration test

1.4.1 (2017-02-12)

  • Bumped pom parent version, triggered a few findbugs violations. Now fixed.

1.4 (2017-02-12)

  • MQTT Notification plugin should be able to publish build number, build parameters (JENKINS-41839)

1.3 (2016-01-09)

1.2.1 (2016-01-06)

  • No changes. Republished 1.2 as the release didn't quite make it public for some reason.

1.2 (2015-06-23)

1.1 (2013-08-15)

  • Modified DefaultFilePersistence to use java.io.tmpdir

1.0 (2013-08-12)

  • Initial release