diff --git a/README.rst b/README.rst
index 3ef8b52..0f2b794 100644
--- a/README.rst
+++ b/README.rst
@@ -16,6 +16,38 @@
       server:
         enabled: true
 
+Single MAAS region service [single UI/API]
+
+.. code-block:: yaml
+
+    maas:
+      region:
+        enabled: true
+        bind:
+          host: localhost
+          port: 80
+        database:
+          engine: postgresql
+          host: localhost
+          name: maasdb
+          password: password
+          username: maas
+
+
+Single MAAS cluster service [multiple racks]
+
+.. code-block:: yaml
+
+    maas:
+      cluster:
+        enabled: true
+        version: '2'
+        region: 
+          host: localhost
+          port: 5240
+
+
+
 Read more
 =========