diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..37b52cc
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+/.envrc
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b6cfb82
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+# Matrix Synapse
+
+Matrix Synapse, based on official `martixdotorg/synapse` image.
+
+1. Set up Docker Swarm and [`abra`][abra]
+2. Deploy [`compose-stacks/traefik`][compose-traefik]
+2. `cp .envrc.sample .envrc`
+3. Edit `.envrc` - be sure to change `$DOMAIN` to something that resolves to
+   your Docker swarm box
+4. `direnv allow` (or `. .envrc`)
+8. `abra deploy`
+
+[abra]: https://git.autonomic.zone/autonomic-cooperative/abra
+[compose-traefik]: https://git.autonomic.zone/compose-stacks/traefik