Introduction

Introduction~5 min

ProxMenux is an open-source, menu-driven tool for Proxmox VE. Two pieces share the same project: a CLI/TUI that wraps the most common host, VM, container, storage, network and security workflows; and a self-hosted web dashboard with proactive health monitoring, notifications, an AI rewrite hook and a REST API.

One menu, every workflow. Everything that normally takes a tab open to the wiki, two forum threads and a copy-pasted command sequence — exposed as a numbered option you can run in seconds.

Built for first-time Proxmox users (safe, opinionated defaults) and experienced admins (fewer keystrokes for tasks they've done a hundred times). Free and open source under an active community on GitHub.

Two products, one project

ProxMenux ships as two independent pieces sharing the same source tree. The installer deploys both — they live side by side on the host and don't depend on each other:

ProxMenux Scripts

The original CLI/TUI you launch with menu. Nine functional areas covering post-install optimizations, VM and LXC creation, GPU and Coral TPU passthrough, disks, storage, network, security, utilities, plus a curated commands reference. Runs in any terminal — local, SSH or web.

ProxMenux Monitor

Self-hosted web dashboard (AppImage). Real-time host metrics, a proactive Health Monitor, notifications, an optional AI rewrite hook (six providers), an integrated web terminal and a REST API. Enable from the Scripts menu (Settings → ProxMenux Monitor).

What ProxMenux acts on

Three layers, all reachable from the same project:

The Proxmox host — repos, packages, network, ZFS, Ceph, kernel, observability.
Virtual machines (VMs) — creation, GPU passthrough, OVA / OVF import / export, disk passthrough.
LXC containers — creation, mount points, GPU / TPU passthrough, NFS / Samba clients and servers.

ProxMenux Scripts — what you get

Nine functional areas, each with its own menu inside menu and a detail page in the documentation. Click any card to jump straight to that section's overview.

Post-Install

Optimizations for a freshly installed Proxmox setup: repos, kernel, time sync, basic security, performance, with reversible options.

GPUs & Coral TPU

NVIDIA, Intel iGPU, AMD and Coral TPU passthrough to VMs and LXC containers, with mode switching between VM and LXC.

Create VM

Wizards for NAS systems, Windows and Linux — with sensible defaults for hardware, storage and network.

Disk Manager

Import physical disks to VMs and LXC, format and wipe, SMART tests, qcow2 / vmdk / vdi image import — from a menu.

Storage & Share

Register NFS, Samba (CIFS), iSCSI and local storage in Proxmox; share folders between host and LXC containers via bind mounts or network protocols.

Network

Read-only diagnostics, analyze-then-suggest workflows and guided repairs for /etc/network/interfaces. Mandatory backups before any change.

Security

Fail2Ban (intrusion prevention for SSH and the web UIs) and Lynis (hardening audit) — install and manage with sensible defaults.

Utilities

Build Windows ISOs from UUP Dump, install CLI tools, run a safe system update, perform PVE 8 → 9 upgrade, export and import OVA / OVF VMs.

Commands Reference

Curated catalogue of Linux and Proxmox commands organised by topic — system, VM/CT (qm, pct), storage, network, ZFS, GPU passthrough, backup, day-to-day CLI tools.

ProxMenux Monitor — what you get

The web dashboard product. Self-hosted on the Proxmox host on TCP 8008. Click any card to jump straight to that section's page, or read the Monitor overview first.

Health Monitor

Ten categories scanned every 5 minutes (CPU, memory, storage, disks/SMART, network, VMs, services, logs, updates, security) with severity levels and per-category suppression.

Notifications

Telegram, Discord, Email, Gotify and Apprise (multi-channel) — with deduplication, cooldown, burst aggregation, quiet hours and a complete history.

AI Assistant

Optional rewrite of notifications in plain language. Six providers: OpenAI, Anthropic Claude, Google Gemini, Groq, OpenRouter, local Ollama. Twelve languages.

Web Terminal

Browser-based interactive shell on the Proxmox host plus a separate ProxMenux Scripts terminal that runs the menu through the web UI.

REST API

HTTP endpoints for system, health, storage / SMART, network, VMs, notifications and security — useful for Homepage, Home Assistant, Prometheus or custom scripts.

Integrations

Native Proxmox VE webhook, Prometheus scrape, Uptime Kuma probe, Homepage / Home Assistant / Glance widgets, n8n / Zapier flows, Tailscale Secure Gateway.

Install paths

The installer deploys Scripts and Monitor in one go. Scripts has two flavours — translation or lightweight — and the Monitor is installed as a standalone AppImage you enable from the menu later:

Install path	What it bundles
Scripts: Translation	CLI/TUI + Python venv + googletrans (English, Spanish, French, German, Italian, Portuguese)
Scripts: Normal (lightweight)	CLI/TUI English-only, smaller footprint, no Python venv
Monitor	Self-contained AppImage on TCP 8008. Independent install — can be enabled from the Scripts menu, or run the AppImage directly.

Detailed install commands and prerequisites are on the Installation page.

Always check what scripts you run from the internet

ProxMenux is open source and every script is reviewable on GitHub. Before running the install command, look at the source. Do the same with any other automation tool. View ProxMenux source · Code of Conduct

Where to go next

New to ProxMenux? Install it in one command and run menu.
Just installed Proxmox? Start with the Post-Install Script.
Want a web dashboard? ProxMenux Monitor covers what it shows, how it's built and how to secure it.
Looking for a specific command? Commands Reference is a curated catalog organised by topic, with copy buttons.
Want longer how-to guides? The Guides section covers Coral TPU, NVIDIA passthrough, Kodi LXC and more.

Installation