cua config
User defaults: where sandboxes run (`default.on`), the default kind and runtime, cloud defaults.
User defaults: where sandboxes run (`default.on`), the default kind and runtime, cloud defaults.
| Command | Description |
|---|---|
cua config list | Every setting: its effective value and where it comes from (env, config or default). |
cua config get | One setting's effective value. |
cua config set | Write a setting to the config file. |
cua config unset | Remove a setting from the config file (the environment variable or the built-in default applies again). |
cua config path | The config file's path. |
Every command also accepts the global options.
User defaults (~/.cua/config.toml): where sandboxes run when --on is not given (default.on), the default kind and runtime, cloud defaults.
cua config [OPTIONS] <COMMAND>cua config list#Every setting: its effective value and where it comes from (env, config or default).
cua config list [OPTIONS]Alias: cua config ls.
Examples
cua config list
cua config list --jsoncua config get#One setting's effective value.
cua config get [OPTIONS] <KEY>| Argument | Type | Default | Description |
|---|---|---|---|
<KEY> | string | required | Setting (default.on, default.kind, default.runtime, cloud.warm, cloud.max_pool_size, cloud.claim_ttl). |
Examples
cua config get default.oncua config set#Write a setting to the config file.
cua config set [OPTIONS] <KEY> <VALUE>| Argument | Type | Default | Description |
|---|---|---|---|
<KEY> | string | required | Setting. |
<VALUE> | string | required | Value (checked: default.on takes local, cloud or a provider). |
Examples
# Create sandboxes in the cloud unless --on says otherwise
cua config set default.on cloud
# Back to this machine
cua config set default.on local
# Prefer VMs when the image offers both
cua config set default.kind vmcua config unset#Remove a setting from the config file (the environment variable or the built-in default applies again).
cua config unset [OPTIONS] <KEY>| Argument | Type | Default | Description |
|---|---|---|---|
<KEY> | string | required | Setting. |
Examples
cua config unset default.oncua config path#The config file's path.
cua config path [OPTIONS]Examples
cua config path| Code | Meaning |
|---|---|
0 | Success. |
1 | Failure, or cua do reported an error. |
2 | Invalid argument, or an ambiguous sandbox name (qualify it: local:NAME, cloud:NAME). |
3 | Not found: sandbox, window, skill or image (or an image not published yet). |
4 | Not supported, or not configured (for example no Fleet credentials). |
5 | No cua-spacesd answered, or a transport failure. |
6 | Unauthenticated or permission denied (by Cua, Fleet or your cloud account). |
7 | Not enough free disk space (see cua cache). |
130 | Cancelled (Ctrl-C during a create): what it made was removed. |