🚀 Proxmox-Tools

A growing hub of useful shell scripts for Proxmox VE.
Fast to run. Easy to reuse. Built for real-world homelab and admin workflows.

victor-root.github.io/Proxmox-Tools
Every script with what it does, what it writes on your machine, the line to run it and a preview of its menu.
In English and French, light and dark. Same files as this repository, nothing else.

---

✨ What is this repository?

Proxmox-Tools is a central place for small, practical, focused scripts made to improve day-to-day life on Proxmox VE.

The goal is simple:

• 🧰 keep each tool independent
• ⚡ make scripts runnable in one command
• 🔎 keep behavior clear and predictable
• 💾 always prefer safe changes with backup/restore when possible
• 📦 build a reusable toolbox / hub instead of one giant script

This repository is meant to grow over time with more Proxmox-oriented utilities.

---

🛠️ Available scripts

Click a script to unfold what it does, what it supports and the line to run it.

🖱️ Open Proxmox consoles in new tabs

Script: pve-console-newtab.sh

Adds a more convenient browser workflow for the Proxmox VE web interface:

• 🖱️ Middle click on the main Console button opens the default web console in a new tab
• 🖱️ Middle click on noVNC opens it in a new tab
• 🖱️ Middle click on xterm.js opens it in a new tab
• 🖱️ Middle click on SPICE behaves like a normal click, without opening a useless browser tab
• 🌳 separate option: middle click on a VM or container of the left tree opens its console in a new tab, where that click did nothing before
• 💾 automatic backup before patching
• ♻️ built-in restore options
• 📋 interactive menu

Version compatibility

Checked against the official Proxmox VE sources:

Proxmox VE	Status
9.x (pve-manager 9.0.0 to 9.2.11)	✅ supported
8.4.2 and newer (with proxmox-widget-toolkit 4.3.12+)	✅ supported
8.4.1 and older (8.0, 8.1, 8.2, 8.3)	❌ not supported

Proxmox re-formatted its JavaScript sources in June 2025, so the code blocks this patch targets only match releases published after that change.

On an unsupported release the script stops with a clear message, creates no backup and leaves both files untouched, so nothing can break.

Each of the two patched files is also checked and patched on its own: a Proxmox update that refreshes only one of the two packages can simply be re-patched.

About the resource tree

Option 6 is a second, separate patch. It reuses the console Proxmox VE already opens when you double click a guest in the left tree, with the same viewer choice, and asks for it in a new tab instead of a window. The middle click has no function there in stock Proxmox VE, and the current selection is left untouched, so nothing that worked before changes.

It needs the main patch first, since that is what teaches the console how to open in a tab, and the script says so instead of touching a file for nothing. Templates, nodes and storages stay without effect, exactly like on a double click. The two code blocks it needs are identical in Proxmox VE 8 and 9.

Run it directly

