Proxmox VE (Virtual Environment) Comprehensive Cheatsheet

1. Installation and Initial Setup

Minimum Requirements

64-bit x86 CPU with virtualization support (Intel VT-x or AMD-V)
4GB RAM (minimum), 8GB+ recommended
20GB disk space for Proxmox installation
Ethernet network interface

Installation Methods

Download ISO from https://www.proxmox.com/en/downloads
Create bootable USB with Rufus or Etcher
Boot from USB and begin installation

Post-Installation Initial Configuration

Bash

1
2
3
4
5
6
7
8
9
10
11
12
# Update system repositories
apt update && apt upgrade -y

# Remove enterprise repository (optional)
rm /etc/apt/sources.list.d/pve-enterprise.list

# Add public repository
echo "deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription" > /etc/apt/sources.list.d/pve-public.list

# Install recommended packages
apt install -y pve-headers pve-firmware

Accessing Web Interface

Default Port: https://[SERVER_IP]:8006
Initial Credentials: root@pam
Best Practice: Create separate admin account immediately

Web Interface Key Sections

Datacenter: Cluster-wide management
Nodes: Individual server resources
Virtual Machines (VMs): VM management
Containers (LXC): Container management
Storage: Storage configuration
Access Control: User and permission management

3. Node and Cluster Management

Node Status Commands

Bash

1
2
3
4
5
6
7
8
9
10
11
12
# Check node status
pvesh get /nodes

# View cluster status
pvecm status

# Join existing cluster
pvecm join [MASTER_NODE_IP]

# Create new cluster
pvecm create [CLUSTER_NAME]

Cluster Configuration

Minimum 3 nodes recommended for high availability
Ensure identical hardware/configuration
Use dedicated network for cluster communication
Enable corosync and pacemaker services

4. Virtual Machine Creation and Configuration

Create VM via CLI

Bash

1
2
3
4
5
6
7
8
9
10
11
# Basic VM creation
qm create 100 \
  --name ubuntu-server \
  --memory 2048 \
  --cores 2 \
  --net0 virtio,bridge=vmbr0

# Install from ISO
qm set 100 --ide2 local:iso/ubuntu-22.04.iso,media=cdrom
qm start 100

VM Management Commands

Bash

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# List VMs
qm list

# Stop VM
qm stop 100

# Restart VM
qm restart 100

# Clone VM
qm clone 100 --name ubuntu-server-clone

# Delete VM
qm destroy 100

5. Container (LXC) Management

Create LXC Container

Bash

1
2
3
4
5
6
7
# Create Ubuntu container
pct create 200 \
  local:vztmpl/ubuntu-22.04-standard_22.04-1_amd64.tar.zst \
  --hostname webserver \
  --memory 1024 \
  --net0 name=eth0,bridge=vmbr0,ip=dhcp

Container Commands

Bash

1
2
3
4
5
6
7
8
9
10
11
12
# List containers
pct list

# Start container
pct start 200

# Stop container
pct stop 200

# Execute command inside container
pct exec 200 -- apt update

6. Storage Configuration

Storage Types

Local: Direct-attached storage
NFS: Network File System
CIFS: Windows Share
Ceph: Distributed storage
ZFS: Advanced filesystem with snapshots

Configure Local Storage

Bash

1
2
3
4
5
# Add directory-based storage
pvesm add directory local-backup \
  --path /backup \
  --content backup

NFS Storage Setup

Bash

1
2
3
4
5
6
7
# Add NFS storage
pvesm add nfs nfs-storage \
  --server 192.168.1.100 \
  --export /volume/backup \
  --path /mnt/nfs-backup \
  --content backup,images

7. Network Configuration

Bridge Configuration

Bash

1
2
3
4
5
6
7
# Create bridge
ip link add name vmbr1 type bridge
ip link set vmbr1 up

# Add physical interface to bridge
ip link set eth1 master vmbr1

VLAN Configuration

Bash

1
2
3
4
# Create VLAN bridge
ip link add link eth0 name vmbr0.10 type vlan id 10
ip addr add 192.168.10.1/24 dev vmbr0.10

8. Backup and Restore Operations

Backup VM/Container

Bash

1
2
3
4
5
6
7
8
9
# Backup VM
qm backup 100 --mode stop

# Backup Container
pct backup 200

# Restore VM
qm restore 100 /path/to/backup.vma

9. High Availability (HA) Setup

HA Configuration Steps

Ensure cluster is configured
Enable HA on selected resources
Set restart policy
Configure fencing mechanisms

Bash

1
2
3
# Enable HA for VM
qm set 100 --hastate enabled

10. User Management and Permissions

Create User

Bash

1
2
3
4
5
6
7
8
9
10
# Add user
pveum useradd admin@pve \
  -comment "Admin User" \
  -password

# Set permissions
pveum setPerm /path/to/resource \
  -user admin@pve \
  -role Administrator

11. Firewall Configuration

Basic Firewall Rules

Bash

1
2
3
4
5
6
7
8
9
10
# Enable firewall
pvesh create /nodes/[NODE]/firewall/options \
  -enable 1

# Add firewall rule
pvesh create /nodes/[NODE]/firewall/rules \
  -action ACCEPT \
  -dport 22 \
  -proto tcp

12. Templates and Cloud-Init

Create Template

Bash

1
2
3
4
5
6
# Convert VM to template
qm template 100

# Deploy from template
qm clone 100 200 --name new-vm

13. Migration Techniques

Live Migration

Bash

1
2
3
4
5
6
# Migrate VM between nodes
qm migrate 100 [TARGET_NODE]

# Online migration
qm migrate 100 [TARGET_NODE] --online

14. Monitoring and Alerts

Performance Monitoring

Bash

1
2
3
4
5
6
# Check resource usage
pveperf

# View realtime stats
pvesh get /nodes/[NODE]/status

15. Command-Line Tools

Key CLI Tools

qm: VM management
pct: Container management
pvesh: Proxmox shell API
pvecm: Cluster management
pvesm: Storage management

16. API Usage and Automation

API Access

REST API at https://[SERVER]:8006/api2/json
Use API tokens for scripting
Python libraries: proxmoxer

17. Ceph Integration

Basic Ceph Setup

Bash

1
2
3
4
5
6
# Install Ceph on cluster
pveceph install

# Create Ceph pool
pveceph pool create vmdata

18. Performance Optimization

Recommended Optimizations

Use virtio drivers
Enable KSM (Kernel Samepage Merging)
Use SSD for storage
Configure IOMMU for passthrough
Tune CPU governor

19. Troubleshooting

Common Issues

Check journal logs: journalctl -xe
Verify services: systemctl status proxmox-ve
Network troubleshooting: ip addr, bridge show

20. Production Best Practices

Regular backups
Separate management network
Use templates
Implement HA
Monitor resource usage
Keep updated
Use role-based access control
Secure web interface
Configure monitoring
Plan for scalability

Note: Always refer to the official Proxmox documentation for the most up-to-date information.

Proxmox VE

Continue Learning