System Configuration#

Configuring a Znuny is done via Managing Entities, plus all the add-on and framework settings found here. Whereas the aforementioned Managing Entities, allows administrators to make settings for the basic usage like queues, states, email addresses, etc. The system configuration allows the administrator to fine tune settings which are system-wide. These include, but are not limited to:

  • Visible fields in screens

  • Module permissions and availability

  • Outgoing email

  • Paths, variables and binaries

  • State type defaults

  • Support Languages

  • Working Calendars

  • Customer User Self-Registration

  • Storage Backends

  • Indexes

  • Logging

  • Add-on settings

  • Many more

Generally, we reference settings as we go along in the administrator manual. Therefore, we will not cover all the settings here. More so, you should understand the system configuration tool, how to navigate and search, backup and deploy.

System Configuration Edit#

When editing an individual entry, you can quickly edit by hovering over the setting and:

Single edit option

Edit options#

  1. Quick edit

  2. Full menu

  3. Jump to configuration group

Editing Modes#

There are different editing modes provided. This has mostly affect on the System Configuration Sidebar.

Single Setting Modes#

To access this mode, you must select a configuration item from the list when searching or use a link copied from the menu. In this mode, you can only return to the overview in the actions’ sidebar.

Multiple Settings Mode#

This mode is entered, by hitting enter when searching or jumping to a configuration group from the menu of any single setting. In this mode, you will not be able to use the navigation from the System Configuration Sidebar.

Group Settings Mode#

When using the navigation from the System Configuration Sidebar. This mode provides you all the options from the System Configuration Sidebar.

Secured Settings#

Some settings should be only set by users with access to the shell. These include, but are not limited to, the following.

  • FQDN

  • SystemID

  • Database Settings

Securing a setting can be done by adding it to the main configuration file Kernel/ If this is the case, the setting will indicate that it is not writable.

Secured Setting

Secured Setting#

Setting Types#

There are different types of settings in the system configuration. Here are the most common


Editing this, is just as easy as any input field. Settings are not validated by default; therefore, you should use care when entering values.

These can include:

  • Directory paths

  • Files

  • Strings

  • Textarea

  • YAML

  • Password

  • VacationDaysOneTime

  • VacationDays


Dropdown selections use entity validation of Perl modules or database entities to ease configuration wherever possible.

These can include:

  • Select

  • Entity

  • TimeZone

  • PerlModule

Input selection

Fields where there are options.

These can include:

  • Date

  • DateTime

  • WorkingHours


Selecting a checkbox will enable or disable a setting.


Many of these use + or - (inner and outer) to enter key/value pairs, or complete new blocks of key/value pairs.

These can include:

  • FrontendNavigation

  • FrontendRegistration

  • PerlModule


Entity Validation

The following entities are validated by the system configuration.

  • Group

  • Priority

  • Queue

  • Role

  • Service

  • SLA

  • State

  • SystemAddress

  • Type

  • User

  • Valid

  • Webservice


Hashes and Hash Arrays

These require special knowledge of the required structure to prevent causing errors is the system, and should be modified only when you understand the array requirements.

System Configuration Sidebar#

In the sidebar, as with most configuration modules (see Managing Entities), there is a sidebar. In the sidebar, you can

  • Take actions

  • Navigate settings

System Configuration Sidebar

System Configuration Sidebar#

The actions’ menu offers you the opportunity to do the following.

  • Deploy settings

  • Show settings currently locked for editing

  • View favorite settings

  • Import or export settings

Additional Actions#

When in the Group Settings Mode, you can still see the navigation menu, in others this is not possible.

Additional Edit Actions

Additional Edit Actions#

Help Menu#

In Group Settings Mode and Multiple Settings Mode, you will see the dynamic actions’ menu, a help menu appears with a legend of colors and hotkeys available for use.

There are colors for:

  • Currently edited by me.

  • Modified but not yet deployed.

  • Currently edited by another user.

  • Different from its default value.

System Configuration Hot Keys#

Save current setting.


Cancel editing the current setting.

Dynamic Actions#

In Group Settings Mode and Multiple Settings Mode, you will see the dynamic actions’ menu. Here you can:

  • Filter for settings

  • Enable all settings for editing

  • Save all open settings

  • Cancel all open settings