diff --git a/README b/README
new file mode 100644
index 0000000..2f16d8e
--- /dev/null
+++ b/README
@@ -0,0 +1,28 @@
+SecretShop: a small Gemini server.
+
+# Features
+- Multi-site hosting (WIP)
+- CGI (WIP)
+- Fully compliant with Jetforce diagnostics
+- Probably won't kill your computer
+
+# Configuration
+SecretShop looks in it's current running directory and /etc/secretshop for it's config file.
+Configuration is in config/yaml in one of the above directories. See the sample config for more details
+but a standard file looks like such:
+
+---
+active_capsules:
+        - localhost
+localhost:
+        Hostname: "localhost"
+        Port: "1965"
+        RootDir: "/var/gemini"
+        CGIDir: "/var/gemini/cgi"
+        KeyFile: "localhost.key"
+        CertFile: "localhost.crt"
+
+
+
+# Running
+Either run the executable directly or use the SystemD unit file