The agent is the wakora binary. Run with no arguments it runs the agent loop (normally
started by the service manager). The flags and subcommands below cover the operator paths.
Registration and identity
| Command | What it does |
|---|
wakora --key <TEAM_KEY> | Register this host, then run. Used once, the key is not stored. |
wakora --version | Print the version and exit. |
wakora --test | Dry run: collect and print, do not connect. |
Configuration
| Command | What it does |
|---|
wakora --set <svc>.<key>=<value> | Write a location override to wakora.conf and exit. |
wakora --baseline | Run in safe baseline mode (probes do not activate). |
wakora --custom-metrics-port <port> | Loopback port for app custom metrics (app.*). |
wakora --otlp-port <port> | Loopback OTLP receiver for APM spans. |
wakora --otlp-bind <addr> | Extra bind address for OTLP (for example a Docker bridge). |
Secrets
| Command | What it does |
|---|
wakora secret set <name> [--user U] [--priv] | Store a credential encrypted on the host. |
wakora secret list | List stored secret names (no values). |
wakora secret rm <name> | Remove a stored secret. |
The password is read from a no-echo prompt, or from stdin for automation. --priv (SNMP
v3) prompts for both the auth and the privacy passphrase.
Service management
| Command | What it does |
|---|
wakora service install | Install and start the service (idempotent). |
wakora service uninstall | Remove the service. |
wakora service start / stop | Start or stop the service. |
On Linux with systemd the unit is wakora-agent, managed with systemctl. service
subcommands are the primary path on macOS (launchd) and Windows (SCM).
Updates
| Command | What it does |
|---|
wakora --update | Update to the latest signed release and restart the service. |
Files
| Path | Contents |
|---|
/etc/wakora/identity | UUID and per-server key (machine-bound ciphertext). |
/etc/wakora/wakora.conf | Optional non-secret location overrides (INI). |
/etc/wakora/secrets.conf | Encrypted local credentials. |
/var/lib/wakora/ | Offline spool, provisioned APM artifacts, staged changes. |
/var/log/wakora/agent.log | Agent log (rotated). |
On Windows these fold into %ProgramData%\Wakora.