v1.0.3 · MIT · Tested on Proxmox VE 8.4 and 9.2

Groups and separators in the Proxmox VE tree.

Organize VMs and containers into colored sections — like Production › Network, Testing, Template — right in the Server View, with a screen to pick colors, order and style.

# bash -c "$(curl -fsSL https://github.com/diego-luz/pve-organize/releases/latest/download/install.sh)"

Run it on the Proxmox node, as root. Then reload the web UI (F5).

pve-organize in action: moving a guest to a group, switching the style live, turning it off and on
Uses your Proxmox tags No Proxmox files replaced

All images use a fictional lab (node pve01), not a real server.

Before and after

The Server View you already use, finally organized.

Same guests, same tags. pve-organize just turns those tags into headers, so a long flat list becomes sections you can scan at a glance.

  • Each guest in one place — no duplicates, unlike the Tag View.
  • Still grouped by node — nothing about your tree layout changes.
  • Off in one command — and the original tree is back.
The default tree with tags, next to the same guests organized by pve-organize
Features

Small add-on, big difference in a busy cluster

Everything happens in the web UI. Nothing new is stored on your guests.

Two levels

A top level (big header) and, if you want, a subcategory (subheader) for each guest.

Built on Proxmox tags

A guest tagged Production;Network shows up under PRODUCTION › Network. No new data on the servers.

Right-click → Move to group

Change a guest's group in two clicks, straight from the tree.

Tree groups screen

Create groups, pick colors or let them be automatic, drag to reorder, 6 styles, counter, indent and an ON/OFF switch — with live preview.

Shared by the whole cluster

Settings live in the Datacenter Notes and Tag Style, so every admin and browser sees the same tree.

Survives Proxmox updates

Comes back by itself seconds after a Proxmox update — no reinstall. Follows the Proxmox language: English, Portuguese and Spanish.

Screens

Make it look the way you like

Six header styles, dark and light themes, and a settings screen right inside the Proxmox UI.

Compare

Why not the Tag View or pools?

Proxmox VE already has the Tag View (since 8.3) and the Pool View. They solve similar problems; pve-organize keeps the Server View you already use, just organized.

pve-organizeTag ViewPool ViewMods replacing pvemanagerlib.js
Stays in the Server View (grouped by node)✓✗✗varies
Each guest appears in one place only✓✗ once per tag✓varies
Two levels (group › subgroup)✓✗✗✓
Colored headers, custom order, styles✓✗✗✗
Settings screen in the web UI✓——✗
Settings shared by the whole cluster✓✓✓✓ (tags)
Does not modify Proxmox files✓ injects a script✓✓✗
Survives apt upgrade✓ watcher + apt hook✓✓usually ✗
Official / supported by Proxmox✗✓✓✗

Need permissions per group? Use pools — pve-organize is purely visual and works alongside them.

Install

One command. Then F5.

The installer downloads the latest release and checks every file against its SHA256SUMS before installing.

01

Open a shell on the node

In the web UI: select the node → >_ Shell. Or over SSH, as root. Not on your own computer.

bash
$ ssh root@<node-ip>
02

Run the installer

It installs the latest published version and stops if any checksum does not match.

bash
# bash -c "$(curl -fsSL \
  https://github.com/diego-luz/pve-organize/releases/latest/download/install.sh)"
03

Reload the web UI

Back in the browser, press F5. Right-click a guest → Move to group, or open Tree groups… to set things up.

browser
F5 → https://<node-ip>:8006

Tested on Proxmox VE 9.2 and 8.4. 8.0–8.3 are allowed with a warning; versions before 8 are refused. In a cluster, install on each node whose web UI you use.

Simple to control

Turn it off and the original Proxmox tree is back; your groups stay saved. Uninstall removes everything that was installed.

bash
# pve-organize status   # version, on/off, watcher…
# pve-organize off      # remove from the UI, keep config
# pve-organize on       # load it again
# pve-organize uninstall
How it works

Transparent by design

A single script added to the web UI. Read every line on GitHub.

Only the web UI changesMoving a guest only edits its tags.
One line injectedA script tag in the page template; a clean copy is kept.
Watcher + apt hookPuts the line back seconds after a Proxmox update replaces the page.
Verified downloadsEvery release file is checked against SHA256SUMS.
Respects permissionsMoving needs VM.Config.Options; saving the screen needs Sys.Modify on /.
Names are escapedNo script injection through group names.
FAQ

Frequently asked questions

Is it free?
Yes. pve-organize is open source under the MIT license.
Does it change my VMs or containers?
Only their tags, and only when you move a guest to a group. Groups, order and style are saved in a hidden block at the end of Datacenter → Notes; colors go to Datacenter → Options → Tag Style. The rest of your notes is untouched.
What happens when I update Proxmox?
An update of pve-manager replaces the Proxmox page and the add-on disappears for a moment. You don't need to reinstall: a systemd watcher puts it back within seconds — then press Ctrl+F5. Still missing? Run pve-organize on and check journalctl -t pve-organize. pve-organize off and F5 always bring back the original tree.
Do I need to install it on every node?
On each node whose web UI you open. The configuration itself is stored at the Datacenter level, so all nodes and browsers share the same groups.
Can I use it together with pools?
Yes. pve-organize is purely visual. If you need permissions per group, keep using pools for that.
How do I update or uninstall?
To update, run the install command again — it always fetches the latest release. To remove it, run pve-organize uninstall and press F5. What changed in each version is in the CHANGELOG.
Is it affiliated with Proxmox?
No. It is a community project, not affiliated with Proxmox Server Solutions GmbH.

Give your Proxmox tree some order.

Install in one command, turn it off in another. Free and open source.