Skip to content

Update Instructions

Instructions for updating Pixee Enterprise Server to newer versions.

Dashboard sign-in during an update

If you use embedded authentication with dashboards enabled, this update rotates the credential the dashboards use to authenticate against the identity provider. Signing in to dashboards can fail with invalid_client for a minute or two while the dashboard and identity-provider pods restart. No action is needed — sign-in recovers on its own once both have restarted. Dashboard data and saved charts are unaffected.

Helm upgrades: authentication is now on by default

global.pixee.access.enabled now defaults to true. An existing Helm install that never set it was running unauthenticated, and helm upgrade will now stop with global.pixee.access.enabled requires authentik.enabled rather than silently changing the security posture of a running system. Pick one before upgrading:

  • Turn authentication on (recommended): enable Authentik and supply its OIDC client credentials, per Authentication.
  • Stay unauthenticated: set global.pixee.access.enabled: false in your values file, which makes the existing behavior explicit. The platform then binds every request to a built-in administrator, so only do this on an isolated network.

Embedded Cluster installs are unaffected — they already enable authentication.

Update Process

To update Pixee Enterprise Server in Embedded Cluster deployments follow:

Updating Pixee Enterprise Server is a simple process:

  1. Visit the admin console in your browser: https://<domain name or vm ip>:30000
  2. Login with the admin console password set during installation
  3. New available versions will be visible in the Available Updates list under the Version History tab
  4. Click deploy next to the desired version you want to upgrade to
  5. Confirm configuration
  6. Verify preflight checks
  7. Confirm deployment

To update Pixee Enterprise Server in Helm Deployment follow:

To update a Pixee Enterprise Server release, use the helm upgrade command. This is good for when you need to apply template changes to the running release or update configuration values.

To change variable values in a release, use the helm upgrade command with the -f flag and provide your updated values.yaml file:

helm upgrade pixee-enterprise-server oci://registry.pixee.ai/pixee/stable/pixee-enterprise-server -f values.yaml -n pixee-enterprise-server

If you installed the optional sibling charts (pixee-enterprise-server-docs, pixee-enterprise-server-dashboards), upgrade them separately and to the same chart version — they are version-locked with the main chart and released together:

helm upgrade pixee-enterprise-server-docs oci://registry.pixee.ai/pixee/stable/pixee-enterprise-server-docs -f values.yaml -n pixee-enterprise-server
helm upgrade pixee-enterprise-server-dashboards oci://registry.pixee.ai/pixee/stable/pixee-enterprise-server-dashboards -f values.yaml -n pixee-enterprise-server