Administrator Guide
Getting Started
Installation
System Configuration
Updates
User Management
Visualizations
Monitoring Configuration
Agents
Monitoring Windows
Extending Nagios
System Management
Advanced Topics
Developer Tools
Video Tutorials

System Configuration

Initial Setup

Upon the initial login to Nagios XI, you will be asked to configure a few basic system settings, such as the administrator password and the internal URL of the web interface. The following tutorial video will demonstrate the initial setup steps for Nagios XI.

Nagios XI Web Interface Setup Guide

Once the initial system configuration is complete, any of these options can be re-configured by accessing the Admin panel, under the System Configuration menu, which is located on the left side of the interface.
System Config

General Program Options

To configure general settings for the Nagios XI interface, login as the administrator and select the Admin link on the top menu bar. This will bring up the Admin dashboard, along with all of the administrative links on the left menu. To access any of the general program options, select the appropriate link under the System Configuration menu on the left side of the page.
System Config

Changing The XI System Time

This document describes how to change the system date, time, and timezone on the Nagios XI virtual machine, or a physical server running CentOS. It is intended for use by Nagios XI Administrators.

Changing The XI System Time

Email Settings

Modify the settings used by your Nagios XI system for sending email alerts and informational messages. Note: Mail messages may fail to be delivered if your XI server does not have a valid DNS name.
Email Settings

Setting Up Microsoft SMTP with OAuth 2.0

Note: This feature requires XI 5.10 or later.

This document describes how to setup OAuth 2.0 authentication for SMTP with Microsoft services such as Microsoft 365.

This document is intended for use by Nagios Administrators who want to use a Microsoft account to send emails out of Nagios XI.

Setting Up Microsoft SMTP with OAuth 2.0

Setting up Gmail SMTP With OAuth 2.0

Note: This feature requires XI 5.10 or later.

This document describes how to setup OAuth 2.0 authentication for SMTP with Google services such as Gmail.

This document is intended for use by Nagios Administrators who want to use a Gmail account to send emails out of Nagios XI.

Setting up Gmail SMTP With OAuth 2.0

Understanding Email Sending

This document describes how Nagios XI sends emails and explains how to configure your email settings. Nagios XI uses email to send notifications as well as for sending reports.

This document is intended for use by Nagios Administrators who want to understand in detail how emails are sent by Nagios XI.

Understanding Email Sending In Nagios XI

Inbound Email Commands

This document describes the inbound email commands that are accepted by Nagios XI when it receives an email response to a notification.

This document is intended for use by Nagios Users who want to respond to incidents by email.

Inbound Email Commands

Setting SMS Alerts in Nagios XI

This document describes how to setup SMS alerts and how to manage mobile carriers in Nagios XI. Notifications by SMS must be enabled per user in Nagios XI. Receiving SMS alerts allow users to get updates about their Nagios XI system via their mobile phone.

Setting SMS Alerts in Nagios XI

Nagios XI – MultiTech MTR API Integration

This document describes how to integrate the MTR API found on a MultiConnect® rCell Series Router from MultiTech with Nagios XI. It will work with Nagios XI version 5.5 and newer. Nagios XI uses this API to send text notifications to recipients.

This document is intended for use by Nagios Administrators experienced with installing and configuring network devices.

Nagios XI – MultiTech MTR API Integration

Nagios XI – Using DUO Two Factor Authentication

This document describes how to configure Nagios XI to use DUO for two factor authentication (2FA). Nagios XI already provides email 2FA however DUO can be used instead, this makes 2FA more accessible on more devices.

This document is intended for use by Nagios Administrators that need to configure DUO on Nagios XI.

Nagios XI – Using DUO Two Factor Authentication

Nagios XI – Twilio SMS Integration

This document describes how to integrate Twilio component with Nagios XI for notification. The Twilio SMS component provides outbound SMS notifications from Nagios XI, thereby increasing the flexibility, reliability and dependability of receiving critical alerts and notifications.

This document is intended for use by Nagios Administrators who wish to integrate Twilio with Nagios XI to receive SMS alerts without using an email setup.

Nagios XI – Twilio SMS Integration

Configuring Core Contacts to Use XI's phpmailer SMTP Settings

This document describes how to configure non-XI user (Core) contacts to use the SMTP phpmailer settings from the email management interface.

This document is intended for use by Nagios XI Administrators who wish to configure Core contacts to use the XI email configuration (including SMTP relay settings) without the (previously) required link to an XI user.

Configuring Core Contacts to Use XI's PHP Mailer

XI Notification Escalations

This document describes how to setup host and service escalations in Nagios XI. Escalations happen when a solution is not produced for a host or service in a specified response time. When this occurs, notifications are sent to another level of contacts so issues are not overlooked. Escalations provide a way to notify the appropriate people of issues and make sure that issues receive the proper visibility and are resolved.

XI Notification Escalations

XI Details Overview

This document explains how to utilize the different features of the Nagios® XI™ interface to view detail information about hosts and services. The Details menu offers many different ways to view the status of your hosts and services. In larger environments users may want to view status by host or service group, yet smaller environments may prefer to view status by device.

XI Details Overview

Understanding And Using XI Dashboards

Dashboards are a powerful feature of Nagios XI designed to provide individual users with customized information they find useful. Dashboards are often used to display important, relevant information where it is needed most. Dashboards are specific to individual Nagios XI users. Each user can create their own unique set of dashboards to customize Nagios XI to fit their needs. This document describes Nagios XI dashboards, what they can be used for, and how they can be managed.

Understanding And Using XI Dashboards

Understanding And Using Nagios XI Views

Views are designed to provide individual users with quick access to Nagios XI pages and external websites they find useful. They are often used by network administrators who wish to display important information on wall monitors in network operations centers (NOCs) or public locations. This document describes Nagios XI views, what they are used for, and how they can be managed.

Understanding And Using XI Views

Customizing The XI Landing Page

This document describes how to customize the landing page that users see when they initially login to the Nagios® XI™ web interface. One of the benefits of Nagios XI is the flexibility to customize the information users see in the web interface. Customizing the landing (home) page within Nagios XI will allow users to get the most important information as soon as they log into Nagios XI.

Customizing The XI Landing Page

Security Credentials

Use this form to reset various internal security credentials used by your XI system. This is an important step to ensure your XI system does not use default passwords or tokens, which may leave it open to a security breach. The Component credentials are used to manage various aspects of the XI system. Remember these passwords! The Sub-System Credentials are only used internally by the XI system. You do not need to remember them.
Reset Security Credentials

License Settings

The License Information page allows you to update and view your current licensing information for Nagios XI. License

Activating Your Nagios XI License

This document describes how to activate your Nagios XI license key. License activation is required for Nagios XI 2011.

Activating Your Nagios XI License

Nagios XI - Best Practices

This document covers various “best practices” which can be applied to your Nagios XI server. It accompanies the presentation from the Nagios World Conference 2015 by Troy Lea.

This document is intended for use by Nagios XI Administrators as a guide to understand how to get the most out of Nagios XI. It covers a range of topics such as how to get the most out of XI, things you wish you knew, and configuration practices.

Nagios XI Best Practices