diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b873c62
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# mosquitto k8s manifest
+
+## Introduction
+
+This deploys a mosquitto (mqtt) server. This will primarily be used as a
+messaging queue for home-assistant.
+