art-dag/activity-pub
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Document L1_SERVERS configuration in README

Browse Source 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
gilesb
2026-01-09 17:22:54 +00:00
parent 28843ea185
commit accb315623
1 changed files with 21 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
README.md
View File

@@ -20,6 +20,7 @@ export ARTDAG_DOMAIN=artdag.rose-ash.com
export ARTDAG_USER=giles export ARTDAG_USER=giles
export ARTDAG_DATA=~/.artdag/l2 export ARTDAG_DATA=~/.artdag/l2
export DATABASE_URL=postgresql://artdag:artdag@localhost:5432/artdag export DATABASE_URL=postgresql://artdag:artdag@localhost:5432/artdag
export L1_SERVERS=https://celery-artdag.rose-ash.com
# Generate signing keys (required for federation) # Generate signing keys (required for federation)
python setup_keys.py 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. **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 ## Web UI
The server provides a web interface: The server provides a web interface:
@@ -106,6 +126,7 @@ The server provides a web interface:
| `/assets` | Browse registered assets | | `/assets` | Browse registered assets |
| `/activities` | View published activities | | `/activities` | View published activities |
| `/users` | List registered users | | `/users` | List registered users |
| `/renderers` | Manage L1 renderer connections |
| `/asset/{name}` | Asset detail page | | `/asset/{name}` | Asset detail page |
| `/login` | Login page | | `/login` | Login page |
| `/register` | Registration page | | `/register` | Registration page |