diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9d962e3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+# Federated Wiki
+
+Share pages circulating within a creative commons
+
+<!-- metadata -->
+* **Category**: Apps
+* **Status**: ❹💣
+* **Image**: [`dobbs/farm`](https://hub.docker.com/r/dobbs/farm/), ❶💚, upstream 
+* **Healthcheck**: No
+* **Backups**: No
+* **Email**: No
+* **Tests**: No
+* **SSO**: No
+<!-- endmetadata -->
+
+## Basic usage
+
+1. Set up Docker Swarm and [`abra`]
+2. Deploy [`coop-cloud/traefik`]
+3. `abra app new federatedwiki`
+4. `abra app YOURAPPDOMAIN config` - be sure to change `DOMAIN` to something that resolves to
+   your Docker swarm box
+5. `abra app YOURAPPDOMAIN deploy`
+
+[`abra`]: https://git.autonomic.zone/autonomic-cooperative/abra
+[`coop-cloud/traefik`]: https://git.autonomic.zone/coop-cloud/traefik