ProxMenux/web/messages/en/docs/settings/uninstall-proxmenux.json

{
  "meta": {
    "title": "Uninstall ProxMenux | ProxMenux Documentation",
    "description": "Clean ProxMenux uninstaller with optional removal of jq and dialog, cleanup of legacy translation files and the Monitor service, and restoration of system-file backups.",
    "ogTitle": "Uninstall ProxMenux | ProxMenux Documentation",
    "ogDescription": "Cleanly remove ProxMenux from a Proxmox host with optional dependency cleanup."
  },
  "header": {
    "title": "Uninstall ProxMenux",
    "description": "Removes ProxMenux from the Proxmox host with an interactive flow: confirmation, optional dependency removal, ProxMenux Monitor service cleanup, restoration of /root/.bashrc and /etc/motd backups. Shows a progress bar throughout.",
    "section": "Settings"
  },
  "scopeWarn": {
    "title": "Affects the ProxMenux install only — not your VMs / CTs / storage",
    "body": "Uninstalling ProxMenux removes the ProxMenux scripts, the menu launcher, the optional Monitor service and any backups ProxMenux took of system files when you installed it. <strong>It does not touch your VMs, containers, storage, network configuration, Fail2Ban, NVIDIA driver or anything else you installed via ProxMenux.</strong> Those stay as they are."
  },
  "flow": {
    "heading": "The uninstall flow",
    "items": [
      "<strong>Confirmation dialog.</strong> Yes/no — “Are you sure you want to uninstall ProxMenux?”",
      "<strong>Dependency removal checklist.</strong> Offers jq and dialog. Both boxes are OFF by default; select only dependencies that no other application needs.",
      "<strong>Removal runs with a progress bar.</strong> Removes any leftover legacy translation environment, the <code>menu</code> launcher, the <code>/usr/local/share/proxmenux/</code> tree, the ProxMenux Monitor service if present together with the notification target it registered in Proxmox VE (<code>proxmenux-webhook</code> and its matcher), the dependencies you ticked, and finally restores the system file backups (see below).",
      "<strong>Completion dialog.</strong> Lists removed dependencies and exits."
    ]
  },
  "deps": {
    "heading": "Dependency removal: what's offered",
    "intro": "The checklist offers jq and dialog. <strong>Neither box is checked by default</strong>: other applications may use these system-wide packages, so keeping them is safer.",
    "headerType": "Installation",
    "headerOffered": "Offered for removal",
    "rows": [
      {
        "type": "Current releases",
        "offeredRich": "<code>dialog</code>, <code>jq</code>"
      },
      {
        "type": "Legacy installations after updating",
        "offeredRich": "<code>dialog</code>, <code>jq</code>"
      }
    ],
    "warnTitle": "System-wide packages — think twice",
    "warnBody": "The current checklist offers <code>jq</code> and <code>dialog</code>, not <code>python3</code>. These are system packages that other tools may need. Removal can also remove dependent packages or unused dependencies. Keep required packages and review any proposed removal before running apt manually."
  },
  "removed": {
    "heading": "What gets removed",
    "code": "/usr/local/bin/menu                                  # the launcher\n/usr/local/share/proxmenux/                          # everything: scripts, config, cache, version\n/opt/googletrans-env/                                # leftover legacy translation environment\n/etc/systemd/system/proxmenux-monitor.service        # Monitor service unit\n/root/.config/proxmenux-monitor/                     # Monitor config dir\n                                                     # + dependencies you ticked in the checklist"
  },
  "restored": {
    "heading": "What gets restored",
    "items": [
      "If <code>/root/.bashrc.bak</code> exists → renamed back to <code>/root/.bashrc</code> (your original bashrc returns).",
      "If <code>/etc/motd.bak</code> exists → renamed back to <code>/etc/motd</code>. Otherwise the ProxMenux line (<em>“This system is optimised by: ProxMenux”</em>) is stripped from the existing motd with sed."
    ]
  },
  "othersCallout": {
    "title": "Other ProxMenux-installed components stay",
    "body": "Anything ProxMenux installed via other menus — Fail2Ban, Lynis, NVIDIA drivers, post-install tweaks — is <strong>not</strong> touched by this uninstaller. Each has its own uninstall flow inside its respective menu (or you can remove with apt directly). Look at <em>Show Version Information</em> first to see what's registered."
  },
  "manual": {
    "heading": "Manual uninstall",
    "intro": "If for some reason the menu uninstaller can't run (e.g. <code>dialog</code> already missing), the equivalent manual sequence:",
    "code": "# 1. Stop and remove the Monitor service (if installed)\nsystemctl stop proxmenux-monitor.service 2>/dev/null\nsystemctl disable proxmenux-monitor.service 2>/dev/null\nrm -f /etc/systemd/system/proxmenux-monitor.service\nrm -rf /root/.config/proxmenux-monitor\nsystemctl daemon-reload\nsystemctl reset-failed 2>/dev/null\n\n# 2. Remove a leftover legacy translation environment\nrm -rf /opt/googletrans-env\n\n# 3. Remove ProxMenux files\nrm -f /usr/local/bin/menu\nrm -rf /usr/local/share/proxmenux\n\n# 4. Restore backups\n[ -f /root/.bashrc.bak ] && mv /root/.bashrc.bak /root/.bashrc\n[ -f /etc/motd.bak ] && mv /etc/motd.bak /etc/motd \\\n    || sed -i '/This system is optimised by: ProxMenux/d' /etc/motd"
  },
  "reinstall": {
    "heading": "Reinstalling later",
    "body": "Run the official ProxMenux installer again. Current releases use one installation path with all eight interface languages included."
  },
  "troubleshoot": {
    "heading": "Troubleshooting",
    "hangTitle": "Uninstall stalls while removing a legacy translation environment",
    "hangBody": "Current releases remove a leftover environment with <code>rm -rf /opt/googletrans-env</code>; they do not run <code>pip uninstall</code>. If this step stalls, inspect it from another shell and check the host filesystem before retrying.",
    "aptTitle": "apt warns about packages still in use during dependency removal",
    "aptBody": "Selected packages are marked automatic and passed to <code>apt-get -y --purge autoremove</code>. This does not guarantee that dependent services are protected. Leave dependencies unchecked if other tools need them; review apt’s proposed removals before any manual cleanup.",
    "motdTitle": "MOTD still shows the ProxMenux line after uninstall",
    "motdBody": "Either no <code>/etc/motd.bak</code> existed and the sed strip didn't match (e.g. the line was modified). Edit <code>/etc/motd</code> by hand and remove any leftover ProxMenux line."
  },
  "related": {
    "heading": "Related",
    "items": [
      {
        "href": "/docs/settings/show-version-information",
        "label": "Show Version Information",
        "tail": " — see what would be removed before uninstalling."
      },
      {
        "href": "/docs/settings",
        "label": "Settings overview",
        "tail": "."
      }
    ]
  }
}