mirror of
https://github.com/rennf93/roboco.git
synced 2026-08-03 07:23:24 +02:00
Renn F
416356899d
config-reference.md (indexed into the KB agents trust at runtime) documented a non-existent ROBOCO_SECRET_KEY/JWT and token-expiry setting and omitted the real one. Replace the Security table with the actual env vars — ROBOCO_ENCRYPTION_KEY (Fernet), ROBOCO_AGENT_AUTH_SECRET, ROBOCO_AGENT_AUTH_REQUIRED, ROBOCO_PANEL_AGENT_TOKEN — and drop the phantom Logging/Sessions sections (no backing config fields).
73 lines
3.1 KiB
Markdown
73 lines
3.1 KiB
Markdown
# Configuration Reference
|
|
|
|
Environment variables for RoboCo (prefix: `ROBOCO_`).
|
|
|
|
## API Server
|
|
|
|
| Variable | Default | Description |
|
|
|----------|---------|-------------|
|
|
| `ROBOCO_HOST` | `127.0.0.1` | API host (0.0.0.0 for containers) |
|
|
| `ROBOCO_PORT` | `8000` | API port |
|
|
| `ROBOCO_DEBUG` | `false` | Debug mode |
|
|
| `ROBOCO_ENVIRONMENT` | `development` | development/staging/production |
|
|
|
|
## Database
|
|
|
|
| Variable | Default | Description |
|
|
|----------|---------|-------------|
|
|
| `ROBOCO_DATABASE_HOST` | `localhost` | PostgreSQL host |
|
|
| `ROBOCO_DATABASE_PORT` | `5432` | PostgreSQL port |
|
|
| `ROBOCO_DATABASE_USER` | `roboco` | Database user |
|
|
| `ROBOCO_DATABASE_PASSWORD` | `roboco` | Database password |
|
|
| `ROBOCO_DATABASE_NAME` | `roboco` | Database name |
|
|
|
|
## Redis
|
|
|
|
| Variable | Default | Description |
|
|
|----------|---------|-------------|
|
|
| `ROBOCO_REDIS_HOST` | `localhost` | Redis host |
|
|
| `ROBOCO_REDIS_PORT` | `6379` | Redis port |
|
|
| `ROBOCO_REDIS_DB` | `0` | Redis database |
|
|
|
|
## Workspaces
|
|
|
|
| Variable | Default | Description |
|
|
|----------|---------|-------------|
|
|
| `ROBOCO_WORKSPACES_ROOT` | `/data/workspaces` | Root for agent workspaces |
|
|
| `ROBOCO_WORKSPACE_AUTO_CLONE` | `true` | Auto-clone on first access |
|
|
| `ROBOCO_WORKSPACE_CLONE_TIMEOUT` | `300` | Clone timeout (seconds) |
|
|
|
|
## RAG/Embeddings
|
|
|
|
| Variable | Default | Description |
|
|
|----------|---------|-------------|
|
|
| `ROBOCO_DEFAULT_EMBEDDING_MODEL` | `qwen3-embedding:0.6b` | Embedding model |
|
|
| `ROBOCO_EMBEDDING_DIMENSIONS` | `1024` | Embedding dimensions |
|
|
| `ROBOCO_RAG_CHUNK_STRATEGY` | `fixed` | fixed/semantic/hierarchical/contextual |
|
|
| `ROBOCO_RAG_CHUNK_SIZE` | `512` | Base chunk size |
|
|
| `ROBOCO_RAG_CHUNK_SIZE_DOCS` | `1536` | Chunk size for docs |
|
|
| `ROBOCO_RAG_CHUNK_SIZE_JOURNALS` | `1024` | Chunk size for journals |
|
|
| `ROBOCO_RAG_CHUNK_OVERLAP` | `128` | Chunk overlap |
|
|
| `ROBOCO_RAG_USE_HYDE` | `true` | Use HyDE for queries |
|
|
| `ROBOCO_RAG_USE_HYBRID_SEARCH` | `true` | BM25 + vector search |
|
|
| `ROBOCO_RAG_USE_CROSS_ENCODER` | `true` | Neural reranking |
|
|
| `ROBOCO_RAG_AUTO_UPDATE_ENABLED` | `true` | Auto-update indexes |
|
|
| `ROBOCO_RAG_AUTO_UPDATE_INTERVAL` | `300` | Update interval (seconds) |
|
|
|
|
## LLM
|
|
|
|
| Variable | Default | Description |
|
|
|----------|---------|-------------|
|
|
| `ROBOCO_LOCAL_LLM_MODEL` | `glm-5:cloud` | Local LLM for RAG |
|
|
| `ROBOCO_LOCAL_LLM_BASE_URL` | `http://roboco-ollama:11434/v1` | OpenAI-compat API |
|
|
| `ROBOCO_OLLAMA_BASE_URL` | `http://roboco-ollama:11434` | Native Ollama API |
|
|
|
|
## Security
|
|
|
|
| Variable | Default | Description |
|
|
|----------|---------|-------------|
|
|
| `ROBOCO_ENCRYPTION_KEY` | (required) | Fernet key that encrypts secrets at rest (e.g. per-project git tokens). Generate with `Fernet.generate_key()`. |
|
|
| `ROBOCO_AGENT_AUTH_SECRET` | (required) | HMAC secret the orchestrator signs each agent's `X-Agent-Token` with. |
|
|
| `ROBOCO_AGENT_AUTH_REQUIRED` | `false` | When `true`, every request must carry a valid agent token (secure mode). |
|
|
| `ROBOCO_PANEL_AGENT_TOKEN` | (unset) | The control panel's CEO token, injected by nginx in secure mode. Get it with `make panel-token`. |
|