# Quickstart

> Install NOVA Flow on your Wandelbots NOVA OS instance with the NOVA Flow installer from the app store. Learn how to install the installer, choose optional extensions, and update or remove NOVA Flow.

The NOVA Flow installer is an app for Wandelbots NOVA OS.
It installs NOVA Flow on the cell of your instance, keeps it up to date and removes it again.

## Prerequisites

- A Wandelbots NOVA OS instance, in NOVA Cloud or on your own hardware.\
  No instance yet? Create one in the [NOVA Cloud quickstart](/nova-cloud/quickstart), then come back here.
- Access to NOVA Flow. The installer is not yet available in the public app store.
  Use `Request feature access` in the [NOVA Cloud capabilities](https://portal.wandelbots.io/experimental) section to get access.

You need no robot to install and try NOVA Flow.
Add a virtual or physical robot to the cell once you want to run your flows on it.

### Step 1: Install the installer

1. In `App Store`, select `novaflow-installer`.
2. Select `Install`.\
   → `Installing "novaflow-installer"` is displayed. Once it is done, the entry is marked `installed` and displays `Open` and `Remove`.

![The novaflow-installer entry in the app store with the Install button](/assets/developer/nova-flow/appstore-installer-entry.webp)

3. Go back to the home screen.\
   → `novaflow-installer` is displayed on the home screen.

![Wandelbots NOVA home screen with the novaflow-installer app](/assets/developer/nova-flow/home-with-installer.webp)

### Step 2: Install NOVA Flow

1. Open `novaflow-installer` on the home screen.\
   → `NovaFlow Installer` is displayed. `Installed` displays `Not installed`, `Latest version` displays the newest stable NOVA Flow release.

![The NOVA Flow installer before the first installation, with the installed and latest version, the install button and the extensions](/assets/developer/nova-flow/installer-not-installed.webp)

2. Optional: Under `Extensions`, select the services your cell needs.\
   Per default, no extension is selected. See [Extensions](#extensions).
3. Select `Install NovaFlow <version>`.\
   → The button displays `Starting services…` and how many services are still starting. After about a minute, `Done` and `All NovaFlow services have been deployed.` are displayed. `Installed services` lists every service on the cell.

![The NOVA Flow installer after the installation, with the Done message and the list of installed services](/assets/developer/nova-flow/installer-done.webp)

### Step 3: Open NOVA Flow

1. Select `Back to the home screen`.\
   → The home screen displays `flow`, and the `controlplane` and `utilities` services of NOVA Flow.

![Wandelbots NOVA home screen with the flow app and the NOVA Flow services](/assets/developer/nova-flow/home-with-flow.webp)

2. Open `flow`.\
   → NOVA Flow opens with the `Flows` panel. A new cell displays `No flows yet. Create one to get started.`

![NOVA Flow on its first start with an empty Flows panel](/assets/developer/nova-flow/flow-first-start.webp)

NOVA Flow is now installed on your instance. Continue with [behavior trees](/developer/nova-flow/behavior-trees) to build your first flow.

## Extensions

Extensions are optional services for cells that need them.
Extensions already installed on the cell stay selected, so an update keeps them.

| Extension | Adds |
| - | - |
| `agv` | Automated guided vehicles over VDA 5050 |
| `fleet` | Vehicles driven by a fleet manager |
| `mobile` | Navigation of mobile robots |
| `program` | Running Wandelbots NOVA programs from a flow |
| `buddy` | The chat assistant in NOVA Flow. Requires an OpenAI API key, which you enter in the installer. |

> **Info:** The installer stores the OpenAI API key for `buddy` as a plain environment variable on the app, not as a Kubernetes secret.

## Update to a newer version

While a newer NOVA Flow release is available, the `novaflow-installer` icon on the home screen displays an `update` label.

![The novaflow-installer icon on the home screen with the update label](/assets/developer/nova-flow/home-installer-update.webp)

1. Open `novaflow-installer`.\
   → `Update available` names the installed and the new version.
2. Select `Update to <version>`.\
   → The installer updates every service to the new version and removes services that are no longer part of NOVA Flow.

Your flows and globals are kept.

## Advanced options

`Advanced` starts collapsed. Change its settings only if you know your cell needs it.

![The Advanced section of the NOVA Flow installer with the standard services, the robots moving at once and the version field](/assets/developer/nova-flow/installer-advanced.webp)

| Option | What it does |
| - | - |
| `Standard services` | The services installed on every cell: `core`, `general`, `io`, `nova` and `omniverse`. Clear one only if the cell does not need it. |
| `Robots moving at once` | How many motion groups one flow moves at the same time. Per default, 18, which is also the maximum for now. |
| `Install a different version` | Installs another NOVA Flow release than the latest, for example to roll back. The install button then displays `Downgrade to <version>` or `Reinstall <version>`. |

## Remove from the cell

1. Open `novaflow-installer`.
2. Under `Installed services`, select `Remove NovaFlow from this cell`.
3. Select `Uninstall NovaFlow` and confirm.\
   → Within a few minutes, every NOVA Flow service is removed from the cell. The installer stays installed. Your flows and globals are kept.
