Admin: New server guide

2026-04-14T10:02:19Z

New server guide

New page

This article guides you through the installation and basic configuration of Nagios Core, a powerful open-source monitoring system, on a Linux server. Nagios Core allows you to proactively monitor your infrastructure, ensuring services are up and running and alerting you to potential issues before they impact your users. This is crucial for maintaining the reliability and performance of your servers, especially when hosting critical applications or websites.

== Prerequisites ==

Before you begin, ensure you have the following:

* A Linux server with root or sudo privileges. A dedicated server from [https://powervps.net/?from=32 PowerVPS] with full root access provides the ideal environment for running Nagios Core without resource contention.
* A stable internet connection to download necessary packages.
* Basic understanding of Linux command line operations.
* Web server (Apache is recommended) and PHP installed.
* Development tools (compiler, make, etc.) for compiling Nagios.

== Installing Nagios Core ==

We will install Nagios Core from source to ensure we have the latest stable version and full control over the configuration.

=== Update System Packages ===

It's always a good practice to update your system's package list and upgrade existing packages to their latest versions.

<pre>
sudo apt update && sudo apt upgrade -y
</pre>

This command refreshes the list of available packages and installs any security updates or newer versions of installed software.

=== Install Required Dependencies ===

Nagios Core requires several development libraries and tools to compile correctly.

<pre>
sudo apt install -y build-essential libgd2-dev libssl-dev libapache2-mod-php unzip libtool libltdl-dev libperl-dev libxslt1-dev automake autoconf
</pre>

* `build-essential`: Provides essential tools for compiling software.
* `libgd2-dev`: Required for creating PNG images used in the Nagios web interface.
* `libssl-dev`: For secure communication (HTTPS).
* `libapache2-mod-php`: Enables PHP processing for the Nagios web interface.
* `unzip`: For extracting downloaded archives.
* `libtool`, `libltdl-dev`, `libperl-dev`, `libxslt1-dev`, `automake`, `autoconf`: Development libraries and tools necessary for the build process.

=== Download Nagios Core ===

Download the latest stable release of Nagios Core from the official website. You can find the latest version at [https://www.nagios.org/downloads/nagios-core/].

<pre>
wget https://assets.nagios-plugins.org/nagios-core/releases/nagios-core-4.4.6.tar.gz
tar -xvzf nagios-core-4.4.6.tar.gz
cd nagios-core-4.4.6
</pre>

* `wget`: Downloads the compressed tarball.
* `tar -xvzf`: Extracts the tarball.
* `cd`: Navigates into the extracted directory.

=== Compile and Install Nagios Core ===

Now, we'll compile and install Nagios Core.

<pre>
./configure --with-command-group=nagios
make all
sudo make install
sudo make install-init
sudo make install-daemon-config
sudo make install-commandmode
</pre>

* `./configure --with-command-group=nagios`: Configures the build process. The `--with-command-group=nagios` option ensures that the Nagios daemon runs with the `nagios` user and group, which is crucial for security.
* `make all`: Compiles the Nagios Core source code.
* `sudo make install`: Installs the Nagios binaries, configuration files, and documentation.
* `sudo make install-init`: Installs the init script for starting/stopping Nagios.
* `sudo make install-daemon-config`: Installs the default Nagios daemon configuration file.
* `sudo make install-commandmode`: Sets up the permissions for the CGI commands.

=== Create Nagios User and Group ===

Nagios runs as a dedicated user for security best practices.

<pre>
sudo make install-usergroup
</pre>

This command creates the `nagios` user and group if they don't already exist and assigns ownership of Nagios files and directories to them.

=== Install Nagios Plugins ===

Nagios needs plugins to check the status of various services.

<pre>
cd ..
wget https://nagios-plugins.org/download/nagios-plugins-2.3.3.tar.gz
tar -xvzf nagios-plugins-2.3.3.tar.gz
cd nagios-plugins-2.3.3
./configure --with-nagios-user=nagios --with-nagios-group=nagios
make
sudo make install
</pre>

* `cd ..`: Navigates back to the parent directory.
* Download and extract the Nagios plugins similar to Nagios Core.
* `./configure --with-nagios-user=nagios --with-nagios-group=nagios`: Configures the plugins to use the `nagios` user and group.
* `make` and `sudo make install`: Compiles and installs the plugins.

== Configure the Web Interface ==

To access Nagios through a web browser, we need to configure Apache.

=== Install Apache and PHP ===

If you haven't already, install Apache and PHP.

<pre>
sudo apt install -y apache2 php libapache2-mod-php
</pre>

=== Configure Apache for Nagios ===

Copy the sample Apache configuration file for Nagios and enable it.

<pre>
sudo cp /opt/nagios/etc/cgi.cfg /opt/nagios/etc/cgi.cfg.bak
sudo cp /opt/nagios/etc/objects/cgi.cfg /opt/nagios/etc/objects/cgi.cfg.bak
sudo cp /opt/nagios/etc/objects/apache2.conf /etc/apache2/sites-available/nagios.conf
sudo a2ensite nagios.conf
sudo systemctl restart apache2
</pre>

* The `cp` commands create backups of important configuration files.
* `sudo cp /opt/nagios/etc/objects/apache2.conf /etc/apache2/sites-available/nagios.conf`: Copies the sample Apache configuration for Nagios to the Apache sites-available directory.
* `sudo a2ensite nagios.conf`: Enables the Nagios Apache site.
* `sudo systemctl restart apache2`: Restarts Apache to apply the new configuration.

=== Create Nagios Admin User ===

Create a user for accessing the Nagios web interface.

<pre>
sudo htpasswd -c /opt/nagios/etc/htpasswd.users nagiosadmin
</pre>

Enter a strong password when prompted. This creates an encrypted password file for authentication.

=== Configure Nagios Configuration Files ===

Edit the main Nagios configuration file to define basic settings.

<pre>
sudo nano /opt/nagios/etc/nagios.conf
</pre>

Ensure the following lines are present and correctly configured:

<pre>
cfg_file=/opt/nagios/etc/objects/localhost.cfg
</pre>

You might also want to adjust `log_file` and `status_file` paths if needed.

Next, configure the `cgi.cfg` file to point to the correct directories.

<pre>
sudo nano /opt/nagios/etc/cgi.cfg
</pre>

Make sure these lines are uncommented and correct:

<pre>
nagios_log_file=/opt/nagios/var/nagios.log
status_file=/opt/nagios/var/status.dat
object_cache_file=/opt/nagios/var/objects.cache
resource_file=/opt/nagios/etc/resource.cfg
</pre>

You'll also need to edit the `resource.cfg` to set your password for external commands (if you plan to use them).

<pre>
sudo nano /opt/nagios/etc/resource.cfg
</pre>

Uncomment and set the `$USER1$` and `$USER2$` variables:

<pre>
$USER1$=/opt/nagios/libexec
$USER2$=/opt/nagios/var/spool/nagios.cmd
</pre>

=== Restart Nagios and Apache ===

Apply all changes by restarting the Nagios service and Apache.

<pre>
sudo systemctl restart nagios
sudo systemctl restart apache2
</pre>

== Accessing the Nagios Web Interface ==

Open your web browser and navigate to:

`http://your_server_ip/nagios`

Log in using the `nagiosadmin` username and the password you created. You should see the Nagios Core dashboard.

== Basic Monitoring Configuration ==

Nagios uses configuration files to define hosts, services, and contacts. The primary configuration file is `nagios.cfg`, and host/service definitions are typically in separate files within the `objects` directory.

=== Monitoring the Local Host ===

Nagios is pre-configured to monitor the local host (`localhost`). This is a good starting point to verify your installation.

The configuration for `localhost` is usually in `/opt/nagios/etc/objects/localhost.cfg`. You can examine this file to understand how hosts and services are defined.

=== Adding a New Host ===

To monitor another server, you'll need to create a new host definition.

1. **Create a new host configuration file:**
<pre>
sudo nano /opt/nagios/etc/objects/my_server.cfg
</pre>

2. **Add the host definition:**
<pre>
define host{
use linux-server
host_name my-remote-server
alias My Remote Server
address 192.168.1.100
max_check_attempts 5
check_period 24x7
notification_interval 30
notification_period 24x7
contact_groups admins
}
</pre>

* `use linux-server`: Inherits settings from the `linux-server` template defined in `templates.cfg`.
* `host_name`: A unique name for the host.
* `alias`: A more descriptive name.
* `address`: The IP address or hostname of the server to monitor.
* `max_check_attempts`: Number of times to check before assuming the host is down.
* `check_period`: When checks should be performed.
* `notification_interval`: How often to send notifications if the host is down.
* `notification_period`: When notifications should be sent.
* `contact_groups`: Assigns the host to a contact group.

3. **Add the new configuration file to `nagios.cfg`:**
Edit your main Nagios configuration file:
<pre>
sudo nano /opt/nagios/etc/nagios.cfg
</pre>
Add the following line to include your new host configuration:
<pre>
cfg_file=/opt/nagios/etc/objects/my_server.cfg
</pre>

4. **Verify Nagios Configuration:**
Before restarting, always verify your configuration for syntax errors.
<pre>
sudo /opt/nagios/bin/nagios -v /opt/nagios/etc/nagios.cfg
</pre>
If there are no errors, you'll see output indicating successful verification.

5. **Restart Nagios:**
<pre>
sudo systemctl restart nagios
</pre>

=== Adding a New Service ===

Now, let's define a service to check on the `my-remote-server`.

1. **Edit the host configuration file (`my_server.cfg`):**
<pre>
sudo nano /opt/nagios/etc/objects/my_server.cfg
</pre>

2. **Add the service definition:**
Add the following block after the host definition:
<pre>
define service{
use generic-service
host_name my-remote-server
service_description HTTP
check_command check_http! -H my-remote-server
check_period 24x7
max_check_attempts 3
normal_check_interval 5
retry_check_interval 2
notification_interval 60
notification_period 24x7
notification_options w,u,c,r
contact_groups admins
}
</pre>

* `use generic-service`: Inherits settings from the `generic-service` template.
* `host_name`: The host this service belongs to.
* `service_description`: A descriptive name for the service.
* `check_command`: Specifies the plugin and arguments to use for checking. `check_http!` is a built-in command for checking HTTP services.
* `normal_check_interval`: How often to check the service when it's OK.
* `retry_check_interval`: How often to check the service when it's in a warning or critical state.
* `notification_options`: When to send notifications (warning, unknown, critical, recovery).

3. **Verify and Restart Nagios:**
<pre>
sudo /opt/nagios/bin/nagios -v /opt/nagios/etc/nagios.cfg
sudo systemctl restart nagios
</pre>

After a few minutes, you should see the new host and service appear in the Nagios web interface.

== Troubleshooting ==

=== "Forbidden" Error in Web Interface ===

If you encounter a "Forbidden" error when trying to access the Nagios web interface, it's likely a permissions issue with the CGI scripts.

* **Check Apache Configuration:** Ensure the `ScriptAlias` directives in `/opt/nagios/etc/objects/apache2.conf` are correctly pointing to your Nagios CGI directory.
* **Permissions:** Verify that the `/opt/nagios/sbin` directory and its contents are executable by the Apache user (often `www-data`).
<pre>
sudo chown -R nagios:nagios /opt/nagios/sbin
sudo chmod +x /opt/nagios/sbin/*
</pre>
* **Apache User:** Make sure the Apache user is part of the `nagios` group.
<pre>
sudo usermod -a -G nagios www-data
sudo systemctl restart apache2
</pre>

=== Nagios Service Not Starting ===

If the Nagios service fails to start, check the Nagios log file for errors.

<pre>
sudo tail -f /opt/nagios/var/nagios.log
</pre>

Common issues include:
* **Syntax Errors in Configuration Files:** Use `sudo /opt/nagios/bin/nagios -v /opt/nagios/etc/nagios.cfg` to check for errors.
* **Permissions:** Ensure the `nagios` user has read access to configuration files and write access to log and spool directories (`/opt/nagios/var/`).
* **Missing Plugins:** Verify that all plugins specified in your `check_command` directives are installed and executable.

=== Host/Service Not Showing Up ===

* **Configuration Verification:** Always run `sudo /opt/nagios/bin/nagios -v /opt/nagios/etc/nagios.cfg` after making changes.
* **Included Configuration Files:** Ensure that your custom configuration files (e.g., `my_server.cfg`) are correctly listed in `nagios.cfg`.
* **Typographical Errors:** Double-check `host_name`, `service_description`, and `host_name` references in service definitions for any typos.

== Further Steps ==

* **Contact Definitions:** Define contacts and contact groups to receive notifications.
* **Notification Commands:** Configure commands to send notifications via email, SMS, or other methods.
* **Advanced Plugins:** Explore the vast array of available Nagios plugins for monitoring almost any service.
* **Performance Tuning:** Optimize Nagios for larger environments.
* **Security Hardening:** Secure your Nagios installation further.

By following these steps, you can establish a robust monitoring system for your servers, ensuring high availability and quick response to issues. For demanding workloads, consider dedicated servers from [https://powervps.net/?from=32 PowerVPS] to guarantee optimal performance for your Nagios Core instance.

[[Category:Monitoring]]
[[Category:Linux Administration]]
[[Category:Server Management]]

Setting Up Nagios Monitoring - Revision history

Admin: New server guide