Environment Variables
Complete reference for Tokligence Gateway configuration via environment variables.
Configuration Priority
Configuration loads in three layers (highest priority last):
- Global defaults:
config/setting.ini - Environment overlays:
config/{dev,test,live}/gateway.ini - Environment variables:
TOKLIGENCE_*(highest priority)
API Keys
| Variable | Description | Example |
|---|---|---|
TOKLIGENCE_OPENAI_API_KEY | OpenAI API key | sk-proj-... |
TOKLIGENCE_ANTHROPIC_API_KEY | Anthropic API key | sk-ant-... |
TOKLIGENCE_GOOGLE_API_KEY | Google AI API key | AIza... |
TOKLIGENCE_LLM_API_KEY | Custom LLM API key | custom-key |
TOKLIGENCE_LLM_ENDPOINT | Custom LLM endpoint | http://localhost:8000/v1 |
Routing
| Variable | Description | Default |
|---|---|---|
TOKLIGENCE_ROUTES | Model-to-provider routing | claude*=>anthropic,gpt-*=>openai |
TOKLIGENCE_WORK_MODE | Operation mode | auto |
TOKLIGENCE_RESPONSES_DELEGATE | Responses API delegation | auto |
TOKLIGENCE_CHAT_TO_ANTHROPIC | Enable Chat→Anthropic translation | off |
Sidecar Translation
| Variable | Description | Default |
|---|---|---|
TOKLIGENCE_SIDECAR_MODEL_MAP | Claude→OpenAI model mapping | — |
TOKLIGENCE_SIDECAR_DEFAULT_OPENAI_MODEL | Default OpenAI model | gpt-4o |
TOKLIGENCE_OPENAI_COMPLETION_MAX_TOKENS | Max tokens for OpenAI | 16384 |
Network
| Variable | Description | Default |
|---|---|---|
TOKLIGENCE_HTTP_ADDRESS | HTTP bind address | :8081 |
TOKLIGENCE_MULTIPORT_MODE | Enable multi-port mode | false |
TOKLIGENCE_FACADE_PORT | Facade port | :8081 |
TOKLIGENCE_ADMIN_PORT | Admin port | :8079 |
TOKLIGENCE_OPENAI_PORT | OpenAI-only port | :8082 |
TOKLIGENCE_ANTHROPIC_PORT | Anthropic-only port | :8083 |
TOKLIGENCE_GEMINI_PORT | Gemini-only port | :8084 |
Storage
| Variable | Description | Default |
|---|---|---|
TOKLIGENCE_IDENTITY_PATH | User database path | ~/.tokligence/identity.db |
TOKLIGENCE_LEDGER_PATH | Usage ledger path | ~/.tokligence/ledger.db |
TOKLIGENCE_DATABASE_URL | PostgreSQL connection string | — |
Logging
| Variable | Description | Default |
|---|---|---|
TOKLIGENCE_LOG_LEVEL | Log level | info |
TOKLIGENCE_LOG_FILE_CLI | CLI log file | — |
TOKLIGENCE_LOG_FILE_DAEMON | Daemon log file | — |
Firewall
| Variable | Description | Default |
|---|---|---|
TOKLIGENCE_FIREWALL_ENABLED | Enable prompt firewall | false |
TOKLIGENCE_FIREWALL_MODE | Firewall mode | monitor |
TOKLIGENCE_FIREWALL_PRESIDIO_URL | Presidio sidecar URL | — |
Authentication
| Variable | Description | Default |
|---|---|---|
TOKLIGENCE_AUTH_DISABLED | Disable authentication (dev mode) | false |
Marketplace
| Variable | Description | Default |
|---|---|---|
TOKLIGENCE_MARKETPLACE_ENABLED | Enable token marketplace | false |
TOKLIGENCE_UPDATE_CHECK_ENABLED | Enable update checks | true |
Example: Development Configuration
# Development mode
export TOKLIGENCE_AUTH_DISABLED=true
export TOKLIGENCE_LOG_LEVEL=debug
export TOKLIGENCE_MARKETPLACE_ENABLED=false
# Provider keys
export TOKLIGENCE_OPENAI_API_KEY=sk-...
export TOKLIGENCE_ANTHROPIC_API_KEY=sk-ant-...
# Routing
export TOKLIGENCE_ROUTES="claude*=>anthropic,gpt-*=>openai"
export TOKLIGENCE_WORK_MODE=auto
Example: Production Configuration
# Production mode
export TOKLIGENCE_AUTH_DISABLED=false
export TOKLIGENCE_LOG_LEVEL=info
# Database
export TOKLIGENCE_DATABASE_URL=postgres://user:pass@host/db
# Firewall
export TOKLIGENCE_FIREWALL_ENABLED=true
export TOKLIGENCE_FIREWALL_MODE=redact
# Provider keys (use secrets management)
export TOKLIGENCE_OPENAI_API_KEY=${OPENAI_API_KEY}
export TOKLIGENCE_ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
INI File Configuration
For complex configurations, use INI files:
# config/gateway.ini
[gateway]
http_address = :8081
work_mode = auto
[openai]
api_key = ${TOKLIGENCE_OPENAI_API_KEY}
[anthropic]
api_key = ${TOKLIGENCE_ANTHROPIC_API_KEY}
[firewall]
enabled = true
mode = redact
[logging]
level = info