proxmox-manager
- title
- proxmox-manager
- type
- toolbox
- summary
- Single Bash script wrapping qm and pct into an interactive TUI for one Proxmox node
- tags
- bash, proxmox, tui, homelab
- language
- Shell
- license
- MIT
- created
- 2026-04-06
- updated
- 2026-07-22
A single Bash script that wraps Proxmox CLI tools (qm, pct) into an interactive TUI menu. No daemons, no agents, no dependencies beyond what ships with Proxmox VE. Runs on the host, manages the local node only.
What it does:
- Lists all VMs and containers with status indicators (
[+]running,[-]stopped,[~]paused) - Start, stop, restart with confirmation prompts for destructive actions
- Open console (LXC shell or QEMU terminal)
- Snapshot management: list, create, rollback, delete
- SPICE connection details for VMs
- Machine-readable JSON and plain-text output modes for scripting
Usage:
pman # interactive TUI
pman --list # plain-text table
pman --json # JSON output for automation
In interactive mode, enter a VMID to get an action menu. r to refresh, q to quit.
Install: clone the repo onto a Proxmox host, chmod +x, optionally run install_dependencies.sh to get a pman symlink in /usr/local/bin/. No Python, no Docker, no external APIs. Requires root (or PROXMOX_MANAGER_ALLOW_NONROOT=1 for CI).
Tested on Proxmox VE 7.x, 8.x, and 9.x.
perfmon is the same shape pointed at diagnostics instead of lifecycle: a TUI whose tabs are just shell commands (top, vmstat, ss) on a refresh interval, so it never has to learn anything the CLI already knows. Both stay useful because the underlying commands, not the wrapper, hold the knowledge.
Repo: https://github.com/TimInTech/proxmox-manager โ 22 stars, MIT license.