Fork of PXVIRT (Proxmox VE port for ARM/LoongArch) - internal continued development
Find a file
Sebastiaan Koetsier cedfdd9e28
All checks were successful
Audit submodule pins / audit (push) Successful in 11s
Record vncterm/novnc-pve/pve-firewall/proxmox-biome as audited (track master deliberately)
Verified stable-bookworm for all four is an older release than what's
already pinned and published, so switching would be a functional
downgrade for no benefit. Declaring branch=master + a per-package
.expected-distro override records the decision instead of leaving them
looking unaudited.
2026-08-22 14:31:47 +02:00
.forgejo/workflows Fix build.sh duplication, pin-audit script + CI, dry-run install check, tolerant Dockerfile, gitignore/gitattributes 2026-08-22 14:27:56 +02:00
.github/ISSUE_TEMPLATE Delete .github/FUNDING.yml 2024-06-24 11:15:26 +08:00
docker Fix build.sh duplication, pin-audit script + CI, dry-run install check, tolerant Dockerfile, gitignore/gitattributes 2026-08-22 14:27:56 +02:00
docs-archive Archive upstream PXVIRT docs site (docs.pxvirt.lierfang.com) 2026-08-20 16:03:34 +02:00
packages Record vncterm/novnc-pve/pve-firewall/proxmox-biome as audited (track master deliberately) 2026-08-22 14:31:47 +02:00
scripts Record vncterm/novnc-pve/pve-firewall/proxmox-biome as audited (track master deliberately) 2026-08-22 14:31:47 +02:00
.gitattributes Fix build.sh duplication, pin-audit script + CI, dry-run install check, tolerant Dockerfile, gitignore/gitattributes 2026-08-22 14:27:56 +02:00
.gitignore Fix build.sh duplication, pin-audit script + CI, dry-run install check, tolerant Dockerfile, gitignore/gitattributes 2026-08-22 14:27:56 +02:00
.gitmodules Record vncterm/novnc-pve/pve-firewall/proxmox-biome as audited (track master deliberately) 2026-08-22 14:31:47 +02:00
build.sh Fix build.sh duplication, pin-audit script + CI, dry-run install check, tolerant Dockerfile, gitignore/gitattributes 2026-08-22 14:27:56 +02:00
LICENSE Create LICENSE 2023-11-23 20:54:22 +08:00
README.md Rewrite README for the continuation fork 2026-08-21 09:11:00 +02:00

PXVIRT

A fork of Proxmox VE for ARM64 and LoongArch architectures, AGPL-3.0 licensed.

About this fork

This is a private continuation of jiangcuo/pxvirt (formerly "Proxmox-Port"), picked up because upstream announced it is winding down distribution of its deb files and ISO images. We run PXVIRT in production on piprox (a Raspberry Pi) and depend on it, so we mirror the upstream documentation, keep building packages, and publish them to our own repository below.

Upstream's own documentation has been archived under docs-archive/ in case it disappears, and the current working copy lives on the wiki.

What PXVIRT is

PXVIRT is a derivative of Proxmox VE that adds ARM64 and LoongArch support (with x86 builds kept for mixed-architecture clusters). It started as "Proxmox-Port"; the project was renamed to PXVIRT because "Proxmox" is a registered trademark of Proxmox Server Solutions GmbH. It inherits the full Proxmox VE feature set (web UI, KVM/LXC virtualization, storage and network management) with architecture-specific patches.

Using our Debian package repository

Packages built from this repository (CI builds packages/<name> and publishes the resulting .deb) are published to a Debian repository hosted on this Forgejo instance.

Add the repository and its signing key:

curl -fsSL https://code.koetsier.org/api/packages/sebas/debian/repository.key \
  | gpg --dearmor -o /etc/apt/trusted.gpg.d/pxvirt-koetsier.gpg

echo "deb https://code.koetsier.org/api/packages/sebas/debian bookworm main" \
  > /etc/apt/sources.list.d/pxvirt-koetsier.list

apt update

Packages will then show up as upgrade candidates alongside (and taking priority over, by version) the upstream PXVIRT repository. This repository only carries packages we've explicitly rebuilt from this repo — it is not a mirror of the full PXVIRT package set, so keep upstream's repository configured as well for anything we haven't rebuilt.

Building packages

./build.sh <package-name>

builds packages/<package-name> in a Docker container (docker/dockerfile.arm64 for arm64) and drops the resulting .deb/.dsc/.changes files under /tmp/2022/<package-name> (override with PKG_DIR). CI (.forgejo/workflows/build-packages.yml) runs the same script on a native arm64 runner and publishes the output to the Debian repository above.

  • PXVIRT is not affiliated with Proxmox Server Solutions GmbH.
  • Proxmox® is a registered trademark of Proxmox Server Solutions GmbH.
  • Original Proxmox VE code is licensed under AGPLv3.