Skip to main content
Keep your installed providers up to date or remove them when no longer needed.

Prerequisites

  • Install the CLI: see Installation
  • Authenticate: pragma auth login
  • Verify workspace context: pragma config current-context

Checking for Upgrades

View your installed providers and their upgrade status:
The Upgrade Available column shows when a newer version exists in the store.

Upgrading a Provider

Upgrade to Latest

Upgrade to a Specific Version

Skip Confirmation

What Happens During Upgrade

When you upgrade a provider:
  1. The platform pulls the new version’s image
  2. A rolling deployment replaces the existing provider
  3. Existing resources continue to work throughout the upgrade
  4. No downtime for active resources
If the provider is already on the requested version, the command returns a warning and exits without changes.

Auto-Upgrade

Providers installed with --upgrade-policy auto are upgraded automatically when a new version is published. The platform checks for updates periodically and performs rolling upgrades with zero downtime. To change a provider’s upgrade policy after installation, uninstall and reinstall with the desired policy.

Uninstalling a Provider

Basic Uninstall

If the provider has active resources, the uninstall will fail. You must either delete the resources manually or use --cascade.

Cascade Delete

Uninstall the provider and delete all resources it manages:
The --cascade flag deletes every resource created by the provider before removing the provider itself.

Force Uninstall

Skip the confirmation prompt:

Cascade + Force

Next Steps

Upgrade Policies

Learn about manual and auto upgrade policies.

CLI Reference

Full command reference for store operations.