OTOBO / Znuny System Configuration – Managing Settings
The System Configuration in OTOBO/Znuny is the core for customization and fine-tuning:
– All changes are made through a central graphical interface.
– Versioning and an audit log document who, when, and what values were changed.
– In case of an error, any setting can be reverted to a previous state.
1. Quick Start: Opening System Configuration
- Log in as an administrator in the Agent interface.
- Navigate to Administration → System Configuration.
- Use the full-text search bar to instantly find what you need among the approximately 2,200 configuration keys.
2. Finding and Opening a Setting
- Enter a search term – the full-text search scans names, descriptions, and values.
- Select a result:
- Expand the widget:
3. Editing and Saving Values
Hover over the widget → “Edit this setting”:
Change the value and click Save:
Confirm the change:
4. Version Comparison & Reset
After saving, a diff log is automatically generated, allowing you to see old vs. new values at a glance:
If something goes wrong, you can revert to the previous value at any time with “Reset”:
5. Activating Changes (Deploy)
A click on “Deploy Settings” applies all local changes:
6. Navigation & Category Tree
The side navigation tree organizes configurations by modules and subgroups.
Each category shows the number of its entries in parentheses:
This helps you keep an overview, even with additional packages (e.g., ITSM, FAQ, OAuth).
7. Importing & Exporting Entire Configurations
- Export: Create backups or transfer your settings into
.ymlfiles. - Import: Load previously exported configurations into another system or synchronize test/staging instances.
8. Special Cases & Best Practices
8.1 Logos & Branding
Change the Agent logo centrally via
Frontend::Agent::LogoURL
And customize the customer portal logo:
Frontend::Customer::LogoURL
8.2 Authentication & SSO
Flexibly enable OAuth2/OpenID Connect or LDAP – entirely through System Configuration:
Core::Auth::Agent::Module
Core::Auth::Customer::Module
8.3 Dynamic Fields via Configuration
Add new DynamicField drivers without any programming:
Core::DynamicFields::DriverRegistration
8.4 Control Menu Modules Individually
Activate or deactivate front-end modules like AgentTicketZoom or CustomerTicketSearch via configuration:
Frontend::Agent::ModuleRegistration
9. Conclusion
The OTOBO/Znuny System Configuration provides you with:
- Real-time search function: Find any key in seconds.
- Audit & Versioning: Every value change is documented.
- Rollback mechanism: One click to revert – no fear of misconfigurations.
- Import/Export: Perfect synchronization between production, staging, and test instances.
With these features, you can adapt your OTOBO system securely, transparently, and agilely to any new scenario – from branding and auth to custom plugins.
For more details, see the official OTOBO Documentation.
Popular System Configurations
Here are the 30 most common system configurations in a clear table.
| Configuration Key | Description | Value |
|---|---|---|
NotificationSenderEmail | Sender's email address for system notifications | support@<OTOBO_CONFIG_FQDN> |
PostmasterDefaultQueue | Default queue for the Postmaster | – |
FirstnameLastnameOrder | Order of first and last name | – |
Elasticsearch::TicketSearchFields | Fields used for ticket search in Elasticsearch | – |
Elasticsearch::TicketStoreFields | Fields used for storing tickets in Elasticsearch | – |
GenericAgentAllowCustomScriptExecution | Allows the Generic Agent to execute custom scripts | – |
DashboardBackend::AllowCmdOutput | Allows displaying console output in the Dashboard | – |
Ticket::Frontend::CustomerTicketZoom###StateDefault | Default state for the customer ticket view | – |
Ticket::Frontend::CustomerDisableCompanyTicketAccess | Disables customer access to company tickets | – |
ACL::PossibleNot→Form→<Feldname> | ACL setting for negated form conditions | – |
PostmasterFollowUpState | State for Postmaster follow-up emails | – |
PostmasterFollowUpStateClosed | Closed state for Postmaster follow-ups | – |
Ticket::Frontend::AgentTicketZoomReply | Allows replies in the Agent ticket zoom | – |
AgentTicketCompose | Settings for composing new Agent tickets | – |
Ticket::Frontend::MenuModule###550-Appointment | Menu module for appointments in the ticket frontend | – |
Ticket::Frontend::MoveType | Settings for the ticket move type | – |
Ticket::Frontend::AgentTicketMove###RequiredLock | Requires a lock when moving tickets by Agents | – |
Ticket::Frontend::TicketNote###OwnerMandatory | Makes the "Owner" field mandatory for ticket notes | – |
Core::Crypt::PGP | PGP encryption settings | – |
CustomerDashboard::Tiles###ServiceCatalog-01 | Dashboard tile for the Service Catalog | – |
Frontend::Module###CustomerTicketMessage | Frontend module for customer ticket messages | – |
CustomerTicketMessage | Configuration for customer ticket messages | – |
CustomerDashboard::Tiles###TicketList-01 | Dashboard tile for the ticket list | – |
CustomerFrontend::Module###CustomerTicketMessage | Customer frontend module for ticket messages | – |
Ticket::GenericAgentAllowCustomScriptExecution | Allows Generic Agent to execute custom scripts (Ticket module) | – |
Ticket::Frontend::AgentTicketNote###Subject | Subject setting for Agent ticket notes | – |
Core::Time::Calendar1 | Time settings for Calendar 1 | – |
TimeAccounting | Time accounting module | – |
DynamicField_<Name> | Placeholder for dynamic fields | – |
Ticket::NumberGenerator::MinCounterSize | Minimum counter length for ticket numbers | – |