Configuration File Format

In addition to configuration via the command line interface, transient can also be configured via a configuration file. Flags mentioned in create/run/start/stop can be set in a configuration file using the TOML format. Currently, only the run, start and create subcommands supports using a configuration file.

For example, consider the following command:

$ transient run generic/alpine38:v3.0.2 \
   --name test-vm \
   --ssh-console \
   -- \
   -nographic -enable-kvm -m 1G

The following transient configuration file would produce the same behavior when executed:

# transient-config.toml

name = "test-vm"
ssh-console = true
qemu-args = [
    "-nographic",
    "-enable-kvm",
    "-m", "1G"
]

NOTE: required parameters like the image (in this example, generic/alpine38:v3.0.2) cannot currently be specified via the config file.

A transient configuration can be supplied using the --config flag. For example:

$ transient run generic/alpine38:v3.0.2 --config transient-config.toml