NOVA CLI reference 0.5.0 GitHub
  1. nova
  2. nova config

nova config set

Sets global configuration values

Synopsis

Sets a configuration value in the Wandelbots NOVA CLI configuration.

Most common configurations values are:

  • host: the host of the Wandelbots NOVA OS instance
  • cellname: name of the default cell to be used

host, cellname and virtualid are stored per instance: they apply to the selected instance, or to the one named via --instance / NOVA_INSTANCE (see 'nova instance'). If no instance exists yet, an instance "default" is created.

nucleus-host and nucleus-token belong to the selected Nucleus server, or the one named via --nucleus / NOVA_NUCLEUS (see 'nova nucleus server'). If there is none, setting nucleus-host adds one named after the host. Changing the host of a server drops its token.

All other values are global.

Other values:

  • editor: when editing cell or app definitions one can specify the default editor.
    • use e.g. "code --wait" to edit files with VS Code
  • container-runtime: force docker or podman for building and pushing images
    • auto-detected when unset (docker preferred, podman fallback)
nova config set [flags]

Examples


# Setting the host of the selected instance (set automatically by 'nova instance create/select')
nova config set host instanceid.instance.wandelbots.io

# Setting the Nucleus token of a specific Nucleus server without selecting it
nova config set nucleus-token <token> --nucleus dev

# Setting the default image registry to be used for pushing images via 'nova app install' command
# Example shows different providers:
nova config set image-registry company.azurecr.io/repo-name
nova config set image-registry ghcr.io/your-github-username
nova config set image-registry registry-1.docker.io/your-dockerhub-username
nova config set image-registry registry.code.wabo.run/group/project

# Setting the default editor to be used when editing app or cell definitions
nova config set editor "code --wait"

# Automatically creating a new cell when running commands that require a cell and no cell is present (defaults to true)
nova config set createcell true

# Setting the default cell name to be used for commands that require a cell (defaults to "cell")
nova config set cellname my-cell

# Forcing a container runtime for building and pushing images (auto-detected when unset)
nova config set container-runtime podman

Options

  -h, --help   help for set

Options inherited from parent commands

      --debug                      Write diagnostic output to stderr: HTTP requests and responses, external commands, the resolved instance. Known secrets are redacted, but bodies (app environments, kubeconfigs) can still contain some: don't share the output unreviewed (env: NOVA_DEBUG=1)
      --env string                 (Wandelbots internal) Portal environment for this invocation: prod, stg or dev (default: the environment of the cloud instance, else of the last 'nova login'; env: NOVA_ENV)
      --insecure-skip-tls-verify   If true, the server's certificate will not be checked for validity (disables TLS verification for all requests)
      --instance string            Name of the instance to work against for this invocation (overrides the selected instance; env: NOVA_INSTANCE)
      --nucleus string             Name of the Nucleus server for this invocation (overrides the selected one; env: NOVA_NUCLEUS)

SEE ALSO