🚧 DevGuard & this page is under active development. Visit the DevGuard Repo →
How-to GuidesAdministrationUpgrade DevGuard

Upgrade DevGuard

Upgrade DevGuard to the latest version to receive security patches, new features, and vulnerability database improvements.

Releases

Check the GitHub releases for available versions.

The DevGuard API and Web images share the same version tags. The Helm chart version and CI components/actions may have different version numbers.

Before Upgrading

  1. Check the changelog for breaking changes
  2. Create a backup — see Backup & Restore
  3. Test in staging if possible

Upgrade

helm upgrade devguard oci://ghcr.io/l3montree-dev/devguard-helm-chart/devguard \
  --version <version> \
  --namespace devguard \
  -f values.yaml

Verify deployment

kubectl rollout status deployment/devguard-api-deployment -n devguard
kubectl rollout status deployment/devguard-web-deployment -n devguard

Rollback

If issues occur:

helm rollback devguard -n devguard

Override image versions

If the Helm chart version differs from the application version, override the image tags in your values.yaml:

api:
  image:
    tag: "<version-tag>"
 
web:
  image:
    tag: "<version-tag>"

Database Migrations

DevGuard runs database migrations automatically on startup. No manual intervention required.

If a migration fails:

  1. Check the API logs for error details
  2. Restore from backup
  3. Report the issue on GitHub
Monitoring & MetricsDatabase Maintenance