Skip to content

Upgrade

You can upgrade GPUStack using the installation script or by manually installing the desired version of the GPUStack Python package.

Note

When upgrading, upgrade the GPUStack server first, then upgrade the workers.

Upgrade GPUStack Using the Installation Script

To upgrade GPUStack from an older version, re-run the installation script using the same configuration options you originally used.

Running the installation script will:

  1. Install the latest version of the GPUStack Python package.
  2. Update the system service (systemd, launchd, or Windows) init script to reflect the arguments passed to the installation script.
  3. Restart the GPUStack service.

Linux and macOS

For example, to upgrade GPUStack to the latest version on a Linux system and macOS:

curl -sfL https://get.gpustack.ai | <EXISTING_INSTALL_ENV> sh -s - <EXISTING_GPUSTACK_ARGS>

To upgrade to a specific version, specify the INSTALL_PACKAGE_SPEC environment variable similar to the pip install command:

curl -sfL https://get.gpustack.ai | INSTALL_PACKAGE_SPEC=gpustack==x.y.z <EXISTING_INSTALL_ENV> sh -s - <EXISTING_GPUSTACK_ARGS>

Windows

To upgrade GPUStack to the latest version on a Windows system:

$env:<EXISTING_INSTALL_ENV> = <EXISTING_INSTALL_ENV_VALUE>
Invoke-Expression (Invoke-WebRequest -Uri "https://get.gpustack.ai" -UseBasicParsing).Content

To upgrade to a specific version:

$env:INSTALL_PACKAGE_SPEC = gpustack==x.y.z
$env:<EXISTING_INSTALL_ENV> = <EXISTING_INSTALL_ENV_VALUE>
Invoke-Expression "& { $((Invoke-WebRequest -Uri 'https://get.gpustack.ai' -UseBasicParsing).Content) } <EXISTING_GPUSTACK_ARGS>"

Docker Upgrade

If you installed GPUStack using Docker, upgrade to the a new version by pulling the Docker image with the desired version tag.

For example:

docker pull gpustack/gpustack:vX.Y.Z

Then restart the GPUStack service with the new image.

Manual Upgrade

If you install GPUStack manually, upgrade using the common pip workflow.

For example, to upgrade GPUStack to the latest version:

pip install --upgrade gpustack

Then restart the GPUStack service according to your setup.