Get Started

Upgrade

Ixiea runs on Kubernetes. Upgrades roll forward container images published to ghcr.io/ixiea/* using Helm or a controlled deployment restart. Plan upgrades during a maintenance window and verify PostgreSQL backups before you begin.

Before you upgrade

  • Confirm a recent backup of PostgreSQL and your Helm values file
  • Note your current image tag (global.imageTag in values or kubectl -n ixiea get deploy -o wide)
  • If you changed the web UI, wait for the web image build to finish before restarting the web deployment

Upgrade with Helm (rolling dev)

After CI publishes new :master images, re-run Helm with your Ixiea overlays and reuse existing release values:

  1. Pull the latest deploy chart if Helm values changed.
  2. Upgrade the release:
    helm upgrade ixiea ./charts/ixiea \
  -f ./charts/ixiea/values.yaml \
  --namespace ixiea \
  --reuse-values
  3. Wait for rollouts to complete:
    kubectl -n ixiea rollout status deploy/ixiea-core
kubectl -n ixiea rollout status deploy/ixiea-web
  4. Log in to the administration interface and confirm connectors show healthy heartbeats under Settings → Components.

Restart deployments manually

If Helm values already match the cluster and you only need pods to pull fresh :master images:

kubectl rollout restart deployment -n ixiea \
  -l app.kubernetes.io/instance=ixiea

Upgrade to a pinned release

For production, tag every deployed component at the same version (for example v4.10.17), wait for CI to publish immutable images, then upgrade with an explicit tag:

  1. Merge the deploy chart bump for that release.
  2. Run Helm with global.imageTag set to the release:
    helm upgrade ixiea ./charts/ixiea \
  -f ./charts/ixiea/values.yaml \
  --namespace ixiea \
  --reuse-values \
  --set global.imageTag=v4.10.17
  3. Verify core, web, and connector pods are on the new tag:
    kubectl -n ixiea get pods -o wide

For immutable release tags, consider setting imagePullPolicy to IfNotPresent in your values overlay.

Air-gapped clusters

Mirror the new ghcr.io/ixiea/* images into your private registry, update your values file to point at the mirror, then run the same Helm upgrade. Offline upgrade packages are delivered through your Ixiea account team , contact us for supported versions.

Next steps