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

nova flow install

Install or update NovaFlow on the cell

Synopsis

Installs NovaFlow on the cell, or switches it to another version.

NOVA deploys NovaFlow as part of the cell when its NovaFlow feature flag is set; this command sets the flag and waits until NovaFlow answers. Without --version, the version that comes with the NOVA version is installed (or the version selected by an earlier --version is kept; '--version default' goes back to the one that comes with NOVA). Other versions need to be available to the instance from the Wandelbots registry; if one can't be deployed, the previous version keeps running and 'nova flow status' shows why.

The flag needs NOVA 26.4 or newer and the permission to manage cells; --version and progress reporting need NOVA 26.8 or newer.

Where the instance doesn't expose the feature flag API (e.g. cloud instances on portal.wandelbots.io, or NOVA before 26.4), the command installs the novaflow-installer app from the preview catalog and lets it deploy the NovaFlow apps instead; --installer does that everywhere. Once the novaflow-installer app is on the cell, install and uninstall always go through it. Without --version it installs the version the installer recommends.

The command refuses to switch between both ways, or to touch a NovaFlow installed another way (e.g. with helm), unless --force is given.

nova flow install [flags]

Examples

# the NovaFlow version that comes with the NOVA version, waits until it answers
nova flow install

# a specific chart version
nova flow install --version 2026.10.69

# back to the version that comes with NOVA, e.g. after a version failed to deploy
nova flow install --version default

# with the novaflow-installer app from the preview catalog (automatic where NOVA can't deploy it itself)
nova flow install --installer

# don't wait (check later with 'nova flow status')
nova flow install --no-wait

Options

      --force              Install even if NovaFlow was installed another way
  -h, --help               help for install
      --installer          Install with the novaflow-installer app (preview catalog) even if NOVA can deploy NovaFlow itself
      --no-wait            Return without waiting for the deployment
      --timeout duration   How long to wait for the deployment (default 10m0s)
      --version string     NovaFlow chart version, or 'default' for the one the NOVA version ships with (default: keep the version selected before)

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)
  -y, --yes                        Answer yes to questions, e.g. to install NovaFlow when it is missing

SEE ALSO

  • nova flow - Manage NovaFlow and its flows on the current cell