CLI

Commands#

bouine serve --config /etc/bouine/config.yaml
bouine config validate <file>
bouine config schema
bouine completion bash|zsh|fish
bouine purge <url>  --token <token>
bouine ban host_regex=example.com path_regex=^/api  --token <token>
bouine refresh <url>  --token <token>
bouine cluster peers
bouine version

--server defaults to 127.0.0.1:9000. All commands default to port 9000 so --server is optional when running locally.

serve#

Starts the bouine daemon. Boots every configured listener (HTTP/1.1, admin), wires the pipeline router to the upstream pools, and blocks until SIGINT/SIGTERM.

config validate#

Loads and validates a bouine YAML config file without starting the daemon. Reports validation errors only.

bouine config validate bouine.yaml
# config is valid

config schema#

Prints the JSON schema for the bouine Helm chart values. Useful for editor autocomplete and CI validation.

bouine config schema > schema.json

completion#

Generates shell completion scripts for bash, zsh, or fish.

# bash
source <(bouine completion bash)

# zsh
source <(bouine completion zsh)

# fish
bouine completion fish | source

Add to your shell profile for persistence.

purge#

Purges a single URL from the cache.

bouine purge https://example.com/page --token my-token

ban#

Issues a predicate-based ban. The CLI supports host_regex and path_regex. Surrogate-key bans are available via the admin API only.

bouine ban host_regex=example.com path_regex=^/api --token my-token

refresh#

Soft-purges a URL (marks it stale, triggers background revalidation on next request).

bouine refresh https://example.com/page --token my-token

cluster peers#

Lists live cluster peers.

bouine cluster peers --server 127.0.0.1:9000 --token my-token

version#

Prints the bouine version, commit, and build date.

bouine version