Skip to content

Environment Variables

Daemon Configuration

VariableDescriptionDefault
RUST_LOGLog level filterclauderon=info
CLAUDERON_BIND_ADDRHTTP bind address127.0.0.1
CLAUDERON_DEVDevelopment mode0
CLAUDERON_ORIGINWebAuthn origin URLAuto-detected

Feature Flags

Set to 1, true, yes, or on to enable:

VariableDescription
CLAUDERON_FEATURE_ENABLE_WEBAUTHN_AUTHPasswordless authentication
CLAUDERON_FEATURE_ENABLE_AI_METADATAAI-generated session titles
CLAUDERON_FEATURE_ENABLE_AUTO_RECONCILEAuto-reconcile on startup
CLAUDERON_FEATURE_ENABLE_USAGE_TRACKINGClaude usage tracking
CLAUDERON_FEATURE_ENABLE_EXPERIMENTAL_MODELSCodex, Gemini models

Session Environment (set inside containers)

Session Metadata

VariableValue
CLAUDERON_SESSION_IDSession UUID
CLAUDERON_SESSION_NAMESession name
CLAUDERON_BACKENDBackend type
CLAUDERON_AGENTAgent type

Debugging

Terminal window
RUST_LOG=clauderon=debug clauderon daemon # verbose
RUST_LOG=clauderon=trace clauderon daemon # trace
RUST_LOG=clauderon::session=trace clauderon daemon # per-module

Shell Configuration

Bash/Zsh (~/.bashrc or ~/.zshrc):

Terminal window
export GH_TOKEN="ghp_xxxx"
export CLAUDERON_FEATURE_ENABLE_AI_METADATA=1

Fish (~/.config/fish/config.fish):

set -gx GH_TOKEN "ghp_xxxx"
set -gx CLAUDERON_FEATURE_ENABLE_AI_METADATA 1

systemd (/etc/systemd/system/clauderon.service):

[Unit]
Description=clauderon daemon
After=network.target
[Service]
Type=simple
User=youruser
Environment="RUST_LOG=clauderon=info"
Environment="CLAUDERON_FEATURE_ENABLE_AI_METADATA=1"
ExecStart=/usr/local/bin/clauderon daemon
Restart=on-failure
[Install]
WantedBy=multi-user.target