|
1 | | -# Proxmox VE Port package source |
| 1 | +# PXVIRT (Formerly Proxmox-Port) |
2 | 2 |
|
3 | | -## How to Build |
| 3 | +A fork of Proxmox VE for ARM and LoongArch architectures |
| 4 | +AGPL-3.0 Licensed | Community-Driven Project |
4 | 5 |
|
5 | | -### Initializing the build host |
6 | | -We need Debian 12 for this code |
| 6 | +## 📖 Overview |
7 | 7 |
|
8 | | -```bash |
9 | | -apt update |
10 | | -apt install quilt docker.io -y |
11 | | -cd docker |
12 | | -docker build -t pvebuilder -f dockerfile.arm64 . |
13 | | -``` |
| 8 | +PXVIRT is an open-source virtualization platform derived from Proxmox VE, specifically adapted to support ARM and LoongArch architectures. This project originally began as "Proxmox-Port" and has now evolved into a fully independent fork under the new name PXVIRT. |
14 | 9 |
|
15 | | -### Build via Docker |
| 10 | +## 🚀 Why PXVIRT? |
16 | 11 |
|
17 | | -```bash |
18 | | -bash build.sh pve-common |
19 | | -``` |
| 12 | +### Historical Context |
20 | 13 |
|
21 | | -The built package will be under /tmp/pve-common |
| 14 | +Original Mission: The project started as "Proxmox-Port" to port Proxmox VE to non-x86 architectures. |
| 15 | +Rebranding: Due to trademark restrictions ("Proxmox" is a registered trademark of Proxmox Server Solutions GmbH), we renamed the project to PXVIRT to comply with legal requirements while preserving its core purpose. |
22 | 16 |
|
23 | 17 |
|
24 | | -### Custom Docker Image |
| 18 | +### Technical Value |
25 | 19 |
|
26 | | -```bash |
27 | | -BUILDERNAME=dockerpull.com/pvebuilder:20241101 bash build.sh pve-common |
28 | | -``` |
| 20 | +- 🖥️ Multi-Arch Support: Brings Proxmox VE's powerful virtualization tools to ARM64 and LoongArch platforms.We also provide x86 versions of the software to achieve compatibility among three different architectures within the same cluster. |
29 | 21 |
|
| 22 | +- 🔄 Upstream Sync: Maintains compatibility with Proxmox VE upstream features while adding architecture-specific optimizations. |
30 | 23 |
|
31 | | -### proxmox-backup-restore-images |
| 24 | +- 📜 License Compliance: Fully open-source under AGPLv3, respecting upstream licensing terms. |
32 | 25 |
|
33 | | -This package will pull in the kernel and ZFS packages, which can cause failures if the network is slow, so an additional `submodule.list` check has been added. |
| 26 | +- 🔄 Migration Notice: Proxmox-Port → PXVIRT |
34 | 27 |
|
35 | | -If the file exists, it will use the submodules listed in the file, with the file format referencing the `packages/proxmox-backup-restore-image/autobuild.sh` file. |
| 28 | + |
| 29 | +Proxmox-Port is now deprecated and will no longer receive updates. |
| 30 | +All future development will focus on PXVIRT. Users are strongly advised to: |
| 31 | + |
| 32 | +Migrate to PXVIRT for continued support |
| 33 | +Benefit from upstream feature synchronization |
| 34 | +Receive ARM/LoongArch-specific improvements |
| 35 | + |
| 36 | +### 🛠️ Features |
| 37 | + |
| 38 | +Full virtualization stack for ARM/LoongArch servers |
| 39 | +Web-based management interface |
| 40 | +Container and KVM virtualization support |
| 41 | +Storage management integration |
| 42 | +Network configuration tools |
| 43 | +Note: Features are inherited from Proxmox VE and extended for target architectures. |
| 44 | + |
| 45 | +## ⚙️ Installation & Documentation |
| 46 | + |
| 47 | +For installation instructions and documentation, please refer to: |
| 48 | + |
| 49 | +PXVIRT Documentation ([Simple Chinese only](https://docs.pxvirt.lierfang.com)) |
| 50 | + |
| 51 | +## ⚖️ Legal Disclaimer |
| 52 | + |
| 53 | +PXVIRT is not affiliated with Proxmox Server Solutions GmbH |
| 54 | +Proxmox® is a registered trademark of Proxmox Server Solutions GmbH |
| 55 | +Original Proxmox VE code is licensed under AGPLv3 |
| 56 | +PXVIRT exists to expand virtualization accessibility, not replace Proxmox VE. Consider supporting both projects where appropriate. |
0 commit comments