MacRimi/ProxMenux

ProxMenux is an interactive toolkit for Proxmox VE — a menu-driven CLI plus a web dashboard for post-install, backup/restore and continuous health monitoring of your homelab.

To install ProxMenux, simply run the following command in your Proxmox server terminal:

bash -c "$(wget -qLO - https://raw.githubusercontent.com/MacRimi/ProxMenux/main/install_proxmenux.sh)"

⚠️ Be careful when copying scripts from the internet. Always remember to check the source!

📄 You can review the source code before execution.

🛡️ All executable links follow our Code of Conduct.

Once installed, launch ProxMenux by running:

menu

Then, follow the on-screen options to manage your Proxmox server efficiently.

ProxMenux Monitor is an integrated web dashboard that provides real-time visibility into your Proxmox infrastructure — accessible from any browser on your network, without needing a terminal.

What it offers:

• Real-time monitoring of CPU, RAM, disk usage and network traffic
• Overview of running VMs and LXC containers with status indicators
• Login authentication to protect access
• Two-Factor Authentication (2FA) with TOTP support
• Reverse proxy support (Nginx / Traefik)
• Designed to work across desktop and mobile devices

Access:

Once installed, the dashboard is available at:

http://<your-proxmox-ip>:8008

The Monitor is installed automatically as part of the standard ProxMenux installation and runs as a systemd service (proxmenux-monitor.service) that starts automatically on boot.

Useful commands:

# Check service status
systemctl status proxmenux-monitor

# View logs
journalctl -u proxmenux-monitor -n 50

# Restart the service
systemctl restart proxmenux-monitor

Want to try the latest features before the official release and help shape the final version?

The ProxMenux Beta Program gives early access to new functionality — including the newest builds of ProxMenux Monitor — directly from the develop branch. Beta builds may contain bugs or incomplete features. Your feedback is what helps fix them before the stable release.

Install the beta version:

bash -c "$(wget -qLO - https://raw.githubusercontent.com/MacRimi/ProxMenux/develop/install_proxmenux_beta.sh)"

What to expect:

• You'll get new features and Monitor builds before anyone else
• Some things may not work perfectly — that's expected and normal
• When a stable release is published, ProxMenux will notify you on the next menu launch and offer to switch automatically

How to report issues:

Open a GitHub Issue and include:

• What you did and what you expected to happen
• Any error messages shown on screen
• Logs from the Monitor if relevant:

journalctl -u proxmenux-monitor -n 50

💙 Thank you for being part of the beta program. Your help makes ProxMenux better for everyone.

The following Debian packages are installed automatically during setup:

UI translations ship as pre-built JSON files per language (English, Spanish, French, German, Italian, Portuguese). There is no runtime translation dependency.

ProxMenux is an open, collaborative project — contributions of every shape are very welcome, no matter your background. Every PR, bug report, idea, translation or kind word helps move the project forward.

📖 Before sending code, please read the Contributing Guide. It covers the project structure, the UI design policy (the two-phase dialog / whiptail flow), message helpers, translation policy and submission conventions — what reviewers will look for in your PR.

Ways to help:

• 💻 Code — fix a bug, polish a script, add a feature. Read the Contributing Guide first, then open a pull request.
• 🐛 Bug reports — found something broken? Open an issue with steps to reproduce, and the Monitor logs if relevant (journalctl -u proxmenux-monitor -n 50).
• 💡 Ideas & feedback — share suggestions in GitHub Discussions. Every idea is welcome.
• 🌍 Translations — the documentation site already supports English and Spanish; help expand it to more languages following the translation guide (one page per PR).
• 🧪 Beta testing — run the beta build and let us know what you find.
• ⭐ Spread the word — a GitHub star or a mention in your homelab community helps others discover the project.

Before contributing, please take a moment to read our Code of Conduct.

Thanks to everyone who has helped make ProxMenux what it is today.

Made with contrib.rocks.

If ProxMenux is useful to you, the simplest way to support it is a ⭐ on GitHub — it really helps others discover the project.

If you want to go a step further, a coffee on Ko-fi keeps development going:

_{Stars, forks, and Git clones tracked with Repo Growth.}