Skip to content

Configuration

The CLI resolves connection settings in this order:

  1. Command-line flags
  2. Environment variables
  3. TOML config file

By default, the config file is loaded from ~/.config/runta/config.toml. Use --config <PATH> or RUNTA_CONFIG to choose another file.

endpoint = "https://api.runta.dev"
token = "<tenant_token>"
FlagEnvironment variableDescription
--endpoint <ENDPOINT>RUNTA_ENDPOINTRunta REST API endpoint URL. Use http:// for local development or https:// for hosted API access.
--token <TOKEN>RUNTA_TOKENBearer token for the Runta API.
--config <PATH>RUNTA_CONFIGTOML config file path.
OptionDescription
--jsonEnable machine-readable JSON output.
-v, --verboseEnable debug logging. Repeat as -vv for trace logging.
-h, --helpPrint help.
-V, --versionPrint version.

Only --json, -v/--verbose, and -h/--help can be placed after a subcommand. Put --endpoint, --token, --config, and -V/--version before the subcommand.