{
"meta": {
"title": "Installing ProxMenux | ProxMenux Documentation",
"description": "One-command installer for ProxMenux on Proxmox VE 8+ hosts. Includes pre-generated JSON catalogs for eight languages: English, Spanish, French, German, Italian, Portuguese, Slovak and Swedish. Choose a language during installation or change it later in Settings. A beta channel provides 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, the next menu launch offers the update; 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). The prompt shape depends on where menu runs: over SSH or the Proxmox console it is a classic yes / no dialog, and accepting applies the update immediately. Inside the WebSocket terminal of ProxMenux Monitor it is replaced by an informational msgbox — that terminal cannot survive a self-update mid-flight, so the msgbox shows the canonical one-line installer (bash -c \"$(wget -qLO - https://raw.githubusercontent.com/MacRimi/ProxMenux/main/install_proxmenux.sh)\" for stable, or the equivalent install_proxmenux_beta.sh URL for beta) to run from SSH or console."
},
"uninstall": {
"heading": "Uninstalling",
"body": "From inside ProxMenux: Settings → Uninstall ProxMenux. Removes the script tree, launcher and Monitor service, optionally removes selected dependencies, and restores /root/.bashrc and /etc/motd from the backups created by Post-Install, if they exist (otherwise it removes the ProxMenux MOTD line). Full step-by-step: Uninstall ProxMenux."
},
"troubleshoot": {
"heading": "Troubleshooting",
"virustotalTitle": "VirusTotal flags the install URL",
"virustotalBody": "The 1/95 result from Chong Lua Dao reported in Issue #162 was identified by the maintainer as a false positive. The installer is run with a command that downloads and executes the script (bash -c \"$(wget -qLO - …)\") and can download jq from its official GitHub release. This behaviour can trigger heuristic scanners. That historical report does not assess every future download. The installer is 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 the ProxMenux Monitor AppImage). 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."
}
}