Configuration
Environment Variables
All config lives in .env.local at the project root. Both values are auto-generated on first launch:
ACCESS_KEY=<your-access-key> # Auth key for the dashboard
CREDENTIAL_SECRET=<auto-generated> # AES-256 encryption key for stored credentials
To reset your access key, delete the ACCESS_KEY line from .env.local and restart. A new key will be generated.
Data Directory
All persistent data is stored in data/ as JSON files:
| File | Contents |
|---|---|
sessions.json | Chat sessions and message history |
agents.json | Agent configurations |
credentials.json | Encrypted API keys |
tasks.json | Task board items |
schedules.json | Cron schedules |
secrets.json | Orchestrator service keys |
settings.json | App settings (user name, preferences) |
providers.json | Custom provider configs |
skills.json | Uploaded skills |
connectors.json | Chat platform connector configs |
Backup
Back up the entire data/ directory to preserve your configuration. The .env.local file contains your encryption key — without it, encrypted credentials cannot be decrypted.
Settings UI
Open Settings from the gear icon in the sidebar header:
- User Preferences — Global instructions injected into all agent system prompts
- Orchestrator Engine — Choose the LangGraph provider, model, and credentials for orchestration routing
Ports
The dev server defaults to port 3456. To change it, edit the dev script in package.json:
"dev": "next dev --hostname 0.0.0.0 -p 4000"