How to Enable Dark Mode in Proxmox VE (And Fix It When It Won't Stick)

Squint at a bright white Proxmox VE login screen at 11 p.m. often enough and you start wondering if there's a dark theme hiding somewhere. There is, and it's been built into Proxmox VE since version 7.4 — you just need to know where to look, because it isn't on the login page and it isn't in the Datacenter tree either.

This one's short. It's also one of those settings that trips people up for a silly reason: it's stored per browser, not on the server, so it can quietly "reset" when you switch machines or open a private window, and that confuses people into thinking the setting didn't save at all. We'll cover the actual toggle, why it behaves the way it does, and a couple of things worth knowing if you manage Proxmox Backup Server or Proxmox Datacenter Manager too.

What You Will Learn

• Where the Color Theme setting actually lives in the Proxmox VE web interface
• What "Proxmox Dark" and "Default (auto)" actually do
• Why your dark theme choice can look like it "didn't save" after a reboot or in a new browser
• How to make dark mode follow your OS automatically instead of toggling it by hand
• A couple of real CLI commands worth knowing if the web UI looks stuck or outdated after an update

What Is This Feature?

The Color Theme selector is a small setting inside the Proxmox VE web GUI that changes the look of the entire interface — the resource tree on the left, the tabs, the tables, all of it — between a light theme and a dark one. It's part of what Proxmox calls "My Settings," a per-user dialog for client-side preferences. Nothing about it touches your VMs, containers, or cluster configuration; it's purely cosmetic and lives entirely in your browser.

It shipped as an official feature in Proxmox VE 7.4 and has stayed in every release since, including 8.x and the current 9.x line. Before that, people were editing template files or installing community CSS injectors just to get a dark background, which is fragile because any package update can wipe out hand-edited files. The built-in version doesn't have that problem — it's a supported dropdown, not a hack.

Why Would You Use It?

Mostly it's comfort. If you're checking on a VM at 2 a.m. because a backup job alerted you, a screen full of white panels is genuinely harder on your eyes than a dark one. Some people also just find a dark UI easier to read for long stretches — less glare, less eye strain during a multi-hour migration or troubleshooting session.

There's a smaller practical reason too: consistency. If every other tool in your stack — your terminal, your code editor, Grafana, your browser chrome — is dark, having Proxmox VE stay stubbornly white is the one thing that stands out every time you tab over to it. Matching it up removes that little bit of friction.

None of this affects performance, security, or how the cluster behaves. It's worth doing purely because you're going to be staring at this interface a lot, and there's no reason to make that harder on yourself than it needs to be.

Prerequisites

• A working Proxmox VE installation you can log into — version 7.4 or newer (if you're on anything current in the 8.x or 9.x line, you're fine)
• An account with access to the web GUI (root@pam or any user that can log in normally)
• A modern browser — Firefox, Chrome, Edge, or Safari all support it
• Five minutes, honestly

You don't need shell access or root on the host for the main method. We'll only touch the command line briefly, in the troubleshooting section, and only for two commands that are safe to run as read-only checks or a simple service restart.

Step-by-Step Tutorial

Step 1: Log in to the Proxmox VE web interface

Open your browser and go to your node's address on port 8006, for example https://192.168.1.50:8006. Accept the self-signed certificate warning if this is a fresh install — that's normal and unrelated to anything we're doing here — and log in as usual.

Step 2: Find the gear icon

Look at the top-right corner of the screen. Next to your username (something like root@pam) and the help icon, there's a small gear/cog icon. That opens the My Settings dialog. This is different from the Datacenter tab on the left — Datacenter settings affect the whole cluster and every user; My Settings only affects what your browser shows you.

Step 3: Open the Color Theme dropdown

Inside My Settings, you'll see a section for interface preferences, including a dropdown labeled Color Theme. Click it and you'll get a short list of options rather than a huge theme gallery — this isn't a customization framework, just light, dark, and automatic.

Step 4: Pick a theme

Select Proxmox Dark if you just want dark mode on, full stop. If you'd rather have Proxmox VE match whatever your operating system or browser is already set to, pick Default (auto) instead — that option reads your system's light/dark preference and switches automatically, so if your OS flips to dark mode at sunset, Proxmox follows along without you touching anything.

Option	What it does	Best for
Default (light)	Standard light interface, no dark styling	People who just don't want dark mode
Proxmox Dark	Forces the dark theme regardless of OS setting	Anyone who wants dark mode always on, on any machine
Default (auto)	Follows your browser/OS light-or-dark preference	People who already use dark mode system-wide

Step 5: Apply and check the result

Click OK or Apply (the exact label depends on your version, but there's always a confirm button at the bottom of the dialog). The interface repaints immediately — you don't need to reload the page or log out.

Step 6: Repeat per browser, if needed

This is the step people miss. The Color Theme choice is stored client-side, tied to that specific browser profile. If you manage Proxmox from your laptop's Chrome and also occasionally from Firefox on a different machine, you'll need to set it in both. It isn't tied to your Proxmox user account on the server.

Step 7: Do the same for Proxmox Backup Server or Datacenter Manager, if you use them

If your homelab or company also runs Proxmox Backup Server (PBS) for offsite backups, or Proxmox Datacenter Manager (PDM) for juggling multiple clusters, each one has its own login, its own web UI, and its own separate My Settings dialog. Switching the theme in Proxmox VE has no effect on PBS or PDM — they're different products with different logins, even though they share the same look and feel. It only takes a few seconds to repeat the same three clicks in each one.

Commands Explained

There genuinely isn't a CLI command to set the theme — it's a browser-side preference, not a server config file, so there's nothing to edit on disk for this specific setting. That said, two commands are worth knowing if something around the web UI seems off after you've been poking at appearance settings or after an update:

pveversion

This prints your exact Proxmox VE version and build, for example pve-manager/8.3.1/.... Run it if you're unsure whether your install is new enough to have the Color Theme option — anything 7.4 or later has it.

systemctl restart pveproxy

This restarts the reverse proxy service that actually serves the Proxmox web GUI. It's the standard fix when the interface looks stale, half-loaded, or is showing an old cached version of itself after a pve8to9 or minor version upgrade. It doesn't touch your VMs or containers — only the web server component restarts, and the reconnect takes a couple of seconds.

Common Errors

There's no error dialog for this feature — it's a dropdown, not an API call — but a few things confuse people enough that they think something's broken:

• "I set dark mode and it went back to light." Almost always a different browser, a private/incognito window, or cleared cookies. The setting lives in that browser's storage, not on the Proxmox server.
• "Only half the page is dark." Usually a stuck cache after an update. A hard refresh (Ctrl+Shift+R or Cmd+Shift+R) or a systemctl restart pveproxy clears it up.
• "The console window (noVNC/SPICE) is still light even though the rest of the UI is dark." That's expected — the guest OS console renders whatever the VM itself is showing. Proxmox's theme only styles the management interface around it, not what's happening inside the VM.

Troubleshooting

If Default (auto) doesn't seem to be picking up your system's dark mode, the browser is the first place to check, not Proxmox. Confirm your OS is actually set to dark (Windows: Settings → Personalization → Colors; macOS: System Settings → Appearance) and that the browser itself isn't overriding it with its own forced light or dark mode in its own settings.

If you're using privacy-hardened browser profiles — things like NoScript, Arkenfox, or aggressive fingerprinting-resistance extensions — they sometimes block sites from reading your OS color-scheme preference at all, which breaks Default (auto) specifically. Proxmox VE staff have confirmed this exact behavior on the community forum: the fix isn't a Proxmox setting, it's carving out an exception for your Proxmox host in whichever privacy tool is intercepting that signal, since a local management interface on your own network isn't the kind of site those protections are meant to guard against.

If none of that applies and the dropdown still won't stick, log out completely and log back in. A stale session cookie occasionally holds onto an old preference until a fresh login overwrites it.

One more scenario worth mentioning: if you access Proxmox through a reverse proxy or a bookmarklet that strips cookies between visits — some homelab setups do this on purpose for security — the theme will never persist no matter what you pick, because the browser has nowhere to store the preference between page loads. That's not a Proxmox bug, it's just a side effect of however that particular access setup is configured. If persistence matters to you, allow cookies for that specific host rather than fighting the setting itself.

Best Practices

• If you regularly access Proxmox from more than one browser or device, just set your OS-level dark mode preference and use Default (auto) everywhere — one setting, no repeating yourself across five browser profiles.
• Don't bother with third-party CSS injector scripts you might find on GitHub for extra color schemes. They work by patching Proxmox's own template files, they aren't supported by Proxmox, and a routine apt upgrade can silently undo them or break the UI until you reapply the patch.
• If you also run Proxmox Backup Server or Proxmox Datacenter Manager, know that each has its own separate Color Theme setting in its own My Settings dialog — switching PVE to dark doesn't carry over to PBS automatically.
• On a shared workstation where multiple admins log into the same browser profile, remember the theme is tied to that browser, not to whoever's currently logged in as a Proxmox user — the next person to open the tab sees whatever was set last.

Frequently Asked Questions

Does dark mode use more or less resources on the Proxmox host?

No. It's pure CSS rendered in your browser. The Proxmox host doesn't know or care which theme you picked.

Can I set dark mode as the default for every user on my server?

Not through the GUI. There's no Datacenter-wide switch that forces a theme for every account — each user picks their own in their own My Settings dialog.

Will upgrading from Proxmox VE 8 to 9 reset my theme choice?

No, because the setting was never on the server to begin with. It lives in your browser, so it survives host upgrades and reinstalls of Proxmox itself — it only resets if you clear that browser's cookies/site data.

Is there a true black (OLED) theme, or just dark gray?

Proxmox Dark is a dark gray theme, not pure black. If you want something more aggressive, that's what the community CSS projects are for, with the update-fragility tradeoff mentioned above.

Does this affect the Proxmox VE mobile-friendly view or just desktop?

It applies to the web GUI generally, including on mobile browsers, since it's the same interface rendered responsively — there's no separate mobile app with its own settings.

I don't see a gear icon at all — am I missing a package?

No, you're not missing anything installable. Double-check you're logged into the actual node UI on port 8006 and not a reverse-proxied or embedded view that's hiding the top bar. On a standard install, the gear icon is always there next to your username once you're logged in.

Conclusion

It's a two-minute change once you know the gear icon is where you're looking, not the Datacenter tree. Pick Proxmox Dark if you want it on everywhere, or Default (auto) if you'd rather it just match whatever your OS already does. Either way, now that you know it's stored per browser, you won't be confused the next time it "resets" on a new machine — it didn't reset, it just never got set there in the first place.