Repolode
Enviar
TimInTech

TimInTech/proxmox-manager

Single-file Bash TUI for listing, starting, stopping, snapshotting and monitoring Proxmox VE virtual machines and containers.

Alternativa open source a:Proxmox Web UI

Ver en GitHub
Estrellas
92
Forks
4
Issues abiertos
1
Último commit
hace 10 horas

¿Qué es?

proxmox-manager (command name pman) is a single Bash script that runs as root directly on a Proxmox VE node. It shows a table of all VMs and LXC containers with live status and offers action menus to start, stop, restart, open a console, manage snapshots, and retrieve SPICE connection files. It relies only on tools that ship with Proxmox, such as qm, pct and pvesh, and needs no daemon or agent.

Beyond the interactive interface, it provides scriptable commands with JSON output, status and name filters, and a configurable stop timeout. A health view reports CPU, memory and disk usage per guest. A cron-driven check sends alerts through ntfy or e-mail only when a problem appears, escalates, or resolves.

The project is MIT licensed and tested with a mocked unit test suite. It targets PVE 7, 8 and 9 and requires Bash 4.0 or newer.

Funciones clave

  • 01Lists all VMs and containers with running, stopped, paused or unknown status.
  • 02Start, stop and restart actions with confirmation prompts and a force-stop fallback.
  • 03Console access through pct enter for containers or qm terminal for VMs.
  • 04Snapshot list, create, rollback and delete with name validation.
  • 05SPICE .vv file generation, auto-launching virt-viewer when installed.
  • 06JSON output and filters for use in scripts and jq pipelines.
  • 07Health overview and cron-based alerts via ntfy or e-mail.

Casos de uso

  • Managing VMs and containers on a single homelab Proxmox node from the terminal.
  • Scripting status checks or unattended start and stop jobs with JSON output.
  • Getting notified by phone or e-mail when a guest runs out of CPU, memory or disk.
  • Opening consoles and SPICE sessions without using the web interface.

Temas

#proxmox#bash#virtualization#lxc#homelab#tui#snapshot#monitoring#automation#bash-script

Preguntas frecuentes

¿Qué es proxmox-manager?
Single-file Bash TUI for listing, starting, stopping, snapshotting and monitoring Proxmox VE virtual machines and containers. proxmox-manager (command name pman) is a single Bash script that runs as root directly on a Proxmox VE node. It shows a table of all VMs and LXC containers with live status and offers action menus to start, stop, restart, open a console, manage snapshots, and retrieve SPICE connection files. It relies only on tools that ship with Proxmox, such as qm, pct and pvesh, and needs no daemon or agent.
¿proxmox-manager es gratuito? ¿Qué licencia tiene?
proxmox-manager es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿proxmox-manager sigue mantenido?
Mantenimiento activo. El último commit de proxmox-manager fue el 19 oct 2026.
¿Para qué puedo usar proxmox-manager?
Managing VMs and containers on a single homelab Proxmox node from the terminal. Scripting status checks or unattended start and stop jobs with JSON output. Getting notified by phone or e-mail when a guest runs out of CPU, memory or disk. Opening consoles and SPICE sessions without using the web interface.
¿Dónde consigo proxmox-manager?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/TimInTech/proxmox-manager

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados