{"id":7829,"date":"2020-03-19T16:26:11","date_gmt":"2020-03-19T13:26:11","guid":{"rendered":"http:\/\/unihost.com\/help\/?p=7829"},"modified":"2026-11-06T15:17:41","modified_gmt":"2026-11-06T12:17:41","slug":"upgrade-nagios-core-to-the-latest-version","status":"publish","type":"post","link":"https:\/\/unihost.com\/help\/upgrade-nagios-core-to-the-latest-version\/","title":{"rendered":"How to Upgrade Nagios Core to the Latest Version"},"content":{"rendered":"
\n

To upgrade Nagios Core without losing configuration, check your installed version, back up the existing installation, download the latest stable source release, and run configure, make all, and make install. Validate the configuration using nagios -v before restarting the monitoring service. This procedure applies to existing source-based Nagios Core installations.<\/p>\n

Compatibility: Ubuntu 22.04\/24.04, Debian 12, Rocky Linux 9 and AlmaLinux 9; source-installed Nagios Core 4.x. Commands use standard Nagios Core and Linux utilities.<\/strong><\/p>\n

Requirements<\/h2>\n

You need SSH or console access with sudo privileges, a source-installed Nagios Core under \/usr\/local\/nagios, available disk space, build tools, and a maintenance window. Back up custom plugins and system integration files as well.<\/p>\n

Ubuntu 22.04\/24.04 and Debian 12:<\/strong><\/p>\n

sudo apt update\r\nsudo apt install -y build-essential wget tar libgd-dev libssl-dev<\/pre>\n
Rocky Linux 9 and AlmaLinux 9:<\/strong><\/p>\n
sudo dnf install -y gcc make wget tar gd-devel openssl-devel<\/pre>\n
This procedure is for source-based installations. For Nagios Core installed through a package manager, use the distribution packages instead. Nagios XI has a separate upgrade procedure.<\/p>\n
Steps<\/h2>\n
Step 1. Check your installed version<\/h3>\n
Check the current Nagios Core version and validate its configuration before changing any files.<\/p>\n
\/usr\/local\/nagios\/bin\/nagios --version\r\nsudo \/usr\/local\/nagios\/bin\/nagios -v \/usr\/local\/nagios\/etc\/nagios.cfg<\/pre>\n
Check the latest stable release on the official Nagios Core versions page. Set the version variable for the release you intend to install: Official Nagios Core releases<\/a><\/p>\n
NAGIOS_VERSION="4.5.14"<\/pre>\n
Step 2. Back up Nagios<\/h3>\n
Back up configuration, runtime data, and a full copy of the installation. Keep a copy outside the server. The full archive is needed if you must restore the previous binaries.<\/p>\n
sudo tar -czf \/root\/nagios-backup.tar.gz -C \/ usr\/local\/nagios\/etc usr\/local\/nagios\/var\r\nsudo tar -czf \/root\/nagios-full-backup.tar.gz -C \/ usr\/local\/nagios<\/pre>\n
Step 3. Download the source release<\/h3>\n
Download the selected official source archive using the version variable. The commands run from a temporary working directory.<\/p>\n
cd \/tmp\r\nwget -O nagioscore.tar.gz "https:\/\/github.com\/NagiosEnterprises\/nagioscore\/archive\/refs\/tags\/nagios-${NAGIOS_VERSION}.tar.gz"\r\ntar -xzf nagioscore.tar.gz\r\ncd "nagioscore-nagios-${NAGIOS_VERSION}"<\/pre>\n
Step 4. Compile and install<\/h3>\n
Use the same configure options as your existing installation, including any custom command group. Stop Nagios just before installing the new binaries. Do not run make install-config during a routine upgrade, because existing settings must be retained.<\/p>\n
.\/configure\r\nmake all\r\nsudo systemctl stop nagios\r\nsudo make install<\/pre>\n
Step 5. Validate and start Nagios<\/h3>\n
Verify the configuration before starting the updated daemon. If verification fails, correct the errors or restore your backup instead of starting the service.<\/p>\n
sudo \/usr\/local\/nagios\/bin\/nagios -v \/usr\/local\/nagios\/etc\/nagios.cfg\r\nsudo systemctl start nagios<\/pre>\n
Verify<\/h2>\n
Check the installed release, service status, and the web interface. Confirm hosts, service checks, and notifications still work.<\/p>\n
\/usr\/local\/nagios\/bin\/nagios --version\r\nsystemctl is-active nagios<\/pre>\n
Troubleshooting<\/h2>\n
Nagios fails to start<\/h3>\n
Validate nagios.cfg and inspect the systemd log for configuration, permission, or module errors.<\/p>\n
sudo \/usr\/local\/nagios\/bin\/nagios -v \/usr\/local\/nagios\/etc\/nagios.cfg\r\nsudo journalctl -u nagios -n 50 --no-pager<\/pre>\n
Compilation fails<\/h3>\n
Review the configure or make error and confirm required development libraries are installed. Reuse any non-default configure flags from the old installation.<\/p>\n
Rollback after an unsuccessful upgrade<\/h3>\n
Stop Nagios, restore the complete installation from the saved archive, validate the old configuration, and start the service again. A server snapshot is preferable when external plugins or system service files were changed.<\/p>\n
sudo systemctl stop nagios\r\nsudo tar -xzf \/root\/nagios-full-backup.tar.gz -C \/\r\nsudo \/usr\/local\/nagios\/bin\/nagios -v \/usr\/local\/nagios\/etc\/nagios.cfg\r\nsudo systemctl start nagios<\/pre>\n
Nagios Core vs Nagios XI<\/h3>\n
Nagios Core is an open-source monitoring engine, usually configured through files. Nagios XI is a commercial product with additional management and reporting tools. Never use these Core source-upgrade steps on Nagios XI; follow the official Nagios XI update procedure.<\/p>\n
FAQ<\/h2>\n
Will the upgrade overwrite my configuration?<\/h3>\n
A normal source upgrade with make install preserves existing configuration. Do not run make install-config, and always take a backup first.<\/p>\n
How do I check my Nagios version?<\/h3>\n
Run \/usr\/local\/nagios\/bin\/nagios –version on the server.<\/p>\n
How do I roll back a failed upgrade?<\/h3>\n
Stop Nagios, restore the full installation or server snapshot, validate nagios.cfg, and start Nagios.<\/p>\n
What is the difference between Nagios Core and Nagios XI?<\/h3>\n
Nagios Core is an open-source monitoring engine. Nagios XI is a commercial management and reporting product and uses a separate upgrade procedure.<\/p>\n
Related Articles<\/h2>\n