Proxmox

Proxmox VM ID Conventions

Overview

• 1-99: Reserved for cluster/system use
• 100-999: Production VMs
• 1000-1999: Templates
• 2000-2999: Development/Test VMs
• 9000-9999: Temporary/Clone VMs

Production VMs (100-999)

Infrastructure Services (100-199)

• 100-109: DNS/DHCP
• 110-119: Authentication/Directory (LDAP, AD)
• 120-129: Monitoring/Logging
• 130-139: Build/CI Services
• 140-149: Backup Services
• 150-159: Storage Services
• 160-169: Network Services
• 170-179: Security Services
• 180-189: Management Tools
• 190-199: Other Infrastructure

Applications (200-399)

• 200-219: Web Services
• 220-239: Database Servers
• 240-259: Mail Services
• 260-279: Media Services
• 280-299: Home Automation
• 300-319: Documentation/Wiki
• 320-339: Communication Services
• 340-359: File Sharing
• 360-379: Development Tools
• 380-399: Other Applications

Container Platforms (400-499)

• 400-419: Kubernetes Nodes
• 420-439: Docker Hosts
• 440-459: Container Management
• 460-479: Container Registry
• 480-499: Other Container Services

Storage Solutions (500-599)

• 500-519: Primary Storage
• 520-539: Backup Storage
• 540-559: Archive Storage
• 560-579: Object Storage
• 580-599: Other Storage

Network Services (600-699)

• 600-619: Firewalls/Routers
• 620-639: VPN Services
• 640-659: Load Balancers
• 660-679: Proxy Services
• 680-699: Other Network Services

Special Purpose (700-899)

• 700-749: Analytics/Metrics
• 750-799: AI/ML Services
• 800-849: IoT Services
• 850-899: Custom Solutions

Reserved (900-999)

• 900-999: Future Use/Expansion

Templates (1000-1999)

• 1000-1099: Linux Distribution Templates
• 1100-1199: Windows Templates
• 1200-1299: Application Templates
• 1300-1399: Container Templates
• 1400-1499: Custom Templates
• 1500-1999: Reserved for Future Templates

Development/Test (2000-2999)

• 2000-2199: Development Environment
• 2200-2399: Testing Environment
• 2400-2599: Staging Environment
• 2600-2799: QA Environment
• 2800-2999: Experimental VMs

Temporary VMs (9000-9999)

• 9000-9499: Clones
• 9500-9699: Testing
• 9700-9899: Temporary Workloads
• 9900-9999: Emergency/Recovery

Notes

• Leave gaps between used IDs for future expansion
• Critical infrastructure VMs (like storage, backup) should maintain existing IDs if already established
• Document any deviations from this scheme
• Consider using tags in addition to ID ranges for better organization

VM Naming Convention

Format

{purpose}-{nn}

Example: dns-01, k8s-01, db-01

Purpose Prefixes

Infrastructure

• dns: DNS Servers
• dhcp: DHCP Services
• fw: Firewalls
• proxy: Reverse Proxies
• mon: Monitoring Services
• backup: Backup Services
• nfs: File Servers
• git: Git Servers
• ldap: Directory Services
• vpn: VPN Services
• build: Build Servers/CI

Applications

• web: Web Servers
• app: Application Servers
• db: Database Servers
• cache: Caching Services
• mail: Mail Servers
• ci: CI/CD Services
• docker: Docker Hosts
• k8s: Kubernetes Nodes
• mqtt: Message Brokers

Storage

• nas: Network Attached Storage
• san: Storage Area Network
• store: General Storage
• archive: Archive Storage

Media/Home

• plex: Media Servers
• ha: Home Assistant
• cam: Camera/Surveillance
• media: Media Services
• pi: Pi-hole/DNS Filtering

Numbering

• Two-digit number starting with 01
• Example: web:01, web:02

Best Practices

1. Use lowercase only
2. No special characters except colon (:)
3. Keep names short but meaningful
4. Be consistent with abbreviations
5. Document any exceptions
6. Use sequential numbering

Examples

# Infrastructure
dns-01     # Primary DNS
proxy-01   # Main reverse proxy
build-01   # Build server

# Applications
web-01     # Primary web server
db-01      # Main database
app-01     # Application server

# Storage
nas-01     # Primary NAS
store-01   # General storage

# Media/Home
plex-01    # Media server
ha-01      # Home Assistant

Notes

• Names should be easily identifiable
• Purpose should be clear from the name
• Numbers allow for multiple instances
• Avoid environment prefixes unless needed (dev/prod)
• Consider DNS implications when naming
• Keep consistent across documentation and configurations