Reference
astrad CLI
astrad CLI
astrad is the Astra server process. Most runtime behavior is controlled by environment variables in Environment Variables.
Usage
astrad [OPTIONS]
Options
--node-id <u64>: overridesASTRAD_NODE_ID.--peers <csv>: overridesASTRAD_PEERS.--client-addr <host:port>: overridesASTRAD_CLIENT_ADDR.--raft-addr <host:port>: overridesASTRAD_RAFT_ADDR.--profile <name>: overridesASTRAD_PROFILE(kubernetes|omni|gateway|auto).
Startup Notes
- CLI flags are optional overrides; baseline config comes from
AstraConfig::from_env(). --profileis parsed with validation and falls back toautowhen omitted.- Node identity and peer topology must be stable across restarts for safe raft membership.
Example
ASTRAD_NODE_ID=1 ASTRAD_PEERS=1@node1:2380,2@node2:2380,3@node3:2380 \
ASTRAD_CLIENT_ADDR=0.0.0.0:2379 ASTRAD_RAFT_ADDR=0.0.0.0:2380 \
astrad --profile kubernetes