If you just installed Proxmox VE and you’re seeing a “No valid subscription” popup every time you log into the web UI — or apt update is failing with a 401 error — don’t panic. Nothing is broken. This is expected behavior on a fresh install without a paid subscription, and it’s a two-minute fix.

There are actually two separate issues hiding under one confusing message, and most guides mix them together. Let’s untangle them.

Why This Happens

Proxmox VE ships configured to pull updates from the Enterprise Repository by default — the one meant for paying customers with a support subscription. If you don’t have one (which is completely normal for a home lab), two things go wrong:

  1. apt update fails, because your system can’t authenticate against the enterprise repo without a valid subscription key.
  2. The web UI shows a popup on every login, because Proxmox actively checks your subscription status and reminds you it’s missing.

These are two different problems with two different fixes. Fixing one does not fix the other.

Fix 1: Switch to the No-Subscription Repository

This is the important one — it’s what actually gets your system updating again.

Via the web UI:

Go to Datacenter → Node → Repositories. You’ll see the enterprise repository listed and enabled. Disable it, then add the No-Subscription repository instead. Proxmox’s own repository manager lists this as a selectable option, so you don’t need to type anything by hand.

Via SSH:

If you prefer the terminal, you’re editing the repository file directly — disabling the enterprise source and pointing apt at the public no-subscription mirror instead. The exact file path differs slightly between versions:

  • On Proxmox VE 8 (Debian 12 “bookworm”), the enterprise source lives in /etc/apt/sources.list.d/pve-enterprise.list.
  • On Proxmox VE 9 (Debian 13 “trixie”), Proxmox moved to the newer .sources deb822 format, so you’ll find it under /etc/apt/sources.list.d/pve-enterprise.sources instead.

Comment out or remove the enterprise entry, add the no-subscription equivalent, then run apt update again. It should complete without errors.

Note if you’re planning to move to PVE 9 soon: Proxmox VE 8 is approaching end of support later in 2026, so if you’re setting up a new lab right now, it’s worth checking whether you should start directly on PVE 9 instead of 8.

Fix 2: Remove the Login Popup

This one is purely cosmetic — it doesn’t affect functionality at all, your VMs and containers run exactly the same with or without it. Some people leave it as-is intentionally (see the note below on why). If it bothers you, here’s what’s going on and how to deal with it.

The popup is triggered by a small check inside Proxmox’s web UI JavaScript (proxmoxlib.js), which calls the subscription-check function on every page load. Removing the popup means patching that specific function so it always resolves as if the check passed.

Two important caveats:

  • This patch does not survive updates. Every time pve-manager gets updated, the JS file is reset to its original state and the popup comes back. You’ll need to reapply the patch, or set it up as an apt hook so it reapplies automatically after every apt upgrade.
  • Several community scripts automate this (search for “Proxmox no-nag script” or check the Proxmox VE Helper-Scripts community project) if you’d rather not hand-edit the JS file yourself and re-run it after each update.

A Quick Ethical Note

For a home lab, disabling the popup is genuinely fine — there’s no functional difference, and you’re not depriving anyone of anything. But if you’re running Proxmox in a business or production environment, please consider actually buying a subscription. It’s what funds continued development of the software you’re relying on, and enterprise support tiers exist precisely for cases where downtime costs real money.

FAQ

Will “No valid subscription” ever go away permanently without buying one? The apt error goes away once you switch to the no-subscription repository (Fix 1) — permanently, no reapplying needed. The UI popup (Fix 2) will keep coming back after every pve-manager update unless you automate the patch.

Does the subscription warning affect my VMs or containers? No. It’s purely informational. Your workloads run identically regardless of subscription status.

Is the no-subscription repository safe to use long-term? Yes — it’s the same package repository most home lab and small-scale Proxmox installs run on. It’s just less tested before release than the enterprise channel, which matters more for production environments than for a home lab.

New to home labs entirely? Start with our beginner’s guide to building your first home lab before diving into Proxmox-specific fixes like this one.