Skip to content
Permalink
master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Go to file
 
 
Cannot retrieve contributors at this time

Configuration

Overview

Apart from its web configuration capabilities, the local configuration is stored in /etc/icingaweb2 by default (depending on your configuration setup).

File/Directory Description
config.ini General configuration (global, logging, themes, etc.)
resources.ini Global resources (Icinga Web 2 database for preferences and authentication, Icinga 2 IDO database)
roles.ini User specific roles (e.g. administrators) and permissions
authentication.ini Authentication backends (e.g. database)
enabledModules Symlinks to enabled modules
modules Directory for module specific configuration

General Configuration

Navigate into **Configuration > Application > General **.

This configuration is stored in the config.ini file in /etc/icingaweb2.

Global Configuration

Option Description
show_stacktraces Optional. Whether to show debug stacktraces. Defaults to 0.
module_path Optional. Specifies the directories where modules can be installed. Multiple directories must be separated with colons.
config_resource Required. Specify a defined resource name.

Example for storing the user preferences in the database resource icingaweb_db:

[global]
show_stacktraces = "0"
config_resource = "icingaweb_db"
module_path = "/usr/share/icingaweb2/modules"

Logging Configuration

Option Description
log Optional. Specifies the logging type. Can be set to syslog, file, php (web server's error log) or none.
level Optional. Specifies the logging level. Can be set to ERROR, WARNING, INFORMATION or DEBUG.
file Optional. Specifies the log file path if log is set to file.
application Optional. Specifies the application name if log is set to syslog.
facility Optional. Specifies the syslog facility if log is set to syslog. Can be set to user, local0 to local7. Defaults to user.

Example for more verbose debug logging into a file:

[logging]
log = "file"
level = "DEBUG"
file = "/usr/share/icingaweb2/log/icingaweb2.log"

Theme Configuration

Option Description
default Optional. Choose the default theme. Can be set to Icinga, high-contrast, Winter, 'colorblind' or your own installed theme. Defaults to Icinga. Note that this setting is case-sensitive because it refers to the filename of the theme.
disabled Optional. Set this to 1 if users should not be allowed to change their theme. Defaults to 0.

Example:

[themes]
disabled = "1"
default = "high-contrast"