bash <(curl -fsSL https://raw.githubusercontent.com/Victor-root/Proxmox-Tools/main/scripts/pve-console-newtab.sh)

🔕 Remove the subscription notice

Script: pve-remove-subscription-notice.sh

Removes the "No valid subscription" popup from the Proxmox VE web interface:

• 🔕 no more popup at every login
• 🧩 the buttons that depend on that check keep working (package versions, system report, APT refresh, add repository)
• 📱 separate option for the mobile interface of Proxmox VE 9, which is another application entirely and needs its own patch
• 🔁 optional automatic re-apply after a package update, through an APT hook
• 💾 automatic backup before patching
• ♻️ built-in restore options
• 📋 interactive menu

ℹ️ Proxmox VE stays free software either way, but a subscription funds its development and gives access to the enterprise repository.

⏳ The final pveproxy restart can take up to a minute, and the web interface stays unreachable meanwhile. See About the pveproxy restart.

Version compatibility

Checked against the official Proxmox VE sources: the patch applies from proxmox-widget-toolkit 4.0.9 to 5.2.8, which covers Proxmox VE 8.0 through 9.2.

The widely shared one-liner for this comments out the popup itself, which also silently kills every button that waits for it. This script instead lets the requested action run straight away, so nothing else changes. On an unsupported release it stops with a clear message, creates no backup and leaves the file untouched.

About the mobile interface

Proxmox VE 9 only. The mobile interface of Proxmox VE 9 is a separate application compiled to WebAssembly, so the JavaScript patch above never reaches it and its popup keeps showing on a phone. Proxmox VE 8 ships a different, older mobile interface that this patch does not touch, so on 8 the script refuses the option instead of changing a file for nothing. It nags when the node list comes back without a support level, and that level is filled by one line of Perl in PVE/API2Tools.pm, which is what option 8 patches, with its own backup and its own way back.

That patch is offered separately because it is not the same kind of change: it modifies what the API answers about the support level of the nodes, so a monitoring tool reading that list will see community. The per node subscription endpoint is left alone, the Subscription panel keeps reporting that there is no subscription, and nothing is unlocked: the enterprise repository still needs a real key. The script spells all of this out and asks for confirmation before touching anything.

Run it directly

bash <(curl -fsSL https://raw.githubusercontent.com/Victor-root/Proxmox-Tools/main/scripts/pve-remove-subscription-notice.sh)

🌍 Proxmox VE default language manager

Script: pve-default-language-i18n

Changes the default Proxmox VE language for both the shell and the web interface:

• 🌍 set the default system locale
• 🖥️ set the default Proxmox VE web UI language
• 📱 optional, Proxmox VE 9 only: apply that same default to its mobile interface, which otherwise always starts in English
• 🧠 auto-detect the server language for the script interface
• 🇬🇧 fallback to English if the detected language is unsupported
• 🕒 optionally configure timezone and NTP
• 💾 automatic backup before changes
• ♻️ built-in restore options
• 📋 interactive menu

⚠️ Keep an active root SSH session open while running this script, in case the Proxmox VE web interface does not restart correctly.

Version compatibility

Checked against the official Proxmox VE sources: the system locale mechanism and the language key of /etc/pve/datacenter.cfg are identical from 8.x to 9.2, so this script behaves the same on both.

Proxmox VE only accepts a fixed list of languages for its web interface. For a language it does not offer (Galician, Hungarian), the system locale is still applied and datacenter.cfg is left untouched, with a clear warning, instead of writing a value Proxmox would silently drop.

About the mobile interface

Proxmox VE 9 only. The mobile interface of Proxmox VE 9 is a separate application, and it does not read the language of datacenter.cfg. Proxmox VE 8 ships a different, older mobile interface, so on 8 the option reports that this interface is not installed and changes nothing. It keeps its own language in the browser storage, so it starts in English on every new device and in every private window, until someone picks a language in its settings.

Option 7 adds a few lines to its page so a browser that never chose a language starts with the one from datacenter.cfg. A choice made in the mobile settings still wins, and option 8 removes those lines. The page belongs to Proxmox VE, so an update of the mobile interface package drops them and the option simply puts them back.

Run it directly

bash <(curl -fsSL https://raw.githubusercontent.com/Victor-root/Proxmox-Tools/main/scripts/pve-default-language-i18n)

🔐 WireGuard VPN server installer & client manager (LXC)

Script: lxc-wireguard-server-install.sh

Installs and manages a native WireGuard VPN server inside a Debian/Ubuntu LXC on Proxmox (no Docker), through an interactive menu:

• 🧭 guided install with 3 clear network modes: private network, LAN access, full Internet tunnel
• 👤 full client lifecycle: add, list (with live connection state), show / re-scan (config + QR code), revoke
• 🩺 diagnostic that checks the service, UDP port, IPv4 routing, firewall rules and connected clients, in plain language
• 🌐 endpoint by public IP or domain, with a CGNAT warning and a check that the domain points to the server
• 🧱 automatic nftables rules and IPv4 forwarding for LAN / full-tunnel modes
• 🔧 per-client tunables: AllowedIPs, DNS, PersistentKeepalive, MTU (default 1420)
• 🧠 remembers your settings (endpoint, port, network) after the first run
• 🌍 interface in English or French, following the system locale, English by default
• 💾 built-in backup / restore of the whole configuration
• 🧹 clean uninstall
• 📋 interactive menu

Run it directly

bash <(curl -fsSL https://raw.githubusercontent.com/Victor-root/Proxmox-Tools/main/scripts/lxc-wireguard-server-install.sh)

⚠️ Run it as root inside the target LXC (not on the Proxmox host). On an unprivileged container, WireGuard needs /dev/net/tun passed through: the script detects this and shows the exact pct set commands to run on the host if needed.

🖥️ Fastfetch summary on every root shell

Script: pve-fastfetch-motd.sh

Installs Fastfetch and turns it into a clean Proxmox summary displayed every time a root shell opens:

• 📦 installs the latest stable Fastfetch release from GitHub, with automatic architecture detection (amd64, arm64, armhf, ppc64el, riscv64, s390x)
• 🎨 writes a ready-to-use Proxmox themed configuration, split in three blocks: hypervisor info, physical resources, network and access
• 📊 live values: PVE version, CPU temperature and usage, RAM, swap, storage, ZFS pool health, bridge state, local and public IP, DNS, Fail2ban jails
• 🔐 optional HTTPS certificate check on a FQDN you provide, which reads only the public certificate presented by your reverse proxy, never a private key
• ✍️ or paste your own config.jsonc straight into the menu: Fastfetch checks it, and it replaces the generated one only if it is valid
• 🐚 displayed only in interactive root shells, never during scripts, file transfers or automation
• 🧹 disables the old Debian MOTD, with the original state saved for a later restore
• ♻️ two removal levels: stop the display at every shell session and keep Fastfetch, or remove everything and uninstall the package
• 💾 automatic backup of an existing Fastfetch configuration before writing
• 🌍 interface and generated labels in English or French, following the server locale
• 📋 interactive menu

Version compatibility

The script only relies on pveversion, apt and the official Fastfetch packages, so it behaves the same on Proxmox VE 8.x and 9.x.

It stops with a clear message when it is not run as root on a Proxmox VE host, and running it again is safe: an up-to-date Fastfetch is not downloaded twice, and the login hook and MOTD changes are simply re-applied.

The bridge shown in the network block is detected from the default route, with vmbr0 as fallback, and no domain, IP or hostname is ever hard coded in the script.

Run it directly

bash <(curl -fsSL https://raw.githubusercontent.com/Victor-root/Proxmox-Tools/main/scripts/pve-fastfetch-motd.sh)

ℹ️ Open a new root shell after the installation to see the result.

🌳 Default panel layout (tree and Logs panel)

Script: pve-expand-node-tree.sh

Fixes two Proxmox VE panels that always start in the wrong state and need a manual click on their chevron after every login:

• 🌳 each PVE node in the left resource tree opens automatically on the default Server View, exactly like clicking its chevron by hand
• 🎯 targeted: pools, storages, VMs and containers stay as they are, only the node groups themselves are affected
• 📉 separate option: the bottom Logs panel (Tasks tab and cluster log) collapses by default instead of covering part of the screen at every login
• 💾 automatic backup before patching
• ♻️ built-in restore options, plus a direct on/off toggle for the Logs panel
• 📋 interactive menu

Version compatibility

Checked against the official Proxmox VE sources: both patched lines are identical in Proxmox VE 8 and 9, so this script behaves the same on both.

On an unsupported release it stops with a clear message, creates no backup and leaves the file untouched.

Run it directly

bash <(curl -fsSL https://raw.githubusercontent.com/Victor-root/Proxmox-Tools/main/scripts/pve-expand-node-tree.sh)

🖥️ Console scrollback (xterm.js history)

Script: pve-xtermjs-scrollback.sh

Raises the history of the Proxmox VE web consoles from the default 1000 lines to the size you choose:

• 🔢 pick one of five ready-made sizes (10000 to 250000 lines, 100000 recommended) or type your own number (1000 to 1000000), and change it again later from the same menu entry
• 🖥️ applies to every xterm.js console: the host shell, containers and the serial console of VMs
• 🌐 set once on the server, so there is nothing to redo in each browser on each computer
• 🎯 changes a single line of /usr/share/pve-xtermjs/util.js: the default options handed to every console
• 🔎 the expected code is matched exactly before any change: if the file looks different the script says so and touches nothing
• 🔁 safe to run twice: an already patched file is detected and left alone
• 💾 automatic backup before patching
• ♻️ built-in restore options
• 🧪 a test option prints 500 more numbered lines than the limit you chose, so you can scroll up and check it right away
• 📋 interactive menu

Good to know

• Memory: the history is stored by the browser. A full console takes about 1 MB per 1000 lines at 80 columns and 2.5 MB at 200 columns, per open tab: 100000 lines is about 100 MB and 240 MB. The script shows the figure for your choice before asking to confirm. Lines are only stored as text is displayed, an empty console stays light.
• A value saved in a browser wins. Recent versions of pve-xtermjs read a pve-xterm-scrollback key from the browser storage, there is no field for it in the Proxmox settings yet, and it takes priority over the default set by this script.
• No restart needed: pveproxy reads the file on every request. Open a new console.
• The browser cache can hide the change. Proxmox sends no expiry for this file, so a browser may keep the old copy for days, and a plain or even hard refresh is not always enough. Check in a private window, then clear the site data in each browser you use.
• Updates of the pve-xtermjs package overwrite the file, run the script again afterwards.

Version compatibility

Checked against the official Proxmox sources: the patched block is identical in every published version of util.js, from Proxmox VE 8 (pve-xtermjs 5.x) to 9.2 (6.0.0-2), so this script behaves the same on both.

On an unexpected file it stops with a clear message, creates no backup and leaves the file untouched.

Run it directly

bash <(curl -fsSL https://raw.githubusercontent.com/Victor-root/Proxmox-Tools/main/scripts/pve-xtermjs-scrollback.sh)

---

📂 Repository philosophy

Each script lives as its own file inside the scripts/ directory.

That means:

• you can call one specific script directly
• you do not need a global installer for everything
• each tool can evolve independently
• sharing a tool is easy with a targeted raw GitHub URL

Example layout:

scripts/
├── pve-console-newtab.sh
├── pve-default-language-i18n
├── future-tool-1.sh
├── future-tool-2.sh
└── ...

---

🔒 Safety notes

Some tools in this repository may modify Proxmox files or behavior.

Before using any script:

• read what it does
• keep an active root SSH session open
• make sure you understand the rollback path
• prefer testing on a non-critical node first

When relevant, scripts in this repository should:

• create backups before changes
• fail safely if expected patterns are not found
• avoid destructive behavior by default

⏳ About the pveproxy restart

Every script that changes the web interface restarts pveproxy at the end. That restart can take up to a minute: on start Proxmox refreshes the cluster certificates (pvecm updatecerts), and on a first run it may also refresh the appliance template list.

The web interface stays unreachable during that time, and the script looks frozen while it waits. This is expected. Let it finish rather than interrupting it, and reload the page with Ctrl+Shift+R once it is done.

---

🎯 Project goals

This repo is intended to become a practical Proxmox utility hub, for example:

• UI enhancements
• backup helpers
• audit / health-check scripts
• storage / ZFS helpers
• cluster helpers
• networking helpers
• quick-fix admin tools

The main idea is not to build a huge framework.

The idea is to keep things:

• simple
• useful
• modular
• easy to launch

---

🤝 Contributing

Ideas, fixes, and improvements are welcome.

Good contributions are usually:

• focused on one real problem
• easy to understand
• safe to test
• easy to remove or rollback

---

📄 License

This repository is published under the GNU Affero General Public License v3.0. The full text is in LICENSE.

You can use, study, change and share these scripts, as long as what you share stays under the same license and keeps the credit.

---

📜 Disclaimer

These scripts are provided as-is.

Use them carefully, review them before running them, and test them in your own environment.

---

⭐ Why this repo exists

Because Proxmox is great, but there are always a few small things that can be made faster, cleaner, or less annoying with the right script.

This repository exists to collect those improvements in one place.