Technical

Proxmox Zitadel Login: Add Zitadel as an OIDC Identity Provider

Proxmox Zitadel Login: Add Zitadel as an OIDC Identity Provider

Proxmox Zitadel login works through OIDC, and it’s not that hard to set up. The docs cover LDAP and AD, but Zitadel needs a few specific settings on both sides. Here’s the whole thing.

Wooden blocks spelling 'Cyber Security' on a wooden grid background.

Create the Zitadel application

In Zitadel, create a new web application. Set the redirect URI to https://your-proxmox-host:8006. The port matters — Proxmox’s OIDC callback is on the web UI port, not a separate one.

Grab the client ID and client secret. You’ll need them in Proxmox. Also note your Zitadel issuer URL, like https://zitadel.example.com.

Configure the Proxmox realm

On the Proxmox node, go to Datacenter → Permissions → Realms → Add → OpenID Connect. Fill in:

  • Realm: a name like zitadel
  • Issuer URL: your Zitadel issuer URL
  • Client ID and Client Secret from Zitadel
  • Default: check if you want Zitadel to be the default realm
  • Autocreate users: check it so new users get created automatically
  • Username claim: preferred_username (Zitadel’s default)

Save it. Proxmox will fetch the OIDC discovery document from Zitadel automatically.

Wooden Scrabble tiles arranged to spell 'Phishing', illustrating online security concepts.

Map groups to roles

Zitadel groups don’t map to Proxmox roles by default. You need to add a claim mapping in Zitadel. In your Zitadel project, add a custom claim groups that returns an array of group names.

Then in Proxmox, create groups with the same names and assign roles. Go to Datacenter → Permissions → Groups, create a group, and add a role like PVEAdmin. Users in that Zitadel group will get the role.

Test the login

Log out of Proxmox and you’ll see the Zitadel realm on the login page. Click it, authenticate with Zitadel, and you’re in. If it fails, check the Proxmox syslog for OIDC errors — usually a redirect URI mismatch or a claim issue.

One thing I’d do differently: keep the local root login enabled until you’re sure Zitadel works. Locking yourself out of your own homelab is a dumb way to spend an evening.

If you want more on Proxmox permissions, check out this post on pool permissions.

Leave a comment

Comments are reviewed before they appear. Your email is never published.