diff --git a/docs/DOCS.md b/docs/DOCS.md
index a0ede423..9bcdf53a 100644
--- a/docs/DOCS.md
+++ b/docs/DOCS.md
@@ -1470,25 +1470,10 @@ Non-Nix users can look at the `devShell` attribute in the
 
 ## Running the appview
 
-The Nix flake also exposes a few `app` attributes (run `nix
-flake show` to see a full list of what the flake provides),
-one of the apps runs the appview with the `air`
-live-reloader:
+The appview requires Redis and OAuth JWKs. Start these
+first, before launching the appview itself.
 
 ```bash
-TANGLED_DEV=true nix run .#watch-appview
-
-# TANGLED_DB_PATH might be of interest to point to
-# different sqlite DBs
-
-# in a separate shell, you can live-reload tailwind
-nix run .#watch-tailwind
-```
-
-To authenticate with the appview, you will need Redis and
-OAuth JWKs to be set up:
-
-```
 # OAuth JWKs should already be set up by the Nix devshell:
 echo $TANGLED_OAUTH_CLIENT_SECRET
 z42ty4RT1ovnTopY8B8ekz9NuziF2CuMkZ7rbRFpAR9jBqMc
@@ -1511,6 +1496,21 @@ export TANGLED_OAUTH_CLIENT_SECRET="z42tuP..."
 redis-server
 ```
 
+The Nix flake exposes a few `app` attributes (run `nix
+flake show` to see a full list of what the flake provides),
+one of the apps runs the appview with the `air`
+live-reloader:
+
+```bash
+TANGLED_DEV=true nix run .#watch-appview
+
+# TANGLED_DB_PATH might be of interest to point to
+# different sqlite DBs
+
+# in a separate shell, you can live-reload tailwind
+nix run .#watch-tailwind
+```
+
 ## Running knots and spindles
 
 An end-to-end knot setup requires setting up a machine with