From 4eaf8ae7f758772e4523ad548468d1bbb43a5a3e Mon Sep 17 00:00:00 2001 From: Alessio Caiazza Date: Sat, 7 Mar 2026 09:42:08 +0100 Subject: [PATCH] docs: reorder appview setup to start Redis before watch-appview The appview crashes on startup if Redis is not running: appview: failed to start appview err="failed to start oauth handler: failed to connect to redis: dial tcp [::1]:6379: connect: connection refused" Reorder the "Running the appview" section so the Redis and OAuth JWKs prerequisites come before the watch-appview command, matching the actual dependency order. Signed-off-by: Alessio Caiazza --- docs/DOCS.md | 34 +++++++++++++++++----------------- 1 file changed, 17 insertions(+), 17 deletions(-) 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 -- 2.51.2