Configuration

Primary configuration: .env

ARX runtime configuration is generated into a project-local .env file during install.

# Key runtime examples
BIND_HOST=0.0.0.0
BIND_PORT=18890
AGENT_TRIGGER=gemma
GEMMA_OLLAMA_MODEL=gemma4:e2b
GEMMA_CONTEXT_SIZE=4096
GEMMA_TEMPERATURE=0.2
PLAYIT_ENABLED=false
PLAYIT_URL=

Runtime state file

ARX also persists setup/runtime defaults in state/arx_config.json.

Recommended way to change settings

Prefer CLI commands for common changes so state stays consistent.

# Update AI context safely
arx ai set-context 4096
# Apply changes
arx restart

Networking notes

• Dashboard default: 18890
• Minecraft default: 25565
• Ollama default local API: 127.0.0.1:11434

Playit tunnel configuration

arx tunnel setup
arx tunnel setup --url your-name.playit.gg:12345 --enable
arx tunnel status