diff --git a/README.md b/README.md
index 10e8dfd..8cf4271 100644
--- a/README.md
+++ b/README.md
@@ -1,27 +1,27 @@
 # Mediawiki
 
-Mediawiki [1.32.1](https://www.mediawiki.org/wiki/Release_notes/1.32.1).
+Mediawiki [version 1.32.1][mediawiki-1.32]
 
-Requires Docker version 1.11.2 and up
+Requires Docker version 1.11.2 or above to run.
 
-Based on [`mediawiki-ve-bundle`](https://hub.docker.com/r/revianlabs/mediawiki-ve-bundle).
+Based on [`mediawiki-ve-bundle`][mediawiki-ve].
 
-1. Set up Docker Swarm
+1. Set up Docker Swarm and [`abra`][abra]
+2. Deploy [`compose-stacks/traefik`][compose-traefik]
 2. `cp .envrc.sample .envrc`
-3. Edit `.envrc`
+3. Edit `.envrc` - be sure to change `$DOMAIN` to something that resolves to
+   your Docker swarm box
 4. `direnv allow` (or `. .envrc`)
-5. `. .helpers.sh` (don't forget the dot!)
-6. `create-secrets` (note down the passwords!) FIXME: Current function doesn't
-   output passwords 😕
-7. `docker stack deploy -c compose.yml mediawiki`
-8. Go to the `$DOMAIN` you configured in #3
-9. Click "Install", then follow the prompts. Enter the `root` and user passwords
-   you generated in #6
-10. Download the `LocalSettings.php`, and copy it to the `mediawiki_mediawiki`
-    container, in `/var/www/html`, using e.g. 
-
-        docker container cp ./local/path/to/LocalSettings.php <containerid>:/var/www/html/
+5. `abra secret_generate db_password v1 && abra secret_generate db_root_password v2`
+6. `abra deploy`
+7. `abra service_run mediawiki /bin/bash` to open a shell
+8. `php /var/www/html/maintenance/createAndPromote.php YourUsername YourPassword`
 
 ## License
 
 MIT License
+
+[mediawiki-1.32]: https://www.mediawiki.org/wiki/Release_notes/1.32.1
+[abra]: https://git.autonomic.zone/autonomic-cooperative/abra
+[compose-traefik]: https://git.autonomic.zone/compose-stacks/traefik
+[mediawiki-ve]: https://hub.docker.com/r/revianlabs/mediawiki-ve-bundle