System requirements for PanDev Metrics on-prem
PanDev Metrics on-prem runs on two Linux hosts: an application host for backend and frontend, plus a dedicated database host for PostgreSQL 17. This page lists the minimum and recommended hardware, supported operating systems, and required software versions.
At a glance
| Property | Value |
|---|---|
| Topology | Two hosts: application + database |
| Deployment options | Docker Compose or Kubernetes |
| OS family | Linux (x86_64) |
| Database | PostgreSQL 17 |
| Default backend port | 8080 |
| Actuator port | 9090 |
Hardware
PanDev Metrics on-prem benefits from running the database on its own machine. The application host stays small and stateless; the database host carries CPU, memory, and disk pressure.
Application host (backend + frontend)
| Component | Minimum | Recommended |
|---|---|---|
| CPU | 4 cores | 8 cores |
| RAM | 8 GB | 16 GB |
| Disk | 30 GB | 50 GB SSD |
Database host (PostgreSQL 17)
| Component | Minimum | Recommended |
|---|---|---|
| CPU | 8 cores | 16 cores |
| RAM | 12 GB | 24 GB |
| Disk | 50 GB | 100 GB SSD |
Disk growth scales with the number of engineers, integrations, and retention. Plan for additional capacity if you connect Jira, multiple Git providers, and large IDE plugin populations.
CPU instruction requirements
PanDev Metrics requires modern x86_64 instructions. The host CPU (and any virtualization layer in front of it) must expose:
CX8, CMOV, FXSR, MMX, SSE, SSE2, SSE3, SSSE3,
SSE4_1, SSE4_2, POPCNT, LZCNT, AVX, AVX2, BMI1, BMI2, FMA
Verify on a candidate host:
lscpu | grep -E "avx|avx2|fma|sse4"
ARM processors (including Apple Silicon) are not supported. Run the application host on x86_64 hardware or x86_64 virtual machines.
Virtualization settings
If PanDev Metrics fails to start on a virtual machine, the hypervisor is most likely masking required CPU instructions. Match your platform to the configuration below.
| Platform | Setting |
|---|---|
| Proxmox VE | cpu: host in VM config |
| VMware ESXi | VM compatibility 7.0+, CPU passthrough |
| VirtualBox | Enable VT-x, Nested VT-x, PAE/NX. Run VBoxManage modifyvm "VM" --cpu-profile host |
| Hyper-V | VM generation 2, disable CPU compatibility mode |
| XCP-ng / XenServer | CPU mode host-passthrough |
| QEMU / KVM | -cpu host or explicit flags +avx2,+fma,+bmi2 |
Operating system
PanDev Metrics on-prem runs on any current Linux distribution that ships a supported Docker Engine.
| Distribution | Tested versions |
|---|---|
| Ubuntu Server | 22.04 LTS, 24.04 LTS |
| Debian | 11 (bullseye), 12 (bookworm) |
| RHEL / Rocky / AlmaLinux | 8, 9 |
| SUSE Linux Enterprise Server | 15 SP4+ |
Other Linux distributions that meet the kernel and Docker requirements also work. Windows Server and macOS are not supported.
Software
| Component | Required |
|---|---|
| PostgreSQL | 17 |
| Docker Engine | ≥ 20.10 |
| Docker Compose | ≥ v2.0 (v2.20+ recommended) |
| Kubernetes | ≥ 1.28 |
PostgreSQL 17 is the only supported database version. Earlier major versions are not tested. Redis 7 is optional: in single-node on-prem it isn't needed — the backend caches sessions and rate-limit counters in-memory. Add Redis only if you want to scale sessions horizontally or externalise rate-limit state from the instance.
Network
Inbound and outbound network requirements are documented separately in Network and ports. Summary:
- Public inbound on 8080 (or behind a reverse proxy on 443)
- Internal inbound on 9090 for actuator health and metrics
- Internal PostgreSQL on 5432 (Redis on 6379 — only if it is deployed)
- Outbound HTTPS to your configured Git provider and task tracker (egress is minimal and cannot be disabled)
Browser support
The PanDev Metrics frontend is a modern single-page React application. Recent versions of Chrome, Edge, Firefox, and Safari are supported. The team targets the latest two major releases of each browser.
Constraints and edge cases
- Single organization per installation. On-prem does not support multi-tenant separation. One install equals one organization.
- No air-gapped deployment. Minimal outbound network access is required for integrations.
- Horizontal scaling of the backend is not part of the on-prem distribution. Run a single backend instance per installation; vertical scaling via larger hosts is the supported path.
Related
- How-to: Install PanDev Metrics on-prem
- Reference: Network and ports
- Concept: On-prem architecture