TimInTech/proxmox-manager

What is it?

Key features

• 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.

Use cases

• 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.

Quick start

1. 1

   Clone the repository

   git clone https://github.com/TimInTech/proxmox-manager.git
2. 2

   Enter the project directory

   cd proxmox-manager
3. 3

   Make the script executable and run it as root on the Proxmox node

   chmod +x proxmox-manager.sh && ./proxmox-manager.sh

Things to know

• !Must run as root directly on a Proxmox VE host; it needs the qm, pct and pvesh tools.
• !Works only on Proxmox VE 7, 8 and 9 and manages only the local node.
• !Optional e-mail alerts require a local sendmail setup such as postfix.

Topics

FAQ

What is 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.

Is proxmox-manager free to use? What license does it have?

proxmox-manager is open source under the MIT license. Check the license terms before using it in commercial products.

Is proxmox-manager still maintained?

Actively maintained. The last commit to proxmox-manager was on Oct 19, 2026.

What can I use proxmox-manager for?

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.

How do I install proxmox-manager?

Clone the repository: git clone https://github.com/TimInTech/proxmox-manager.git Enter the project directory: cd proxmox-manager Make the script executable and run it as root on the Proxmox node: chmod +x proxmox-manager.sh && ./proxmox-manager.sh

Where can I get proxmox-manager?

The source code and installation instructions are on GitHub: https://github.com/TimInTech/proxmox-manager