{
"meta": {
"title": "Installing ProxMenux | ProxMenux Documentation",
"description": "One-line installer for ProxMenux on Proxmox VE 8+ hosts. Choose between the Translation flavour (multi-language) or Normal (lightweight English-only). Beta channel also available for early access to new features.",
"ogTitle": "Installing ProxMenux | ProxMenux Documentation",
"ogDescription": "Install ProxMenux on Proxmox VE 8+ in one command. Stable and beta channels available."
},
"header": {
"title": "Installing ProxMenux",
"description": "One-line installer that runs on any Proxmox VE 8+ host. Auto-installs the dependencies it needs, downloads the scripts, sets up the menu launcher and (on first run) prompts you to pick a language. Two install channels: stable (default) and beta.",
"section": "Installation"
},
"stable": {
"heading": "Install",
"intro": "Run this in your Proxmox host's terminal:",
"code": "bash -c \"$(wget -qLO - https://raw.githubusercontent.com/MacRimi/ProxMenux/main/install_proxmenux.sh)\""
},
"during": {
"heading": "During installation",
"intro": "ProxMenux automatically installs and configures the dependencies it needs:",
"tablePackage": "Package",
"tablePurpose": "Purpose",
"rows": [
{
"package": "dialog",
"purpose": "Interactive terminal menus"
},
{
"package": "curl",
"purpose": "Downloads and connectivity checks"
},
{
"package": "jq",
"purpose": "JSON processing"
},
{
"package": "git",
"purpose": "Repository cloning and updates"
}
],
"outro": "The installer also pulls down the script tree into /usr/local/share/proxmenux/ and creates the launcher at /usr/local/bin/menu. The ProxMenux Monitor web dashboard is registered as proxmenux-monitor.service.",
"imageAlt": "ProxMenux installation in progress"
},
"first": {
"heading": "First launch",
"intro": "Once installed, run:",
"code": "menu",
"outro": "ProxMenux launches and you land on the main menu. From here you can run any of the workflows documented in this site — Post-Install is a good first stop on a fresh Proxmox host."
},
"beta": {
"heading": "Beta channel",
"calloutTitle": "What is the Beta Program?",
"calloutBody": "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 helps fix them before the stable release.",
"intro": "Install the beta version instead of the stable one with:",
"code": "bash -c \"$(wget -qLO - https://raw.githubusercontent.com/MacRimi/ProxMenux/develop/install_proxmenux_beta.sh)\"",
"outro": "Beta is opt-in — you have to explicitly run the beta installer. When a stable release is published, ProxMenux notifies you on the next menu launch and offers to switch automatically. To opt out earlier, use the Deactivate Beta Program option in Settings."
},
"updating": {
"heading": "Updating",
"body": "ProxMenux self-updates. When a new version is available, you're prompted on the next menu launch and accepting replaces utility files and configurations in place. No manual download needed. Stable users get stable releases; beta users get beta releases (and the auto-switch prompt above when a stable cuts over)."
},
"uninstall": {
"heading": "Uninstalling",
"body": "From inside ProxMenux: Settings → Uninstall ProxMenux. Removes the script tree, launcher and Monitor service, optionally removes selected dependencies, restores /root/.bashrc and /etc/motd backups taken at install time. Full step-by-step: Uninstall ProxMenux."
},
"troubleshoot": {
"heading": "Troubleshooting",
"virustotalTitle": "VirusTotal flags the install URL",
"virustotalBody": "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. The installer is 100% open source and reviewable. More context in Issue #162.",
"aptTitle": "Install fails with apt errors",
"aptBody": "Usually a missing or misconfigured Proxmox repo. The installer pulls dependencies via apt; if the repo config is broken (often the case on bare-bones Proxmox 8 installs that haven't been updated yet), apt fails. Run apt-get update manually first and resolve any errors, then re-run the installer.",
"menuTitle": "`menu: command not found` after install",
"menuBody": "The launcher lives at /usr/local/bin/menu. Check it's there: ls -lh /usr/local/bin/menu. If missing, the install ended early — re-run the installer. If present but not found, your PATH doesn't include /usr/local/bin; either fix PATH or invoke the launcher directly: /usr/local/bin/menu.",
"stuckTitle": "The install hangs or doesn't progress",
"stuckBody": "If an install, reinstall or update gets stuck because of a connection issue, cancel with Ctrl + C and re-run the installer manually.",
"otherTitle": "Other issues",
"otherBody": "Check the GitHub Issues for known problems or open a new one with the relevant log output. Beta users: include journalctl -u proxmenux-monitor -n 50 if Monitor-related."
},
"next": {
"heading": "What's next",
"postInstall": "Post-Install Script — tweaks and hardening for a fresh Proxmox host.",
"introduction": "Introduction — the full feature tour.",
"monitor": "ProxMenux Monitor — web dashboard for the host (auto-installed alongside the menu)."
},
"requirements": {
"heading": "Requirements & good practices",
"reqTitle": "Requirements",
"reqBody": "Proxmox VE 8.x or later. PVE 7 and earlier are not supported. Internet access from the host (the installer downloads scripts, dependencies and — on the Translation install — Python packages from PyPI). Run as root on the Proxmox host.",
"inspectTitle": "Always inspect scripts you run from the internet",
"inspectReview": "Review the installer source before running.",
"inspectCoc": "All executable links follow the ProxMenux Code of Conduct."
}
}