Update Weights & Biases license and version

This guide shows W&B Server administrators how to update the W&B Server version and license key for an existing self-managed deployment. Keeping your server and license current ensures access to the latest features, fixes, and continued entitlement to use W&B Server. Update your W&B Server version and license with the same method you used to install W&B Server. The following table lists how to update your license and version based on different deployment methods.

Release type	Description
Terraform	Weights & Biases supports three public Terraform modules for cloud deployment: AWS, Google Cloud, and Azure.
Helm	Use the Helm Chart to install Weights & Biases into an existing Kubernetes cluster.

Update with Terraform

If you deployed W&B Server with one of the Weights & Biases-maintained Terraform modules, use Terraform to update both your license key and the Weights & Biases version in place. The following table lists Weights & Biases-managed Terraform modules by cloud platform.

Cloud provider	Terraform module
AWS	AWS Terraform module
Google Cloud	Google Cloud Terraform module
Azure	Azure Terraform module

Navigate to the Weights & Biases-maintained Terraform module for your cloud provider. See the preceding table to find the Terraform module that matches your cloud provider.

In your Terraform configuration, update wandb_version and license in your Terraform wandb_app module configuration:

module "wandb_app" {
    source  = "wandb/wandb/[CLOUD-SPECIFIC-MODULE]"
    version = "new_version"
    license       = "new_license_key" # Your new license key
    wandb_version = "new_wandb_version" # Desired W&B version
    ...
}

Apply the Terraform configuration with terraform plan and terraform apply.
terraform init terraform apply
Optional: If you use a terraform.tfvars or other .tfvars file, update or create one with the new Weights & Biases version and license key.
terraform plan -var-file="terraform.tfvars"
From your Terraform workspace directory, apply the configuration:
terraform apply -var-file="terraform.tfvars"

After Terraform applies the change, your deployment runs the specified Weights & Biases version and uses the updated license key.

Update with Helm

The wandb Helm chart is deprecated and no longer supported. It deployed a single pod and has been replaced by the W&B Kubernetes Operator. If you’re still using this chart, follow the migration guide to move to the operator.

Two Helm-based update paths are available: update from your existing Helm values file, or set the new license and image tag directly on the upgrade command. The following sections describe each approach.

Update Weights & Biases with spec

Use this approach when you manage your Helm configuration in a tracked *.yaml values file.

Specify a new version by modifying the image.tag or license values, or both, in your Helm chart *.yaml configuration file:
license: 'new_license' image: repository: wandb/local tag: 'new_version'

Update the Helm repository and upgrade the Weights & Biases release using your values file:

helm repo update
helm upgrade --namespace=wandb --create-namespace \
  --install wandb wandb/wandb --version ${chart_version} \
  -f ${wandb_install_spec.yaml}

Update license and version directly

Use this approach to update the license and image tag without editing a values file, and reuse your existing Helm release configuration.

Set the new license key and image tag as environment variables:
export LICENSE='new_license' export TAG='new_version'

Upgrade your Helm release, merging the new values with the existing configuration:

helm repo update
helm upgrade --namespace=wandb --create-namespace \
  --install wandb wandb/wandb --version ${chart_version} \
  --reuse-values --set license=$LICENSE --set image.tag=$TAG

For more information, see the upgrade guide in the public repository.

Update with admin UI

Use the admin UI to rotate your license key from within the W&B App, without changing your deployment configuration. This method only works for updating licenses that aren’t set with an environment variable in the Weights & Biases server container, typically in self-managed Docker installations. This method updates the license only. It doesn’t change the running W&B Server version.

Obtain a new license from the Weights & Biases Deployment Page, ensuring it matches the correct organization and deployment ID for the deployment you want to upgrade.
Access the License page in the W&B App. Click Settings > License or browse to HOST_URL/console/settings/license, where HOST_URL is your W&B Server host URL.
Navigate to the license management section.
Enter the new license key and save your changes.

​Update with Terraform

​Update with Helm

​Update Weights & Biases with spec

​Update license and version directly

​Update with admin UI

Update with Terraform

Update with Helm

Update Weights & Biases with spec

Update license and version directly

Update with admin UI