Guide for updating Weights & Biases version and license across different installation methods.
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.
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.
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 initterraform 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:
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.