A growing hub of useful shell scripts for Proxmox VE.
Fast to run. Easy to reuse. Built for real-world homelab and admin workflows.
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.
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
- 💾 automatic backup before patching
- ♻️ built-in restore options
- 📋 interactive menu
bash <(curl -fsSL https://raw.githubusercontent.com/Victor-root/Proxmox-Tools/main/scripts/pve-console-newtab.sh)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
- 🧠 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.
bash <(curl -fsSL https://raw.githubusercontent.com/Victor-root/Proxmox-Tools/main/scripts/pve-default-language-i18n)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
- 💾 built-in backup / restore of the whole configuration
- 🧹 clean uninstall
- 📋 interactive menu
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/tunpassed through — the script detects this and shows the exactpct setcommands to run on the host if needed.
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
└── ...
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
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
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
These scripts are provided as-is.
Use them carefully, review them before running them, and test them in your own environment.
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.