If you’re running Proxmox VE in a homelab or for non-production use, you’ve undoubtedly been greeted by the “No valid subscription” pop-up every time you log in. While it’s a minor annoyance, it can disrupt your workflow.
The good news? You can safely and legally remove this message.
This guide will walk you through exactly how to disable the pop-up, explain why it’s perfectly fine to do so, and show you the crucial final step to ensure your server still gets updates.
First Things First: Is This Legal and Safe?
Let’s get the two most important questions out of the way.
Is it Legal? Yes, 100% legal. Proxmox VE is powerful, free, and open-source software published under the GNU AGPL, v3 license. You are not required to purchase a subscription to use its full feature set. The subscription model is for enterprise users who need professional support and access to the heavily tested enterprise software repositories. Removing a cosmetic pop-up does not violate the license.
Is it Safe? Yes, it is safe if you follow the steps correctly. We will be making a minor edit to a single JavaScript file that generates the pop-up. The risk is extremely low, and we’ll make a backup first, just in case. The only thing to remember is that a future Proxmox update will likely undo this change, and you’ll have to re-apply it.
Step-by-Step: Removing the Subscription Message
You will need to be logged into your Proxmox server’s shell to perform these steps. You can do this via SSH or by selecting your node in the web UI and opening the >_ Shell.
Step 1: Navigate to the JavaScript Directory
First, we need to change into the directory that holds the file we need to edit.
cd /usr/share/javascript/proxmox-widget-toolkit/
Step 2: Back Up the Original File (Important!)
Never edit a system file without making a backup first. This command creates a copy of the file named proxmoxlib.js.bak that you can restore if anything goes wrong.
cp proxmoxlib.js proxmoxlib.js.bak
Step 3: Edit the JavaScript File
We will use the sed command to perform a find-and-replace operation on the file. This command finds the specific line of code that shows the message box and effectively comments it out by replacing it with void().
This single command does all the work. Copy and paste it directly into your shell and press Enter.
sed -Ezi.bak "s/(Ext.Msg.show\(\{\s+title: gettext\('No valid sub)/void\(\{ \/\/\1/g" proxmoxlib.js
What does this command do? It finds the Ext.Msg.show() function responsible for the pop-up and replaces it with void({, which does nothing. This is a clean way to disable the function without deleting the code.
Step 4: Restart the Proxmox Web Service
The changes won’t take effect until you restart the service that runs the web interface.
systemctl restart pveproxy.service
Step 5: Clear Your Browser Cache
Your browser has likely saved the old version of the JavaScript file. To see the change, you must force your browser to download the new one.
Windows/Linux: Press
Ctrl + F5Mac: Press
Cmd + Shift + R
Log back into your Proxmox web UI. The subscription message should now be gone!
Crucial Final Step: Configure No-Subscription Repositories
Removing the pop-up is only half the battle. If you don’t have a subscription, you also need to tell Proxmox to get updates from the public “no-subscription” repository. Otherwise, your server will never receive updates.
In the Proxmox Web UI, navigate to
Datacenter->Your Node->Updates->Repositories.Select the
enterprise.proxmox.comrepository and click the Disable button.Click the Add button.
In the “Add new repository” window, select the
No-Subscriptionrepository from the dropdown menu.Click Add.
Now, go to Updates and click Refresh. You should see the update check run successfully, pulling packages from the pve-no-subscription repository. Your Proxmox server is now correctly configured for updates without a subscription.
Conclusion
That’s all there is to it. With one simple command and a quick repository adjustment, you’ve streamlined your Proxmox login experience while ensuring your system stays secure and up-to-date. This small tweak is one of the best quality-of-life improvements you can make for any homelab or testing environment.
What other Proxmox tips do you rely on? Share your favorites in the comments below!
🔗 Useful Links 📺 EngineerHow YouTube Channel
📢 About EngineerHow.com EngineerHow.com is dedicated to providing expert IT and engineering tutorials, helping professionals and enthusiasts set up servers, networks, and self-hosted solutions. Our guides focus on step-by-step instructions to make complex topics easy to understand. 🚀 Explore More IT Guides: EngineerHow.com
💬 Join the Discussion! Have questions or insights? Drop a comment below and let’s discuss!
