Frequently Asked Questions
Common questions about ProxMenux: what it is, who it's for, how to install / update / uninstall, compatibility, customisation, security and contributing. If your question isn't here, check the GitHub Discussions or open an issue.
Quick links
- Installation — the one-line install command + dependencies.
- Introduction — what ProxMenux does, in 5 minutes.
- Uninstall — clean removal.
- GitHub Issues · Discussions
What is ProxMenux, and what is it used for?
ProxMenux is an interactive menu-driven tool designed to make Proxmox VE accessible to all users, regardless of their technical experience. It simplifies command execution, allowing users to perform actions on their system without requiring advanced Linux knowledge.
For less experienced users, ProxMenux provides an intuitive way to run commands through a structured menu interface, reducing the need for manual terminal input. For seasoned admins, it cuts keystrokes for repetitive workflows (post-install hardening, GPU passthrough, OVF VM imports, ZFS snapshot rotations).
Proxmox VE is widely used for:
- Enterprise-grade virtualization
- HomeLab and personal cloud solutions
- Multimedia servers, automation, and more
How do I install ProxMenux?
Follow the Installation Guide. In short:
bash -c "$(wget -qLO - https://raw.githubusercontent.com/MacRimi/ProxMenux/main/install_proxmenux.sh)"
Once installed, simply start it with:
menu
Is ProxMenux compatible with all Proxmox versions?
No — ProxMenux requires Proxmox VE 8 or later. PVE 7 and earlier are not supported. If you're still on PVE 7, follow the official Proxmox upgrade procedure to 8.x first; ProxMenux can then handle the 8 → 9 jump for you via Utilities → Upgrade PVE 8 to PVE 9.
How do I update ProxMenux?
When a new version is available, ProxMenux detects it on the next menu launch and prompts you to update. Accepting replaces the utility files and configurations in place. No manual download needed.
Stable users get stable releases; beta users get beta releases. When a stable version is published, ProxMenux notifies beta users on the next launch and offers to switch automatically — see the Beta Program page.
Where can I report issues?
Bug reports go on GitHub Issues. Include reproduction steps, error messages and (for Monitor-related issues) the output of journalctl -u proxmenux-monitor -n 50.
For security issues, please do not publish them. Read the Code of Conduct & Best Practices for the responsible disclosure procedure.
Can I contribute to ProxMenux?
Absolutely. ProxMenux is open source and collaborative. Contributions can be code (bash, Next.js / TypeScript, the translation Python venv), testing, documentation, design, or just ideas.
- Discuss ideas in GitHub Discussions before opening a feature request.
- For PRs, read the Code of Conduct & Best Practices first.
- See the Contributors page for current testers and reviewers.
How do I uninstall ProxMenux?
From inside ProxMenux: Settings → Uninstall ProxMenux. The uninstaller removes the script tree, the launcher and the Monitor service, optionally removes selected dependencies, and restores /root/.bashrc and /etc/motd backups taken at install time.
Full step-by-step: Uninstall ProxMenux.
VirusTotal flags the install URL — is it safe?
A 1/95 detection by heuristic engines (e.g. Chong Lua Dao) is a known false positive. The installer uses the standard curl | bash pattern and downloads legitimate binaries (like jq from its official GitHub release), which aggressive scanners flag based on behaviour rather than actual malicious code.
ProxMenux is 100% open source and the install script is reviewable line by line: install_proxmenux.sh. More context in Issue #162.