ProxMorph

Custom themes for Proxmox VE (PVE) and Proxmox Backup Server (PBS) that integrate with the native Color Theme selector.

✨ Features

• Native Integration - Themes appear in built-in Color Theme dropdown (PVE and PBS)
• Auto-Patch on Updates - Automatically re-applies themes after product updates
• Hybrid Engine - CSS for styling + JavaScript for dynamic chart patching
• Hardware Sensor Monitoring - Optional CPU/storage temps, fan speeds, and UPS status on node Summary dashboard
• Easy Installation - Single command installation for both PVE and PBS

📸 Screenshot

Comparison between default Proxmox Dark theme and UniFi theme:

🎨 Themes

22 themes across 9 collections. Featured themes below — View Full Gallery →

UniFi Inspired by Ubiquiti UniFi Network Application	Dracula Classic Dracula dark with purple accent
Catppuccin Mocha Darkest Catppuccin flavor — deep warm tones	Nord Dark Arctic dark palette with polar blue accent

All Available Collections

Collection	Themes
Catppuccin	Mocha, Mocha Teal, Macchiato, Frappé, Latte
Dracula	Classic, Midnight, Pink, Cyan, Green, Orange
Nord	Dark, Light
Gruvbox	Dark, Light
Solarized	Dark, Light
Tokyo Night	—
UniFi	Dark, Light
GitHub Dark	—
Blue Slate	—

🚀 Installation

One-Liner Install

bash <(curl -fsSL https://raw.githubusercontent.com/IT-BAER/proxmorph/main/install.sh) install

Manual Install

git clone https://github.com/IT-BAER/proxmorph.git
cd proxmorph
chmod +x install.sh
./install.sh install

Apply Theme

1. Hard refresh browser (Ctrl+Shift+R)
2. Click username → Color Theme
3. Select a ProxMorph theme

💻 Commands

Command	Description
./install.sh install	Install themes
./install.sh uninstall	Remove themes
./install.sh update or bash <(curl -fsSL https://raw.githubusercontent.com/IT-BAER/proxmorph/main/install.sh) update	Updates (latest from GitHub) and install the latest themes
./install.sh status	Show installation status
./install.sh	Shows Menu to manage

🛠️ Creating Themes

1. Copy an existing theme from themes/
2. Rename to theme-yourname.css
3. Edit the first line: /*!Your Theme Name*/
4. Modify CSS styles
5. Run ./install.sh install

Theme files must start with /*!Display Name*/ - this sets the name in Proxmox's dropdown.

❓ Troubleshooting

Themes not appearing in Color Theme dropdown

If themes don't appear after installation:

1. Clear browser cache — Press Ctrl+Shift+R (hard refresh)
2. Check installation status — Run ./install.sh status
3. Restart proxy service — Run systemctl restart pveproxy (PVE) or systemctl restart proxmox-backup-proxy (PBS)

Cloudflare Tunnel caching issues

If you access Proxmox through a Cloudflare Tunnel, themes may not load due to aggressive caching. To fix:

1. Log in to Cloudflare Dashboard and select your domain
2. Navigate to Caching → Cache Rules
3. Click Create rule
4. Set Hostname to your Proxmox subdomain (e.g., proxmox.example.com)
5. Set Cache eligibility to Bypass cache
6. Save and deploy the rule

See Issue #13 for more details — thanks to @gioxx for the solution!

ℹ️ How It Works

1. Theme CSS files are copied to shared /usr/share/javascript/proxmox-widget-toolkit/themes/
2. JavaScript patches (for charts) are installed to product-specific JS directories
3. proxmoxlib.js is patched to register themes, and product index templates (.tpl or .hbs) are patched to load JS patches
4. An apt hook automatically re-patches after product updates (widget-toolkit, pve-manager, or proxmox-backup-server)
5. Themes appear in the native Color Theme selector of both PVE and PBS

📦 Supported Versions

• Proxmox VE 9.x / 8.x
• Proxmox Backup Server 4.x / 3.x

📄 License

MIT License

💜 Support

If you like my themes, consider supporting this and future work, which heavily relies on coffee:

Donate via PayPal