Skip to content

About Icinga Web 2

Icinga Web 2 is a powerful PHP framework for web applications that comes in a clean and reduced design. It’s fast, responsive, accessible and easily extensible with modules.


Icinga Web 2 can be installed easily from packages from the official package repositories. Setting it up is also easy with the web based setup wizard.

See here for more information about the installation.


Icinga Web 2 can be configured via the user interface and .ini files.

See here for more information about the configuration.


With Icinga Web 2 you can authenticate against relational databases, LDAP and more. These authentication methods can be easily configured (via the corresponding .ini file).

See here for more information about the different authentication methods available and how to configure them.


In Icinga Web 2 there are permissions and restrictions to allow and deny (respectively) roles to view or to do certain things. These roles can be assigned to users and groups.

See here for more information about authorization and how to configure roles.

User preferences

Besides the global configuration each user has individual configuration options like the interface’s language or the current timezone. They can be stored either in a database or in .ini files.

See here for more information about a user’s preferences and how to configure their storage type.


Modules extend Icinga Web 2 with additional functionality. They allow the integration of capabilities into existing views and even other modules. Be it a graph provider such as Graphite or a UI for the Icinga 2 configuration like the Director.

See here for information on how to install and configure modules.

The monitoring module

Note for Icinga DB Users

This module is only for the IDO backend. Use Icinga DB Web instead.

This is the core module for most Icinga Web 2 users.

It provides an intuitive user interface for monitoring with Icinga 2. There are lots of list and detail views (e.g. for hosts and services) you can sort and filter depending on what you want to see.

You can also control the monitoring process itself by sending external commands to Icinga. Most such actions (like rescheduling a check) can be done with just a single click in the UI.

More details about this module can be found in this chapter.


With the documentation module you can read the documentation of the framework (and any module) directly in the user interface.

The module can also export the documentation to PDF.

More details about this module can be found in this chapter.


Icinga Web 2 and all modules by Icinga utilize gettext to provide translations into other languages from the default English (en_US). However, the actual language specific files (locales) are not separately included in every project.

Icinga uses a central repository to manage locales:

If you want to provide or update a translation for your own language, please head over there where you will find instructions on how to contribute.


In the Icinga Web 2 interface even the blind can see - easy navigation with a screen reader and specific themes for different kinds of vision deficiencies make it possible for everyone to monitor their systems without impairments.