diff --git a/roles/mosquitto/README.md b/roles/mosquitto/README.md
new file mode 100644
index 0000000..9b4b136
--- /dev/null
+++ b/roles/mosquitto/README.md
@@ -0,0 +1,13 @@
+# mosquitto
+
+Install and configure [mosquitto](https://mosquitto.org/).
+
+## Role Variables
+
+* `mosquitto_become` - Default: true. Enable/disable the Ansible become
+  functionality.
+* `mosquitto_become_user` - Default: root. When using become functionality for
+  privilege escalation, this is the user with desired privileges you become.
+* `mosquitto_certfile` - Default: "". Server certificate.
+* `mosquitto_keyfile` - Default: "". Server key.
+* `mosquitto_cafile` - Default: "". CA certificate.