CLI reference
The tarball installs the executable at the stable path /opt/particle_horizon/keystone-gateway; the examples below shorten this to keystone-gateway. Run keystone-gateway --help for generated command help. Commands return zero on success and one on validation, I/O, or request failure.
| Command | Purpose | Key options |
|---|---|---|
serve --config FILE | Start Gateway | Every configuration key is also a --dotted-key-as-hyphenated flag; see configuration reference. |
node-id --config FILE | Print JSON {gateway_id,replica_id} for license issuance | Same configuration overrides as serve. Does not read a license or host hardware. |
config validate --config FILE | Resolve and validate configuration without starting | Same overrides as serve; checks field values and required file paths, not file readability. |
report | Fetch a support report from a running Gateway | --endpoint (default http://127.0.0.1:8080), `—format text |
version [--short] | Print version metadata | --short prints only version. Root --version prints the same metadata line. |
The root persistent --config FILE applies to serve, node-id, and config validate; it is accepted by report but not used. Shell completion is generated by Cobra’s completion command. Do not put secrets in flags.