"Fossies" - the Fresh Open Source Software Archive

Member "icingaweb2-2.11.4/doc/03-Configuration.md" (26 Jan 2023, 3655 Bytes) of package /linux/www/icingaweb2-2.11.4.tar.gz:

As a special service "Fossies" has tried to format the requested source page into HTML format (assuming markdown format). Alternatively you can here view or download the uninterpreted source code file. A member file download can also be achieved by clicking within a package contents listing on the according byte size field. See also the last Fossies "Diffs" side-by-side code changes report for "03-Configuration.md": 2.10.3_vs_2.11.0.

A hint: This file contains one or more very long lines, so maybe it is better readable using the pure text view mode that shows the contents as wrapped lines within the browser window.

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"