diff --git a/README.md b/README.md
index d0b3257..b6cbead 100644
--- a/README.md
+++ b/README.md
@@ -1,26 +1,33 @@
-Nextcloud
----
+# Nextcloud
 
 [![Build Status](https://drone.autonomic.zone/api/badges/compose-stacks/nextcloud/status.svg)](https://drone.autonomic.zone/compose-stacks/nextcloud)
 
 Fully automated luxury Nextcloud via docker-swarm. 
 
-Based on the official [`nextcloud` image][nextcloud-docker].
+<!-- metadata -->
+* **Category**: Apps
+* **Status**: ❷💛
+* **Image**: [`nextcloud`](https://hub.docker.com/_/nextcloud), ❶💚, upstream
+* **Healthcheck**: Yes
+* **Backups**: No
+* **Email**: ❶💚
+* **Tests**: ❷💛
+* **SSO**: ❸🍎 (OAuth)
+<!-- endmetadata -->
+
+## Basic usage
 
 1. Set up Docker Swarm and [`abra`]
 2. Deploy [`compose-stacks/traefik`]
-3. `cp .envrc.sample .envrc`
-4. Edit `.envrc` - be sure to change `$DOMAIN` to something that resolves to
+3. `abra app new nextcloud --secrets` (optionally with `--pass` if you'd like
+   to save secrets in `pass`)
+4. `abra app YOURAPPDOMAIN config` - be sure to change `$DOMAIN` to something that resolves to
    your Docker swarm box
-5. `direnv allow` (or `. .envrc`)
-6. Generate secrets:
-   ```
-   abra secret generate db_password v1
-   abra secret generate db_root_password v1
-   abra secret generate admin_password
-   ```
+5. `abra app YOURAPPDOMAIN deploy`
 
-7. `abra deploy`
+## Running `occ`
+
+`abra app YOURAPPDOMAIN occ user:list`
 
 [nextcloud-docker]: https://hub.docker.com/_/nextcloud/
 [`abra`]: https://git.autonomic.zone/autonomic-cooperative/abra