CLI reference

There are no subcommands. Everything the engine does is controlled by the TOML config and driven through the HTTP API. The binary just starts the server.

USAGE:
  xerj [OPTIONS]

OPTIONS:
  -c, --config <PATH>     Path to the TOML config file
                          [default: ./xerj.toml]
  -d, --data-dir <PATH>   Override [server] data_dir
  -k, --insecure          Disable TLS and API-key auth (dev only)
  -h, --help              Print help
  -V, --version           Print version and build commit

--config / -c

Path to the TOML config. Defaults to ./xerj.toml. The XERJ_CONFIG environment variable is consulted only if this flag is absent.

--data-dir / -d

Convenience override for [server] data_dir. Useful for ephemeral dev runs and for pointing XERJ at a tmpfs when you just want to burn something down after.

--insecure / -k

Disables TLS and API-key auth. Dev only. Fails loudly in production by refusing to start if bind_address is anything other than 127.0.0.1 unless the binary is built with the --release-mode dev flag.

--help / -h

Prints the synopsis above and exits.

--version / -V

Prints the version, git SHA, and build date. Useful in oncall pages: xerj -V | head -1.

Source · engine/crates/server/src/main.rs