mirror of
https://github.com/Icinga/icingaweb2.git
synced 2025-05-16 20:50:10 +02:00
34bd8e14c3
This applies a new structure for the main doc/ and modules/*/doc tree with 01-About.md 02-Installation.md ... This allows us to link from the main doc directory into module specific documentation entries. Furthermore table formatting, examples, and missing settings have been added where applicable. This patch also takes care about proper URL anchors and file names and directories. fixes #2950
45 lines
1.8 KiB
Markdown
45 lines
1.8 KiB
Markdown
# Preferences <a id="preferences"></a>
|
|
|
|
Preferences are settings a user can set for their account only,
|
|
for example the language and time zone.
|
|
|
|
Preferences can be stored either in INI files or in a MySQL or in a PostgreSQL database. By default, Icinga Web 2 stores
|
|
preferences in INI files beneath Icinga Web 2's configuration directory.
|
|
|
|
```
|
|
/etc/icingaweb2/<username>/config.ini
|
|
```
|
|
|
|
## Configuration <a id="preferences-configuration"></a>
|
|
|
|
The preference configuration backend is defined in the global [config.ini](03-Configuration.md#configuration-general-global) file.
|
|
|
|
### Store Preferences in INI Files <a id="preferences-configuration-ini"></a>
|
|
|
|
If preferences are stored in INI Files, Icinga Web 2 automatically creates one file per user using the username as
|
|
file name for storing preferences. A INI file is created once a user saves changed preferences the first time.
|
|
The files are located beneath the `preferences` directory beneath Icinga Web 2's configuration directory.
|
|
|
|
You need to add the following section to the global [config.ini](03-Configuration.md#configuration-general-global) file
|
|
in order to store preferences in a file.
|
|
|
|
```
|
|
[global]
|
|
config_backend = "ini"
|
|
```
|
|
|
|
### Store Preferences in a Database <a id="preferences-configuration-db"></a>
|
|
|
|
In order to be more flexible in distributed setups you can store preferences in a MySQL or in a PostgreSQL database.
|
|
For storing preferences in a database, you have to define a [database resource](04-Resources.md#resources-configuration-database)
|
|
which will be referenced as resource for the preferences storage.
|
|
|
|
You need to add the following section to the global [config.ini](03-Configuration.md#configuration-general-global) file
|
|
in order to store preferences in a database.
|
|
|
|
```
|
|
[global]
|
|
config_backend = "db"
|
|
config_resource = "icingaweb_db"
|
|
```
|