Configuration

setup writes everything the gateway needs — for most installations you never touch a configuration file. This page documents where the gateway keeps its data and which settings you can tune.

File locations

Data	macOS	Linux	Windows
Configuration & buffer	`~/Library/Application Support/proxai/proxai-gateway/prod/`	`~/.config/proxai/proxai-gateway/prod/`	`%LOCALAPPDATA%\proxai\proxai-gateway\prod\`
Logs	`~/Library/Logs/proxai/proxai-gateway/prod/`	`~/.local/state/proxai/proxai-gateway/log/prod/`	`%LOCALAPPDATA%\proxai\proxai-gateway\Logs\prod\`
Binary	`~/.proxai/bin/proxai-gateway`	`~/.proxai/bin/proxai-gateway`	`%USERPROFILE%\.proxai\bin\proxai-gateway.exe`

The configuration directory holds config.toml (the settings file) and buffer.db (the local SQLite buffer of captured records). On macOS and Linux both files are created with owner-only permissions.

config.toml

The file is plain TOML. A typical configuration looks like this:


[account]
api_key        = "<your-gateway-key>"
user_id        = "<assigned-during-setup>"
host_id        = "<derived-during-setup>"
installed_at   = "2026-06-12T09:30:00Z"
install_source = "github_release"
 
[capture]
receipt_retention_days = 365
failed_retention_days  = 365
 
[logging]
level = "info"
 
[stale_binary]
warn_after_days  = 30
pause_after_days = 60

After editing the file, restart the daemon so it picks up the changes:


proxai-gateway restart

`[account]`

Written and managed by setup and setup new. It holds your gateway key, your user id, the hashed host id of this machine, and install metadata. Don’t edit this section by hand — use setup new to change the key.

`[capture]`

Tuning knobs for the local buffer and the uploader. All values are optional; the defaults suit almost every installation.

Setting	Default	Meaning
`receipt_retention_days`	`365`	How long records of successful uploads stay visible in `logs`
`failed_retention_days`	`365`	How long failed records are kept for inspection and retry
`buffer_soft_pause_bytes`	50 GiB	Buffer size at which capture pauses until uploads catch up
`buffer_soft_resume_bytes`	45 GiB	Buffer size at which capture resumes
`upload_max_batches_per_sec`	`5`	Upload rate limit, in batches per second
`upload_max_bytes_per_minute`	50 MiB	Upload bandwidth cap
`upload_backoff_on_429_multiplier`	`2`	Extra back-off applied when ProxAI asks the gateway to slow down

`[logging]`

Setting	Default	Meaning
`level`	`info`	Log verbosity: `fatal`, `error`, `warn`, `info`, `debug`, or `trace`
`log_dir`	platform default (above)	Where the gateway writes its own log files

`[stale_binary]`

Controls the automatic upgrade behavior.

Setting	Default	Meaning
`warn_after_days`	`30`	Log a warning once the binary is this old (`0` disables)
`pause_after_days`	`60`	Auto-upgrade once the binary is this old (`0` disables)

`[backend]`

Endpoint overrides for the ProxAI backend. The defaults point at ProxAI production; you only need this section if ProxAI support asks you to repoint the gateway.