diff --git a/README.md b/README.md
new file mode 100644
index 0000000..efb0e86
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+# hassio-addons
+Docker addons for HassIO
+
+## Addon folder
+
+```
+addon_name:
+  Dockerfile
+  config.json
+```
+
+Use `FROM %%BASE_IMAGE%%` inside your docker file. We use alpine linux 3.5 for addons.
+
+## Addon config
+
+```json
+{
+  'name': 'xy',
+  'image': 'xy',
+  'verson': '1.2',
+  'description': 'long descripton',
+  'startup': 'before|after',
+  'ports': [123, ],
+  'map_config': bool,
+  'map_ssl': bool,
+}
+```