Skip to content

CLI Configuration

Configure the standalone OneSearch CLI client.

Config File

Located at: - Linux/macOS: ~/.config/onesearch/config.yml - Windows: %APPDATA%\onesearch\config.yml

Example:

backend_url: http://infra-stack:8000
auth:
  token: null
output:
  colors: true
  format: table

Interactive login

onesearch config set backend_url http://infra-stack:8000
onesearch login
onesearch whoami

Environment variables

Useful for scripts and CI:

export ONESEARCH_URL=http://infra-stack:8000
export ONESEARCH_TOKEN=xxxxx
onesearch search "compose" --json

Docker fallback

If you prefer not to install the standalone package on a machine, you can still run the bundled CLI from the app container:

docker exec -it onesearch-app onesearch status

See CLI Overview for details.