# Upgrading Connectware (Docker)

{% hint style="warning" %}
When upgrading your Connectware instance, follow the upgrade path based on your current version.

For all version upgrades that are **not** listed below, you can simply follow the [regular Connectware upgrade guide](#upgrading-connectware-to-a-new-version).

* **If you are on version 1.4.1 or below**
  * Upgrade sequentially: **1.5.0 → 1.7.0 → 2.0.0 → 2.0.1 → 2.0.2 → 2.0.5**
* **If you are between version 1.5.0 and 1.6.2**
  * Upgrade sequentially: **1.7.0 → 2.0.0 → 2.0.1 → 2.0.2 → 2.0.5**
* **If you are on version 1.7.0 or newer (but below 2.0.0)**
  * Upgrade sequentially: **2.0.0 → 2.0.1 → 2.0.2 → 2.0.5**
* **If you are on version 2.0.0**
  * Upgrade sequentially: **2.0.1 → 2.0.2 → 2.0.5**
* **If you are on version 2.0.1**
  * Upgrade sequentially: **2.0.2 → 2.0.5**
* **If you are on version 2.0.2, 2.0.3, or 2.0.4**
  * Upgrade directly to **2.0.5**
* **If you are performing a clean or new installation**
  * No upgrade path required. You can install the **latest available version** directly.

**Detailed instructions on each upgrade step**

* [Upgrading Connectware to 2.0.5 (Docker)](https://docs.cybus.io/documentation/installation-and-upgrades/upgrading-connectware/upgrading-connectware-docker/upgrading-connectware-to-2-0-5-docker)
* [Upgrading Connectware to 2.0.2 (Docker)](https://docs.cybus.io/documentation/installation-and-upgrades/upgrading-connectware/upgrading-connectware-docker/upgrading-connectware-to-2-0-2-docker)
* [Upgrading Connectware to 2.0.1 (Docker)](https://docs.cybus.io/documentation/installation-and-upgrades/upgrading-connectware/upgrading-connectware-docker/upgrading-connectware-to-2-0-1-docker)
* [Upgrading Connectware to 2.0.0 (Docker)](https://docs.cybus.io/documentation/installation-and-upgrades/upgrading-connectware/upgrading-connectware-docker/upgrading-connectware-to-2-0-0-docker)
* [Upgrading Connectware to 1.7.0 (Docker)](https://docs.cybus.io/documentation/installation-and-upgrades/upgrading-connectware/upgrading-connectware-docker/upgrading-connectware-to-1-7-0-docker)
* [Upgrading Connectware from 1.x to 1.5.0 (Docker)](https://docs.cybus.io/documentation/installation-and-upgrades/upgrading-connectware/upgrading-connectware-docker/upgrading-connectware-from-1-x-to-1-5-0-docker)
  {% endhint %}

{% hint style="warning" %}
Downgrading to previous Connectware versions is not supported.
{% endhint %}

## Upgrading Connectware to a New Version

* To upgrade Connectware to a newer version, get the latest installer script by following the steps in the [Prepare Installer Script](https://docs.cybus.io/documentation/installing-connectware/installing-connectware-docker#preparing-the-installer-script) chapter. When running the update, select your current Connectware installation directory.

The update will automatically preserve your existing configuration, including your license key and network settings. If you're prompted to enter a license key during the update, this usually means you have selected the wrong installation directory. In this case, cancel the update and verify you have chosen the correct path.

{% hint style="warning" %}
If you originally installed Connectware using sudo privileges, make sure to use `sudo` when running the update as well.
{% endhint %}

## Upgrading Connectware in Silent Mode

The installer supports an automated deployment mode that requires no manual intervention. You can activate this by using either `-s` or `--silent`, and `-d`(directory) when [running the installation script](#running-the-installer-script).

If you need to customize your installation, the script offers several configuration options. Run the installer with `--help` to view all available parameters.

**Example**

{% code lineNumbers="true" %}

```yaml
./connectware-online-installer.sh -s -d <PATH/TO/YOUR/CONNECTWARE/FOLDER>
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cybus.io/documentation/installation-and-upgrades/upgrading-connectware/upgrading-connectware-docker.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
