Settings Overview

UTMStack v12 groups its administration screens under Configure > Settings. This page lists every settings page, who can see it, and which page in this guide describes it.

Open Settings

  1. Sign in with a user that holds the Administrator role.

  2. In the main menu, open Configure > Settings.

The main menu is replaced by the list of settings pages, with a Back button at the top. Click Back to return to the main menu.

When you open Settings, UTMStack shows the License page if you are the instance operator, and the Notifications page otherwise.

The Configure group, and so Settings, appears only for users with the Administrator role. Other users open their Profile from the avatar menu in the top bar, and the Notifications page from the bell.

Who is the instance operator

Some settings belong to the whole server rather than to one organization on it. Only the instance operator sees them.

  • On a normal (single-tenant) installation, every user belongs to the default tenant, so every user with the Administrator role is an instance operator.

  • On a server with a multi-tenant licence, the instance operator is a user with the Administrator role in the default tenant. Administrators of a customer tenant are not instance operators. See Tenants.

  • While the instance operator works inside a customer tenant (a support session), the operator-only pages are hidden. See Support Access.

Settings pages

The pages appear in this order in the Settings menu.

Menu itemPage titleWho sees itDescribed in
LicenseLicenseInstance operatorLicense and Editions
NotificationsNotificationsEveryoneNotifications
Connection KeyConnection keyAdministratorsConnection Key
Data RetentionData retentionInstance operatorData Retention and Cold Storage, and the Storage and Retention pages
BrandingBrandingAdministrators (Enterprise licence to change it)Branding
API KeysAPI keysAdministrators (Enterprise licence to create keys)API Keys
Identity ProvidersIdentity ProvidersAdministrators (Enterprise licence to create or edit providers)Single Sign-On and its provider guides
Support accessSupport accessAdministrator of a customer tenant, multi-tenant licence onlySupport Access
Email ConfigurationEmail configurationAdministratorsEmail Configuration
ThreatWinds IntegrationThreatWinds IntegrationInstance operatorThreat intelligence pages
SOC-AISOC-AI ConfigurationAdministratorsAI Providers
Date FormatDate & timeAdministratorsDate, Time Zone and Language
LanguagePlatform languageAdministratorsDate, Time Zone and Language
App Audit LogsAudit logAdministratorsApp Audit Logs
AboutAbout this instanceInstance operatorLicense and Editions

The Data Retention page is also hidden when the server's retention feature is switched off.

Users without the Administrator role do not see the Configure menu. If their role allows a settings page, they can open it by its address, for example https://siem.example.com/settings/api-keys. See Roles and Permissions.

Other administration pages

These pages are not under Settings:

WhereWhat it doesDescribed in
Configure > TeamAdd, deactivate and reactivate users; assign roles; create custom rolesUsers, Roles and Permissions
Avatar menu > ProfileEach user's name, email, language, password, sessions and two-step sign-inProfile and Two-Step Sign-In
Tenants (main menu)Create and manage customer tenants (multi-tenant licence, instance operator only)Tenants

Settings and tenants

On a multi-tenant licence, most settings belong to each tenant: email and recipients, date and time, language, branding, identity providers, users, roles, API keys and the connection key.

For the mail server settings, date and time, and language, a value that the tenant has never saved is taken from the default tenant. Branding is not taken from the default tenant: a tenant without its own branding shows the standard UTMStack look.

Settings that belong to the whole server are on the operator-only pages: the licence, data retention, the ThreatWinds switches and the About page. For how tenants work, see Multi-Tenancy Overview.

First steps after installation

After you install UTMStack v12 and sign in for the first time:

  1. Set a real email address for the admin user when UTMStack asks for it. UTMStack then opens Email Configuration.

  2. In Email Configuration, set up your mail server and correct the Base URL. See Email Configuration.

  3. Install your licence if you have one. See License and Editions.

  4. Add the people who will use UTMStack, or connect your identity provider. See Users and Single Sign-On.

  5. Decide how long to keep logs and alerts, and whether to use cold storage. See Planning Retention and Disk Space.