Custom Logo Setup (On-premise Only)

This guide explains how to set up custom SVG logos in your application. Custom logos will automatically adapt to light and dark themes and take effect immediately without requiring an application restart.

Image Specifications

Supported Dimensions

Maximum size: 800×200 pixels
Optimal size: 128×30 pixels
Not recommended: Extremely small dimensions (1×1, 2×2 pixels) as they may render poorly or be skipped entirely

File Format Requirements

Supported format: SVG only

Setup Steps

1. File Naming

Create your logo files with these exact file names:

logo.svg - Used for light theme
logo-dark.svg - Used for dark theme

2. File Deployment

Place your SVG files in the following directory on the server: /standalone/deployments/ROOT.war/custom-logos/.

3. File Upload

Upload both logo files to the specified deployment path. Ensure proper file permissions are set for the application to read the files.

Behavior and Fallback Logic

Automatic Theme Detection

Light theme displays logo.svg
Dark theme displays logo-dark.svg

Fallback System

The application implements a robust fallback mechanism:

Primary fallback: If logo.svg is missing, logo-dark.svg will be used for light theme (and vice versa)
Secondary fallback: If both custom logos are missing, the built-in default logo is displayed for the respective theme

Runtime Behaviour

No restart required: Changes take effect on the next page load
Immediate deployment: New files are automatically detected
Browser caching: To see changes immediately when testing, disable browser cache or use hard refresh (Ctrl+F5)

Custom logos available since v25.2