Upgrading groundSwXtch

WHAT TO EXPECT
In this article, users will learn how to upgrade an existing groundSwXtch to a newer version.

To upgrade the groundSwXtch:

Connect to the VM or hardware device where the groundSwXtch is running.

Enter the following commands to download and install the groundSwXtch installer script:

curl -fL "https://swxrkdistribution.blob.core.windows.net/swxcontainer01/install-groundswxtch.sh?sp=rl&st=2026-05-21T21:40:09Z&se=2027-05-23T05:55:09Z&spr=https&sv=2026-02-06&sr=c&sig=HA9RA9sUQwLBKfePWwB3UhLKGlvtJgoT6z2bCU1Kb6k%3D" -o install-groundswxtch.sh && chmod +x install-groundswxtch.sh

Run the installer with the new version. Replace <version> with the version to install (for example v1.1.1), or use latest-prod for the newest production release:
```
sudo ./install-groundswxtch.sh install --image-tag groundswxtch:<version>
```
If you used other options when you installed (for example --name, --no-hugepages or --network-mode), pass the same options again.

Example:

sudo ./install-groundswxtch.sh install --image-tag groundswxtch:v1.1.1

After the installation, run the following command to see if the container is running:

docker ps

There should be a line with the name gswx. For example:

ubuntu@gs-host:~$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
d50428d6b201 groundswxtch:v1.1.1 "groundswxtchd" 5 hours ago Up 5 hours gswx
95d07c68d75e swx-tools:1.0.0 "sleep infinity" 5 days ago Up 29 hours swx-tools
ubuntu@gs-host:~$