Skip to main content
Version: v2 (current)

Releases and upgrades for on-prem

TL;DR. PanDev Metrics ships new on-prem builds regularly. Upgrade by swapping the image tags in docker-compose.yml (or values.yaml for Helm), then pull and restart. Schema migrations run automatically on startup. The full per-release changelog with download links lives in Releases → Current release.

Check your current version​

Knowing your current version is the first step before any upgrade conversation.

With Docker Compose, the running image tags are the version:

terminal
docker compose images

Look at the tags for pandev-metrics-server and pandev-metrics-workspace. On Kubernetes:

terminal
helm list -n metrics
kubectl get deploy -n metrics -o jsonpath="{.items[*].spec.template.spec.containers[*].image}"

You can also find the version in the web UI footer once you sign in as an admin.

Where to find release notes​

Detailed release notes live in a dedicated documentation section, not in this page.

The detailed per-release changelog, with component versions and download URLs for every plugin, is published in a dedicated section of the documentation:

Each release entry lists:

  • Backend (pandev-metrics) and workspace (pandev-metrics-backoffice) versions and Docker tags
  • JetBrains, VS Code, Xcode, Visual Studio plugin versions
  • CLI and browser-extension versions
  • Bug fixes and new features

How to upgrade (Docker Compose)​

A standard Docker Compose upgrade is a four-step swap: back up, edit the tags, pull, restart.

Upgrades are non-destructive — your PostgreSQL data persists across versions in the postgres-data volume. Take a backup first regardless.

  1. Read the release notes for the target version.
  2. Back up PostgreSQL with pg_dump (see backups).
  3. Update the image tags in docker-compose.yml for both the server and the workspace (use the -arm tags on arm64 hosts):
docker-compose.yml
services:
  pandev-metrics-server:
    image: pandevofficial/pandev-metrics:<NEW_SERVER_VERSION>
  pandev-metrics-workspace:
    image: pandevofficial/pandev-metrics-backoffice:<NEW_WORKSPACE_VERSION>
  1. Pull and restart the stack:
terminal
docker compose pull
docker compose up -d
  1. Confirm the new tags with docker compose images and that the UI footer shows the new version.

Database migrations run automatically on startup.

How to upgrade (Kubernetes / Helm)​

For Helm deployments, change the image tags in values.yaml and run helm upgrade.

  1. Back up PostgreSQL.
  2. Update the image tags in values.yaml:
values.yaml
server:
  image:
    tag: <NEW_SERVER_VERSION>
workspace:
  image:
    tag: <NEW_WORKSPACE_VERSION>
  1. Apply, using the chart from the unpacked archive:
terminal
helm upgrade pandev-metrics ./helm-chart -n metrics -f values.yaml
  1. Watch the rollout:
terminal
kubectl rollout status deployment/pandev-metrics-server -n metrics

Backward compatibility​

We aim for forward-only upgrades: install a newer build, the schema migrates in place, and you're done. Downgrades are not supported once migrations have run — restore from a backup if you need to roll back. Plugins (IDE, browser, CLI) are version-tolerant within the same major; update them at your own pace.

FAQ​

Frequently asked questions about on-prem releases and upgrades.

How often do you release on-prem versions?​

PanDev Metrics releases regularly across backend and plugins. Cadence is not fixed — minor versions land every few weeks, patches as needed. Check All releases for the recent rhythm.

Do I need to upgrade plugins together with the backend?​

Not always. Plugins are version-tolerant — older plugins keep working with a newer backend within the same major version. To pick up new features (for example, AI activity tracking in the CLI), update the plugin from the version listed in the release notes.

Can I skip versions when upgrading?​

Yes. Migrations chain forward, so jumping from 4.5.x to 4.7.2 runs every intermediate migration in order. Take a backup first and read the notes for all skipped versions to spot breaking changes.

How do I roll back a bad upgrade?​

Stop the new containers, restore the PostgreSQL dump you took before the upgrade, then start the previous image tags. There's no in-place downgrade because schema migrations are forward-only.

Where do I download plugin builds?​

Direct links to JetBrains, VS Code, and Xcode bundles are published with every release entry — see Current release. Host the artifacts on your internal mirror if your developer workstations route IDE traffic through a restricted egress that cannot reach cdn.pandev.io.

Sideways reading for on-prem admins.