docs: prefer AGENT_CONTROL_DB_URL in configuration docs (#31)

* docs: prefer AGENT_CONTROL_DB_URL in config docs

* docs: remove db alias wording

* docs: simplify db config label

Author: lan17

components/server.mdx

@@ -55,10 +55,9 @@ agent-control-server
 Create a `.env` file in the `server/` directory:
 
 ```env
-# Database (use DATABASE_URL for Docker, DB_URL for local dev)
-DATABASE_URL=postgresql+psycopg://user:password@localhost/agent_control
-# DB_URL=postgresql+psycopg://user:password@localhost/agent_control
-# DB_URL=sqlite+aiosqlite:///./agent_control.db
+# Database
+AGENT_CONTROL_DB_URL=postgresql+psycopg://user:password@localhost/agent_control
+# AGENT_CONTROL_DB_URL=sqlite+aiosqlite:///./agent_control.db
 
 # Server settings
 HOST=0.0.0.0
@@ -269,7 +268,7 @@ make typecheck
 docker build -f server/Dockerfile -t agent-control-server .
 
 docker run -p 8000:8000 \
-  -e DATABASE_URL=postgresql+psycopg://user:password@host:5432/agent_control \
+  -e AGENT_CONTROL_DB_URL=postgresql+psycopg://user:password@host:5432/agent_control \
   -e AGENT_CONTROL_API_KEY_ENABLED=true \
   -e AGENT_CONTROL_API_KEYS=your-key-here \
   -e AGENT_CONTROL_ADMIN_API_KEYS=your-admin-key-here \

core/configuration.mdx

@@ -10,7 +10,8 @@ icon: "gear"
 |----------|---------|-------------|
 | `AGENT_CONTROL_URL` | `http://localhost:8000` | Server URL |
 | `AGENT_CONTROL_API_KEY` | — | API key for authentication |
-| `DB_URL` | `postgresql+psycopg://agent_control:agent_control@localhost:5432/agent_control` | Database connection string (SQLite: `sqlite+aiosqlite:///./agent_control.db`) |
+
+For server database configuration, use the `AGENT_CONTROL_DB_*` variables in the server section below.
 
 ---
 
@@ -38,14 +39,13 @@ icon: "gear"
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `DATABASE_URL` | — | Database URL for Docker deployments |
-| `DB_HOST` | `localhost` | PostgreSQL host |
-| `DB_PORT` | `5432` | PostgreSQL port |
-| `DB_USER` | `agent_control` | Database user |
-| `DB_PASSWORD` | `agent_control` | Database password |
-| `DB_DATABASE` | `agent_control` | Database name |
-| `DB_DRIVER` | `psycopg` | Database driver |
-| `DB_URL` | — | Database URL (legacy; overrides individual settings above) |
+| `AGENT_CONTROL_DB_URL` | — | Preferred database URL. Supports PostgreSQL and SQLite (for example `sqlite+aiosqlite:///./agent_control.db`). |
+| `AGENT_CONTROL_DB_HOST` | `localhost` | PostgreSQL host when `AGENT_CONTROL_DB_URL` is unset |
+| `AGENT_CONTROL_DB_PORT` | `5432` | PostgreSQL port when `AGENT_CONTROL_DB_URL` is unset |
+| `AGENT_CONTROL_DB_USER` | `agent_control` | Database user when `AGENT_CONTROL_DB_URL` is unset |
+| `AGENT_CONTROL_DB_PASSWORD` | `agent_control` | Database password when `AGENT_CONTROL_DB_URL` is unset |
+| `AGENT_CONTROL_DB_DATABASE` | `agent_control` | Database name when `AGENT_CONTROL_DB_URL` is unset |
+| `AGENT_CONTROL_DB_DRIVER` | `psycopg` | Database driver when `AGENT_CONTROL_DB_URL` is unset |
 
 ### Observability
 

core/quickstart.mdx

@@ -253,7 +253,7 @@ _Performance tested on Apple M5 (16 GB RAM), Docker Compose (`postgres:16` + `ag
 |----------|---------|-------------|
 | `AGENT_CONTROL_URL` | `http://localhost:8000` | Server URL for SDK |
 | `AGENT_CONTROL_API_KEY` | — | API key for authentication (if enabled) |
-| `DB_URL` | `postgresql+psycopg://agent_control:agent_control@localhost:5432/agent_control` | Database connection string (SQLite: `sqlite+aiosqlite:///./agent_control.db`) |
+| `AGENT_CONTROL_DB_URL` | `postgresql+psycopg://agent_control:agent_control@localhost:5432/agent_control` | Server database URL (SQLite: `sqlite+aiosqlite:///./agent_control.db`) |
 | `GALILEO_API_KEY` | — | Required for Luna-2 AI evaluator |
 
 ### Server Configuration