Settings for [Tenant Name]#

Under Administration → [Tenant Name] Administration → Settings, you find all configuration options that affect the currently selected tenant. The settings are grouped into expandable sections that you can control via Expand all and Collapse all.

This page is aimed at i-doit administrators who want to customize the behavior of the CMDB, the interface, the search, or the security mechanisms for their tenant. Changes here affect only the current tenant — system-wide settings (e.g., SMTP, Proxy, login behavior) are configured in the Admin Center. For lower-level configuration with key-value pairs, the Expert Settings are available.

Reset password#

When this option is enabled, users can reset their password on the login page via a link. i-doit then sends an email with a reset link to the address stored in the user account.

Disable this function if you manage passwords exclusively via LDAP/AD or an external identity management and a self-service reset is not desired.

URL settings#

Here you enter the base URL under which your i-doit instance is accessible (e.g., https://cmdb.example.com/i-doit). This URL is used for generating links in email notifications, exports, and API responses.

CMDB#

This section contains the most options and controls the basic behavior of the Configuration Management Database.

Explanations for selected CMDB options#

CSV export delimiter — Choose the delimiter used for CSV exports from object lists and reports. Semicolon is the default for German-language Excel installations, comma for English-language ones.

One-Click-Edit — When enabled, you can edit attribute values in the list view directly by clicking, without opening the object's detail page. This speeds up maintenance but increases the risk of accidental changes.

Global SYS-ID prefix — Every new object automatically receives a SYS-ID with this prefix (e.g., CMDB-). Only change the prefix if you operate multiple i-doit instances and want to keep the SYS-IDs distinguishable.

Automatically set cable status — The two options for the CMDB status of cables ensure that cable objects are automatically set to "In operation" when cabled and to "Out of operation" when uncabled. This saves manual effort in cabling documentation.

Release IP addresses on delete/archive — When enabled, IP addresses of an object are released as soon as it is archived or deleted. This makes the addresses immediately available for other objects. Disable this option if you want to track IP histories without gaps.

Enable quick purge button — Displays a button in the object view that allows objects to be immediately and permanently deleted (purged), bypassing the Archive → Delete → Purge workflow.

SYS-ID read-only — Prevents users from manually changing the SYS-ID. Recommended if the SYS-ID is used as a stable identifier in external systems or interfaces.

WYSIWYG editor — Enables a rich-text editor for description fields in categories. With "Enable all WYSIWYG editor functions", additional formatting options such as tables and images are available.

Display Limits#

These settings limit the number of displayed elements in various areas of the interface. Lower values improve loading time; higher values show more information at a glance.

Adjust these limits if you notice performance problems in large environments or if users complain that not all relevant entries are displayed. In environments with thousands of VLANs or host addresses, a limit that is too high can significantly worsen loading times.

Options for IP list#

These settings control the behavior of the IP list view within network objects.

Cache period — Specifies how long the ping results are cached. A shorter period provides more current results but generates more server load.

Ping function — Choose between NMAP and FPING as the backend for reachability checks. FPING is generally faster with many hosts; NMAP offers more scan options.

Unique Checks#

These checks are evaluated exclusively during import/export operations. They prevent duplicate values from being imported into the CMDB.

Enable these checks if you regularly import data from external sources (e.g., JDisc, CSV, API) and want to ensure that no duplicates are created. Note that the check only applies during import — existing duplicates in the CMDB are not cleaned up by this.

Barcodes#

When enabled, i-doit displays a barcode in the object view that encodes the object ID or SYS-ID. QR codes are suitable for mobile scanner apps; Code39 for classic barcode handheld scanners. Useful for inventory processes and the physical assignment of assets.

Interface display#

These options affect how information is displayed in the user interface.

Display empty values as — Determines which placeholder is displayed when an attribute has no value. A hyphen (-) is common; an empty string can reduce readability.

Location separators — The separator string is inserted between the individual levels of the location path (e.g., Building A > Room 101 > Rack 3). Adapt it to the reading habits of your users.

Drag 'n' drop — Allows moving objects via drag & drop in location and object lists. Disable it if users accidentally move objects.

Object type sorting — "Alphabetical" sorts the object type groups and types in the navigation automatically. "Manual" allows a custom order via the object type configuration.

Maximum length of strings#

Specifies after how many characters texts are truncated in the interface. Increase the values if long object names or deep location hierarchies are not fully displayed. Values that are too high can disrupt the layout of the interface.

Logbook#

Log detailed changes — When enabled, the logbook stores the old and new value of an attribute with every change. This enables complete traceability but increases the database size over time.

Disable change comment — Removes the comment field that appears when saving changes. Enable this option if users find the comment requirement disruptive; disable it if you want to enforce a justification requirement for changes.

Delete logbook entries for purged objects — When an object is purged, the associated logbook entries are also removed. This saves storage space but reduces audit traceability.

Templates#

Templates allow you to create objects with predefined attribute values. When the template filter is active, users can filter by templates in the object lists. The color highlighting emphasizes attributes that were adopted from a template, helping to distinguish between manually maintained and pre-filled values.

Security#

Minimum length of user password — Sets the minimum number of characters for local user passwords. A value of at least 10 is recommended. This setting does not apply to LDAP/SSO users, whose password policies are managed externally.

Passwords in plain text — When enabled, passwords in the "Passwords" category are displayed in plain text instead of being masked. Disable this option in environments where shoulder surfing is a risk.

Sanitize data input — Automatically filters out potentially harmful input (e.g., HTML tags, script injections). Keep this option enabled unless you have a specific reason to store special characters unfiltered.

Logging#

These options enable additional log files on the server. Enable them for troubleshooting or for monitoring security-relevant processes:

• Permission system log — Logs when and why access requests were denied. Helpful when debugging permission configurations.
• Exception log — Writes technical error messages to a log file. Important for analyzing application errors.
• CMDB Import — Logs import operations (CSV, JDisc, API). Enable it when you want to trace import problems.

Quick info (Link Mouseover)#

The quick info shows a preview with the most important attributes when hovering over an object link. The cache duration determines how long this preview is cached. Shorter intervals provide more up-to-date data; longer intervals reduce server load.

LDAP#

Default LDAP group — New users who log in via LDAP for the first time are automatically assigned to the person groups specified here. Enter the i-doit object IDs of the desired groups (e.g., 15,42).

LDAP Config — Advanced LDAP configuration as a JSON string. Only use this option if the standard LDAP configuration under Administration is not sufficient.

Salutation mapping — LDAP directories use different values for gender (e.g., male, m, 1). Here you enter the mapping to the i-doit salutation fields.

Report Manager#

Specifies which filter is preselected when opening the Report Manager. Choose the filter that corresponds to the most common use case of your users.

Import#

Abort on validation errors — When enabled, the entire import is aborted as soon as an invalid record is detected. Disable this option if you prefer to skip faulty rows and import the rest.

Clear affected attributes — On a validation error, only the faulty attributes are cleared; the rest of the record is imported normally. Useful when you do not want to lose partially correct data.

Override object type — Allows the CSV import to change the object type of an existing object. Be careful here — an incorrect object type can change category assignments and permissions.

Rows per import batch — Determines how many rows are processed per database transaction. Higher values speed up the import but can cause memory problems with very large data sets.

Search#

Default search mode — "Normal" searches the search index and delivers fast results. "Deep Search" additionally searches the database directly and also finds attributes that are not in the index — but takes significantly longer.

Fuzzy search — Also finds matches that are similar to the search term (e.g., typos). Can make the result list unwieldy in large databases.

Automatic DeepSearch — The option "Active when no results are found" is a good compromise: the fast normal search is executed first, and only if it returns no hits is a deep search automatically triggered.

Minimum search word length — Search terms with fewer characters than the configured value are ignored. Prevents single-character searches from burdening the database and returning an unusable number of results.

JDisc#

The threshold determines the maximum age of JDisc data for import. Devices whose last scan timestamp is older than the threshold are skipped. This prevents outdated information from being written to the CMDB.

Import pause — During large JDisc imports, the process can be temporarily paused (e.g., due to server load). The maximum length of the import pause specifies after how many minutes a paused import is automatically aborted or continued.

Language#

Specifies the language that is assigned to new user accounts by default. Each user can change the language later in their personal settings.

Notifications#

Skip expired licenses — When enabled, no notifications are triggered for already expired licenses. Useful if you are only interested in upcoming expirations and do not want to be repeatedly notified about long-expired licenses.

Exact threshold match — Sends the notification only on the exact day of the threshold (e.g., exactly 30 days before expiration) instead of on every day within the threshold period. Reduces the number of notifications but carries the risk that the message is lost if the notification service is down on that exact day.

Installed Add-on related settings#

When add-ons are installed, additional settings appear here. Availability depends on the installed add-ons.

Further information#

• Expert Settings — Key-value-based configuration for advanced settings that are not available on this page.
• Admin Center — System-wide settings that affect all tenants (e.g., Login, Proxy, SMTP, system security).