From accb315623ab6f055560a26db247ee4a494c0171 Mon Sep 17 00:00:00 2001 From: gilesb Date: Fri, 9 Jan 2026 17:22:54 +0000 Subject: [PATCH] Document L1_SERVERS configuration in README Co-Authored-By: Claude Opus 4.5 --- README.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/README.md b/README.md index 255098c..17b290c 100644 --- a/README.md +++ b/README.md @@ -20,6 +20,7 @@ export ARTDAG_DOMAIN=artdag.rose-ash.com export ARTDAG_USER=giles export ARTDAG_DATA=~/.artdag/l2 export DATABASE_URL=postgresql://artdag:artdag@localhost:5432/artdag +export L1_SERVERS=https://celery-artdag.rose-ash.com # Generate signing keys (required for federation) python setup_keys.py @@ -96,6 +97,25 @@ Keys are stored in `$ARTDAG_DATA/keys/`: **Important**: Private keys are gitignored. Back them up securely. Losing them invalidates all your signatures. +## L1 Renderers Configuration + +The `L1_SERVERS` environment variable defines which L1 rendering servers are available to users. Users can attach to these servers from the Renderers page to run effects and manage media. + +```bash +# Single server (default) +export L1_SERVERS=https://celery-artdag.rose-ash.com + +# Multiple servers (comma-separated) +export L1_SERVERS=https://celery-artdag.rose-ash.com,https://renderer2.example.com,https://renderer3.example.com +``` + +When a user attaches to an L1 server: +1. They're redirected to the L1's `/auth` endpoint with their auth token +2. The L1 sets a local cookie, logging them in +3. Their attachment is recorded in the `user_renderers` table + +Users can manage attachments at `/renderers`. + ## Web UI The server provides a web interface: @@ -106,6 +126,7 @@ The server provides a web interface: | `/assets` | Browse registered assets | | `/activities` | View published activities | | `/users` | List registered users | +| `/renderers` | Manage L1 renderer connections | | `/asset/{name}` | Asset detail page | | `/login` | Login page | | `/register` | Registration page |