- Published on
Nagios XI Offline Upgrade: Fix a Version That Won’t Update
- Last Updated November 20, 2026
You just finished a Nagios XI offline upgrade, and everything seemed to go smoothly. But when you log in, the version number hasn’t changed. Frustrating, right? The good news is this is a known issue with a quick fix.
In this article, we’ll walk through why a Nagios XI offline upgrade can leave you on the old version, what to check before you start, and the simple steps to finish the upgrade so you’re running the version you expected.
Note: Nagios XI offline upgrades are only available on RHEL-based systems.
Signs Your Nagios XI Offline Upgrade Didn’t Finish
You ran the offline upgrade, and everything looked like it finished normally. But:
- Nagios XI still shows the version you had before.
- You’re still getting a notice that an update is available.
- When you run the upgrade again, it tells you everything is already installed and there’s nothing to do.
Why the Version Doesn’t Update
An upgrade happens in two parts. First, the new files get installed on your server. Then a follow-up script runs to finish the job by updating the database and the rest of the application.
Sometimes that second part doesn’t finish. Your server sees the new files and treats the upgrade as complete, but Nagios XI itself never got fully updated. That’s also why running the upgrade again doesn’t help: your server thinks there’s nothing left to do.
Common Causes
- Security settings that block scripts from running in the server’s temporary folder (
/tmp). This is common on servers that follow strict hardening guidelines. - A settings file pointing to the wrong database service name.
Sometimes there’s no clear reason, and that’s okay. The steps below will still get you sorted out.
Before You Start
- Take a backup or snapshot of your Nagios XI server. The fix makes changes to your database, so it’s always good to have a way back. If you need help, see our guide to Nagios XI backup and restore options.
- Expect a short pause in monitoring. You’ll restart Nagios at the end, which takes a moment.
- Check whether your temporary folder allows scripts to run. Run this command:
findmnt -no OPTIONS /tmpIf you see the word noexec in the result, scripts are being blocked there, and the fix may not work until that’s changed. Check with your system administrator before going further.
How to Finish the Nagios XI Offline Upgrade
You will need to establish a terminal session as a root user to complete these steps.
- Go to the folder where you ran the offline upgrade:
cd <OFFLINE_INSTALLER_DIR>/offline-nagiosxi- Run these commands to finish the upgrade. Replace
<VERSION>with the version you upgraded to.
rpm2cpio nagiosxi-<VERSION>*.rpm | cpio -idmv
cd tmp/nagiosxi
chmod +x rpmupgrade
./rpmupgradeTip: If you have more than one Nagios XI installer file in that folder, type out the full file name so the right one is used.
- Restart Nagios:
systemctl restart nagios npcdHow to Confirm the Upgrade Worked
Log back in to Nagios XI and check that:
- The version number matches the one you upgraded to.
- The update available notice is gone.
- Your hosts and services are updating like normal.
Frequently Asked Questions
Do I need internet access to run these steps?
No. Everything you need is already in the offline installer folder on your server, so these steps work on systems without internet access.
Will this change my monitoring setup?
These commands run the same final upgrade step that normally runs on its own during a Nagios XI offline upgrade, so your setup is handled the same way it would be in a normal upgrade. That said, it’s always a good idea to take a backup first, just in case.
What if I already deleted the offline installer folder?
Download the offline installer for the same Nagios XI version and RHEL release from the Nagios offline repository. The file name shows both. For example, nagiosxi-2026R2-1.el9.x86_64.tar.gz is Nagios XI 2026R2 for RHEL 9. Copy it to your server, extract it, then follow the steps above from that folder.
Can this happen with online upgrades too?
Yes, it can. This article covers the offline installer, so if you upgraded online and are seeing the same thing, open a Support Case, and we’ll help you through it.
Conclusion
When Nagios XI keeps showing the old version after an offline upgrade, it almost always means the final step of the upgrade didn’t finish. By running that step yourself and restarting Nagios, you can complete your Nagios XI offline upgrade in just a few minutes and get back to monitoring on the latest version.
Need a Hand?
If the version still hasn’t changed, or you saw errors when running the commands, open a Support Case and we’ll be happy to take a look. To help us resolve it faster, please send along:
- Any messages you saw when running
./rpmupgrade - These two log files:
/usr/local/nagiosxi/tmp/upgrade.log/tmp/xi-upgrade.log
- A Diagnostic Profile from your Nagios XI server




