diff --git a/README.adoc b/README.adoc
new file mode 100644
index 0000000..950d8aa
--- /dev/null
+++ b/README.adoc
@@ -0,0 +1,25 @@
+postfix_exporter
+================
+
+Collects continuesly events from postfix and dovecot via journald.
+Exports the collected event-counters and the currently count of queued messages.
+
+Usage
+-----
+
+For nix, `nix-shell` knows any dependencies.
+
+Any other:  You need `libffi` and some gems:
+
+	apt install libffi
+	bundle install
+
+Run puma for testing and use curl for first fetch.
+
+	puma
+
+	curl http://localhost:9296/metrics
+
+You should see the collected data.  On first run, this code be very empty.  Wait some minutes to have some emails.
+
+journald should not drop loglines!  TODO: /etc/systemd/journald.conf