---
title: "Upgrading and Updating cloudSwXtch"
slug: "upgrading-cloudswxtch"
updated: 2025-12-19T20:07:56Z
published: 2025-12-19T20:07:56Z
canonical: "docs.swxtch.io/upgrading-cloudswxtch"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.swxtch.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Upgrading and Updating cloudSwXtch

**WHAT TO EXPECT**

**In this article**, users will learn how to update or upgrade their cloudSwXtch when new versions are available. The following commands are cloud agnostic, so they should work regardless of what cloud they're using.

> [!WARNING]
> What to know:
> 
> There is no “in-place” upgrade from v3.x to v4.x since the base OS is different. The upgrade plan would be to create a new v4.x cloudSwXtch, manually configure with the desired configuration, and then install existing bridge(s) and xNIC(s) against the new cloudSwXtch. Then, the old cloudSwXtch can be destroyed.
> 
> The update plan from v4.x to 4.y is a matter of re-running the [cloud agnostic installation](/v2/docs/cloud-agnostic-cloudswxtch-vm-install) with the new version However it is important to note that if there is any configuration data needs to be kept, the `--persist` argument should be used, however it is not supported for all version upgrades.
> 
> Contact support before using this setting by emailing [support@swxtch.io](mailto:support@swxtch.io).

To update the cloudSwXtch with the old configuration, do the following:

1. Sign in to the VM where the cloudSwXtch is running.
2. Get the new version by running the following commands (this step may take some time to download the new version), replacing “v4.x.y” with the correct version (like v4.1.0):

```shell
token="si=RDONLY&spr=https&sv=2021-06-08&sr=c&sig=xyPF7SyI1cagUAEIZViqCHz7RroFTy2Fkltn2wwvMzc%3D"
ver="v4.x.y"
curl -X GET -H "x-ms-date: $(date -u)" "https://sdmcdevstorage.blob.core.windows.net/imagebuilder/swx-swxtch-${ver}.tar.gz?$token" -o /tmp/swx-swxtch-${ver}.tar.gz 
tar -xvf /tmp/swx-swxtch-${ver}.tar.gz -C /tmp; /tmp/swx-swxtch-${ver}/swx-install.sh --persist
```
3. After the installation, run the following command to see if the container is running:

```shell
docker ps
```

There should be a line with the name swx-swxtch. For example:

```shell
$ docker ps
CONTAINER ID   IMAGE               COMMAND                  CREATED       STATUS       PORTS                                               NAMES
eb75bf825142   swx-swxtch:latest   "./entrypoint.sh"        12 days ago   Up 4 hours                                                       swx-swxtch
bd29e86862f0   registry:2          "/entrypoint.sh /etc…"   12 days ago   Up 4 hours   0.0.0.0:443->443/tcp, [::]:443->443/tcp, 5000/tcp   registry
```

> [!CAUTION]
> **PLEASE NOTE**
> 
> In order to downgrade, please contact [support@swxtch.io](mailto:support@swxtch.io) to see if the operation is available for the combination of features/configurations used.

A software-based network switch with a virtual NIC service known as xNIC. Together these components create an overlay network on top of the standard cloud network. This overlay network adds many valuable network features, one of which is a seamless IP multicast experience.