Client environment settings

These variables affect the catalex command-line process, not an agent’s permissions or server limits. Set one for a specific command when diagnosing slow networks, large responses or bounded history reads. Leave it unset to use the default; values are decimal integers in the listed range.

For example:

CATALEX_CLIENT_REQUEST_TIMEOUT_MS=60000 catalex status

This gives a request up to one minute; it cannot make an unreachable server respond. A shorter caller deadline still wins. Higher byte/frame/history budgets increase potential memory and network work.

Environment setting	Unit	Default	Inclusive range
`CATALEX_CLIENT_DISCOVERY_MAX_BYTES`	bytes per publication	65536	1024–1048576
`CATALEX_CLIENT_REGISTRY_MAX_BYTES`	bytes per registry read/write	16777216	1024–67108864
`CATALEX_CLIENT_RESPONSE_MAX_BYTES`	bytes per HTTP response/request	16777216	1024–67108864
`CATALEX_CLIENT_ATTACHMENT_MAX_BYTES`	bytes per chat attachment upload or download	16777216	1024–67108864
`CATALEX_CLIENT_DISCOVERY_MAX_ENTRIES`	directory entries per scan	1024	1–16384
`CATALEX_CLIENT_MAX_CONNECTIONS`	references plus removal identities	1024	1–16384
`CATALEX_CLIENT_REQUEST_TIMEOUT_MS`	milliseconds per identity/scan/input/control request or console handshake	30000	1–600000
`CATALEX_CLIENT_OPERATION_TIMEOUT_MS`	milliseconds a command follows an accepted operation	600000	1–3600000
`CATALEX_CLIENT_POLL_INTERVAL_MS`	milliseconds between status reads while following	500	10–60000
`CATALEX_CLIENT_DISCOVERY_PROBE_TIMEOUT_MS`	milliseconds per liveness probe when several agent computers are discoverable	2000	1–600000
`CATALEX_CLIENT_CHAT_TIMEOUT_MS`	milliseconds per chat link handshake or request	30000	1–600000
`CATALEX_CLIENT_CHAT_WRITE_TIMEOUT_MS`	milliseconds per chat frame write	5000	1–600000
`CATALEX_CLIENT_CHAT_WATCH_MS`	default `chats watch` duration in milliseconds	30000	1–600000
`CATALEX_CLIENT_CHAT_MAX_FRAMES`	frames one chat link reads	1000	1–65536
`CATALEX_CLIENT_CHAT_HISTORY_LIMIT`	messages per history page	100	1–100
`CATALEX_CLIENT_CHAT_HISTORY_PAGES`	history pages one command reads	5	1–100
`CATALEX_CLIENT_CHAT_COMMAND_TTL_MS`	milliseconds a sent chat command stays admissible	1800000	1–86400000

CATALEX_RELAY_HOME selects an absolute configuration/state home; an empty value is invalid. Change it only to work with an intentionally separate installation. Saved connections and existing setup discovery then use that home.

For runtime capacity use advanced settings. For the remote computer selected by a command, use --connection NAME; do not change state-home variables to select a different server.