diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9ec81b9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# lumbung-theme
+
+A Hugo theme for lumbung.space
+
+### Installation
+
+`cd /my/hugosite/themes`
+`git clone https://git.vvvvvvaria.org/rra/lumbung-theme`
+
+edit `/my/hugosite/config.toml`:
+
+```
+cat config.toml 
+baseURL = "http://localhost/"
+languageCode = "en-us"
+title = "lumbung.space"
+theme = 'lumbung-theme'
+```