Files
proxmox/docs/01-getting-started/LIST_VMS_QUICK_START.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands
- CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround
- CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check
- NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere
- MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates
- LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-12 15:46:57 -08:00

1.5 KiB

Quick Start: List All Proxmox VMs

Last Updated: 2026-01-31
Document Version: 1.0
Status: Active Documentation


Quick Start (Python Script)

# 1. Install dependencies (if not already installed)
cd /home/intlc/projects/proxmox
source venv/bin/activate
pip install proxmoxer requests

# 2. Ensure ~/.env has Proxmox credentials
# (Should already be configured)

# 3. Run the script
python3 list_vms.py

Quick Start (Shell Script)

# 1. Set Proxmox host (or use default)
export PROXMOX_HOST=192.168.11.10
export PROXMOX_USER=root

# 2. Run the script
./list_vms.sh

Expected Output

VMID   | Name                    | Type | IP Address         | FQDN                    | Description
-------|-------------------------|------|-------------------|-------------------------|----------------
100    | vm-example              | QEMU | 192.168.1.100     | vm-example.local         | Example VM
101    | container-example       | LXC  | 192.168.1.101     | container.local         | Example container

Troubleshooting

Connection timeout?

  • Check: ping $(grep PROXMOX_HOST ~/.env | cut -d= -f2)
  • Verify firewall allows port 8006

Authentication failed?

  • Check credentials in ~/.env
  • Verify API token is valid

No IP addresses?

  • QEMU: Install QEMU guest agent in VM
  • LXC: Container must be running

Files

  • list_vms.py - Python script (recommended)
  • list_vms.sh - Shell script (requires SSH)
  • LIST_VMS_README.md - Full documentation