Upgrading and Updating cloudSwXtch

  • Updated on Dec 19, 2025
  • Published on Oct 18, 2023
  • 2 minute(s) read
Prev Next

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. 

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 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. 

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):  

    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:

    docker ps

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

    $ 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

PLEASE NOTE

In order to downgrade, please contact support@swxtch.io to see if the operation is available for the combination of features/configurations used.