3.8 KiB

Raw Blame History

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_backend	Optional. Select the user preference storage. Can be set to `ini` (default), `db` or `none`. If `db` is selected, this requires the `config_resource` attribute.
config_resource	Optional. Specify a defined resource name. Can only be used if `config_backend` is set to `db`.

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

[global]
show_stacktraces = "0"
config_backend = "db"
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"

3.8 KiB Raw Blame History