Configuration

Every triage setting, from the environment or an options file.

Every setting comes from an environment variable. The user services read theirs from ~/.config/triage/agent.env, server.env and worker.env.

Options file

Any setting can also come from a JSON file at TRIAGE_OPTIONS, with lowercase keys and no TRIAGE_ prefix:

{ "decide": true, "decide_daily": 10, "cloudflare_api_token": "..." }

Environment variables win over the file. The Home Assistant app uses this for its options.

Hosts

Variable	Default
`TRIAGE_SERVER`	none	The server’s URL
`TRIAGE_TOKEN`	none	The host’s token, from `triage hosts add`
`TRIAGE_REDACT_NAMES`	none	Other names to redact, comma-separated, such as a GitHub account
`TRIAGE_DB`	`$XDG_STATE_HOME/triage/triage.db`	The host’s own store, which also holds events until they’re sent

Server

Variable	Default
`TRIAGE_HOSTNAME`	`127.0.0.1` (`::` in the container, IPv4 and IPv6)	Address to listen on
`TRIAGE_PORT`	`7171`	Port to listen on
`TRIAGE_SERVER_DB`	`$XDG_STATE_HOME/triage/server.db` (`/data/server.db` in the container)	Server database
`TRIAGE_TRUST_PROXY`	`false`	Trust `X-Forwarded-Host` and `X-Forwarded-For`. Only turn this on when the proxy is the only way to reach the server
`TRIAGE_SERVER_ADMIN_TOKEN`	none	An admin token the server always accepts, at least 32 characters, for managing tokens with `--server`. It isn’t stored or listed
`TRIAGE_INGRESS_PORT`	none (`8099` in the Home Assistant app)	A second port for Home Assistant ingress, which treats every request as an admin’s and only answers `TRIAGE_INGRESS_FROM`
`TRIAGE_INGRESS_FROM`	`172.30.32.2`, Home Assistant’s Supervisor	The only address the ingress port answers
`TRIAGE_DECIDE_DAILY`	`20`	The most issues each decision model may decide on in any 24 hours, by the server and its workers together
`TRIAGE_SUGGEST_DAILY`	`5`	The most suggestions each language model may make in any 24 hours, by the server and its workers together

Workers and admins

Variable	Default
`TRIAGE_SERVER`	none	The server’s URL
`TRIAGE_WORKER_TOKEN`	none	The worker’s token, from `triage workers add`
`TRIAGE_ADMIN_TOKEN`	none	An admin token, for `--server` on the token and issue commands

Models

These apply wherever the models run: triage work, triage serve, and the one-off decide and suggest commands.

Variable	Default
`TRIAGE_DECIDE`	`false`	Ask a decision model about new issues every 5 minutes. The answers are only stored for now, to compare models
`TRIAGE_DECISION_PROVIDER`	`typesafe`	`typesafe` for any TypeSafe System One API, such as Ollaya or Ollama 0.35+, or `cloudflare` for Clef on Workers AI
`TRIAGE_DECISION_URL`	`http://127.0.0.1:11435/v1` (Ollaya)	The System One API, such as `http://127.0.0.1:11434/v1` for Ollama
`TRIAGE_DECISION_API_KEY`	none	Key for a hosted System One API, such as TypeSafe or OpenCode Zen
`TRIAGE_DECISION_MODEL`	`laya` through System One, `clef-flash` with Cloudflare	Decision model, such as `laya` or `winnow` on Ollaya, or `nimble` on Ollama
`TRIAGE_SUGGEST`	`false`	Suggest fixes every 15 minutes for issues the decision model rates worth fixing with at least 0.8 probability. Needs `TRIAGE_LLM_MODEL`
`TRIAGE_LLM_PROVIDER`	`openai`	`openai` for any OpenAI-compatible API, `anthropic` for any Anthropic-compatible one, or `cloudflare` for Workers AI
`TRIAGE_LLM_URL`	OpenAI’s or Anthropic’s own	The API, such as `https://openrouter.ai/api/v1`, `https://opencode.ai/zen/v1` or `http://127.0.0.1:11434/v1` for Ollama
`TRIAGE_LLM_API_KEY`	none	Key for the API, when it needs one
`TRIAGE_LLM_MODEL`	none	Language model for fix suggestions, such as `@cf/google/gemma-4-26b-a4b-it` on Workers AI
`CLOUDFLARE_ACCOUNT_ID`	none	Your Cloudflare account, for either provider set to `cloudflare`
`CLOUDFLARE_API_TOKEN`	none	A token with Workers AI access, for either provider set to `cloudflare`

On the serve and work command lines, the language model settings are --llm-provider, --llm-url and --llm-model, since --provider, --url and --model are the decision model’s.