Skip to main content
Version: 0.4 · current

Configure the instance

How-to guideReviewed October 11, 2026
Applies to:Excubius 0.4Roles: Super admin
PlansFree · Core · Pro · EnterpriseDeploymentSelf-hosted

Every Excubius installation ships with every capability. Settings › Instance decides which of them the installation shows, and under which name, logo and theme. Changes apply to everyone at once and are written to the audit log. This guide shows how to switch features, apply a preset and set the branding.

Before you begin​

  • You need the Super admin role. The screen is not shown to anyone else.
  • Some features also need configuration on the server, such as a Slack token or Jira credentials. Switching a feature on shows it; it does not configure it.

Open the screen​

  1. Select Settings, then Instance.
  2. Find the Presets, Features and Branding sections described below. At the bottom, the screen tells you whether switched-off features are only hidden or also refused by the API, and when the last change was made.

The server's names and TLS have their own screen, linked from the top as Server names and HTTPS. See Set up names and TLS.

Start from a preset​

A preset is a named starting point: a set of feature switches plus branding. Each one is shown as a card with its description. The general-purpose presets are:

PresetContent
enterpriseEverything on; the default for a new installation
databasesInfrastructure, alerts, the status page and the database modules
coreInfrastructure, alerts and the status page
warning

Selecting a preset card applies it at once. It replaces all feature switches and the branding with the preset's. Note your branding before you apply one, and adjust single switches afterwards.

Even in enterprise, the Defender for Cloud and Wazuh sources stay off until you switch them on.

Switch a feature on or off​

  1. Under Features, find the feature in its group: Sources, Monitoring, Security, Collaboration, Access or Interface. Each line shows the feature's key, what it does and, when it has one, the feature it requires.
  2. Use its switch.

The change applies at once.

  • A feature that requires another is greyed out while that one is off. Switching a requirement off switches its dependants off too; for example, switching off security also switches off security.defender and security.wazuh.
  • Switching off a feature that owns catalog modules removes those modules from the catalog listing.
  • Hiding is presentational by default: navigation, screens and widgets follow the switches, while collection, storage and the API keep working. When you switch a feature back on, its history is there. To make the API refuse switched-off features as well, set EXCUBIUS_FEATURES_ENFORCE_API=true in the server's configuration; their endpoints then answer 404.
  • Some switches are enforced in any case. With access.google_login off, Google sign-in is refused.

Features that other guides refer to:

FeatureWhat it controls
monitoring.databasesSQL Server (including availability groups), Azure SQL, Managed Instance and PostgreSQL modules
monitoring.updatesThe Updates & advisories page and its checks
securityThe Security posture page, the findings and the security score
security.defender, security.wazuhCollection from Microsoft Defender for Cloud and from Wazuh. Off by default
security.recommendationsShows Defender for Cloud recommendations next to findings
collab.jiraCreate Jira ticket on alerts and findings; requires collab.assign
access.google_loginSign-in with Google
access.directory_groupsRoles for Microsoft Entra ID groups
ui.public_status_pagePublic status pages
ui.i18nLanguages other than English, in the console and in Slack messages
ui.themesColour themes beyond light and dark

Set the branding​

  1. Under Branding, fill in the fields:

    FieldEffect
    Product nameThe browser title, the header, the sign-in page, the installed app's name, and the prefix and label of Jira issues. Up to 60 characters
    TaglineShown next to the name on wide screens and in the installed app's description. Up to 120 characters
    LogoNone, the Built-in mark, or an Image URL: an https address or a path on this server starting with /
    Default themeThe theme of the sign-in page and of new users. People can still choose their own
    Show "powered by" lineA footer credit, shown only with the built-in mark
  2. Select Save.

With Logo set to None, a neutral icon is used everywhere, including the browser tab and the installed app, so nothing in the browser names the product. Slack messages and public status pages never name the product, whatever the branding.

The themes are Midnight, Daylight, Slate and amber, Ops room (high contrast), Okabe–Ito (colour-blind safe) and Paper. With ui.themes off, the installation offers light and dark only.

A client's branch can have its own default theme and logo; see Set a branch appearance.

Do it with the API​

Every request needs the Super admin role and is audited.

TaskRequest
Read the full configuration, presets and feature registryGET /api/v1/instance/admin
Apply a presetPOST /api/v1/instance/preset with {"name": "databases"}
Switch featuresPATCH /api/v1/instance/features with {"changes": {"collab.jira": false}}
Change the brandingPATCH /api/v1/instance/branding with any of product_name, tagline, logo, show_powered_by, theme_default

GET /api/v1/instance needs no sign-in: it returns the branding and the switches as the caller sees them, which is what the console reads when it loads.