Zabbix Web UI Logo·Title Customization Guide

Environment: Zabbix 7.4.3 / Ubuntu 22.04 / Apache2

When you want to make the Zabbix Web UI look like an internal company monitoring portal, what you need to touch is the branding configuration.
The problem is that the official documentation is too short, and the UI root path changes between versions, so if you just follow random references, it often doesn’t work.

This post summarizes a fully tested method based on the following environment:

• Zabbix 7.4.3
• Ubuntu 22.04
• Apache2
• Environment where Alias /zabbix /usr/share/zabbix/ui is configured

In other words, the frontend web root is /usr/share/zabbix/ui.

---

1. Why common references often don’t work

On Zabbix 7.x, after installation the directories usually look like this:

/usr/share/zabbix
/usr/share/zabbix/ui

So if you run:

# find / -type f -name "index.php" | grep zabbix

it is normal for both paths to appear.

The important part is which path Apache is actually using as /zabbix, and you need to check the configuration for that.

# grep -R "Alias /zabbix" /etc/apache2 2>/dev/null

→ In this environment, the Web UI root is /usr/share/zabbix/ui.
So all branding files and logo paths must be set based on this path.

---

2. Quick overview of Zabbix branding

From Zabbix 6.x onward, you can rebrand the Web UI using a single file: brand.conf.php.
In this file, you can change:

• BRAND_LOGO
  Logo displayed at the top of the login screen
• BRAND_LOGO_SIDEBAR
  Logo displayed at the top of the left sidebar
• BRAND_LOGO_SIDEBAR_COMPACT
  Small icon used when the sidebar is in compact (collapsed) mode
• BRAND_FOOTER
  Text shown in the footer at the bottom of the screen
• BRAND_HELP_URL
  URL opened when clicking “Help” in the login screen / left menu

This is not “hacking core files,” but an officially supported branding hook provided by Zabbix.
If you want to show your company name, service name, or give it a portal-like look, this is all you need to touch.

---

3. Preparing logo files

Since the frontend root is /usr/share/zabbix/ui,
logos must be placed under /usr/share/zabbix/ui/local/logo.

# mkdir -p /usr/share/zabbix/ui/local/logo

=> Upload your image files into this path.

PNG format is recommended.

---

4. Creating brand.conf.php – actual example

Now create the branding configuration file.

# cd /usr/share/zabbix/ui/local/conf
# vi brand.conf.php

Example:

<?php
return [
    // Logo at the top of the login screen
    'BRAND_LOGO' => 'local/logo/logo_main.png',

    // Logo at the top of the left sidebar
    'BRAND_LOGO_SIDEBAR' => 'local/logo/logo_main.png',

    // Logo for compact (collapsed) sidebar mode
    'BRAND_LOGO_SIDEBAR_COMPACT' => 'local/logo/logo_compact.png',

    // Footer text at the bottom of the screen
    'BRAND_FOOTER' => 'Black K Monitoring System',

    // URL opened when clicking the Help button
    'BRAND_HELP_URL' => 'https://www.example.com'
];

A few key points here:

• Paths must be relative to the frontend root.
• Since the root is /usr/share/zabbix/ui:
  • local/logo/logo_main.png → actual file path is /usr/share/zabbix/ui/local/logo/logo_main.png.
• You can use the same image for the sidebar and main logo,
  or create a separate logo_sidebar.png and assign it only to BRAND_LOGO_SIDEBAR if needed.

---

5. Permission settings – first thing to suspect when it doesn’t apply

# vi /etc/apache2/conf-available/zabbix.conf

: Comment out the relevant existing block.

: Add the new block below it.

Restart Apache after applying the configuration changes

---

6. Changing the top name (Server Name)

Separate from the logo, the name shown at the top of the screen and in the browser tab (such as “Zabbix server”) is changed in zabbix.conf.php.

This file’s location is independent of the UI root and is usually /usr/share/zabbix/conf.

# cd /usr/share/zabbix/ui/conf
# cp zabbix.conf.php zabbix.conf.php.org   # Backup
# vi zabbix.conf.php

Inside the file, find the following line:

And change it to the name you want:

$ZBX_SERVER_NAME = 'Black K Monitoring System';

This value is used for:

• The text shown under the logo in the left sidebar after login
• The browser tab title

It has nothing to do with the Zabbix server process or DB settings.

---

7. Verifying changes + cache precautions

Refresh your browser (Ctrl+F5),
or open a new incognito window and access http://<server-address>/zabbix again.

Check the following in order:

• Whether the login screen logo has been replaced
• Whether the browser tab title shows the value of $ZBX_SERVER_NAME
• Whether the left sidebar logo after login has been replaced
• Whether the text under the left sidebar logo after login has changed
• Whether the footer text at the bottom of the screen shows the value you configured

Logos are heavily affected by browser caching,
so if it looks like “I definitely changed it, but the old logo still shows”:

Testing in an incognito (private) window is the fastest way.

---

8. One-line summary

In this environment (Ubuntu 22.04 / Zabbix 7.4.3 / Apache2),
Alias /zabbix /usr/share/zabbix/ui is configured, so:

• Branding is configured in /usr/share/zabbix/ui/local/conf/brand.conf.php.
• Logo files are placed under /usr/share/zabbix/ui/local/logo/,
  and you reference them in BRAND_LOGO etc. as local/logo/<filename>.png.
• The top title is changed via $ZBX_SERVER_NAME in /usr/share/zabbix/conf/zabbix.conf.php.

🛠 마지막 수정일: 2025.11.26