Proxmox Configuration

From ProxCP Documentation
Revision as of 17:30, 11 December 2018 by Proxcp (talk | contribs)

Required Proxmox Configuration

ProxCP requires Proxmox VE 5.2 or above

  • Proxmox clusters are not supported at this time
  • Ensure BIOS options are enabled to support KVM/QEMU/hardware virtualization
  • If you have more than 1 Proxmox node, it is expected that you have a shared storage location for LXC templates and KVM ISO files (such as NFS)
    • ProxCP assumes that all LXC templates and KVM ISO files are available on all Proxmox nodes
Example NFS storage for LXC templates and KVM ISOs
  • If you want to enable VPS backups in ProxCP, ensure the "Max Backups" setting for the storage location in Proxmox is set correctly
  • If you want to enable per-VPS firewall management in ProxCP, ensure the "Firewall" option is enabled in Proxmox under Datacenter > Firewall > Options tab
    • Global input policy and output policy should be ACCEPT

Recommended Proxmox Configuration

  • ProxCP requires Proxmox login credentials to be saved. It is highly recommended to create a new user and to not use the root user.
    • This new user should use the "Proxmox VE authentication server" (pve) realm
    • Once created, your new pve user should have the PVEAdmin role
Example PVE user with PVEAdmin role
  • If you have multiple Proxmox nodes and have backups enabled in ProxCP...
    • Proxmox VMIDs need to be unique across your infrastructure. One way to do this is to assign VMID ranges to each Proxmox node by creating a small, fake VPS with the beginning of the VMID range.
      • Example: you have 3 Proxmox nodes (node1, node2, node3)
      • You assign a VMID range to each node as follows: node1 1000 - 2999, node2 3000 - 4999, node3 5000 - 6999
      • To enforce these ranges in Proxmox, node1 would have a small, fake VPS with VMID 1000, node2 would have the same thing with VMID 3000, and node3 would have the same thing with VMID 5000
      • This works because Proxmox determines the next VMID by incrementing the largest present VMID by 1
    • This is required because Proxmox backups are saved and named according to VMID only