Page Comparison

Info
If you want to customize The

...

Checkmk login screen, depending on the edition, there are several ways to do that

Status

colour	Green
title	LAST TESTED ON CHECKMK 2.2.0P1

Panel

borderColor	black
bgColor	#f8f8f8
title	Table of Contents

Table of Contents

CME / MSE

Step-by-step guide

For the CME, there is a setting for every customer to upload a customized icon.

For the customers

Go to Setup → Users → Customers and select the color palette for every customer

the color palette

Info

Image Removed

you want to modify.
Image Added

Image Added
..
Now you can upload a picture. The needed size of that picture is described in the inline help.
Info
Image Removed
Now your
Image Added

Image Added.
.
Your customer will see that icon
in
on the login screen
as well as
and after the login.
InfoImage RemovedImage Removed
Image Added

Image Added
.

For the provider

For the provider, there is no
guy
GUI way to do that. So we will need to work on the command line. Inside the
checkmk
Checkmk instance, we store the icons in
:
the ~/share/check_mk/web/htdocs/themes/ directory.
Code Block
language bash
theme RDark
OMD[
cme2
mysite]:~$ ls share/check_mk/web/htdocs/themes/
so
So there is a way to create a local branch and
put in
add your custom icon
there
. To achieve that successfully, you
need to
must use the same icon names
as
stored in share/check_mk/web/htdocs/themes/. The name of that icon for the
login
log in is mk-logo.png
.
The easiest way to move the icons to the provider is to copy the paths. Checkmk has two directories for the dark and light
theme
themes. In that example, I'm using root to copy both directories. After that,
i need to
we must change the permissions to the Checkmk instance name.
Code Block
language bash
theme RDark
root@linux# cp -r /omd/sites/
cme2slave
mysite/
local/
share/check_mk/web/htdocs/themes/* /omd/sites/
cme2
mysite/local/share/check_mk/web/htdocs/themes/ root@linux# chown -R
cme2.
mysite:mysite /omd/sites/
cme2
mysite/local/share/check_mk/web/htdocs/themes/*
.
Now you changed
successfully
the login icon of the provider site successfully:

Image Added

Note

In the CME, Checkmk tries to autoscale the icon automatically. In any other addition, that is not done. That's why you see an overlapping.

In this case, there is also overlapping in the CME edition because the icon is much taller than wide.

CEE

There is no way to upload an icon via the GUI in the CEE. So here, you need to do that manually, as described in the CME section. Ensure that in the CEE version, you will need two files for the login and navbar icons.

The name of the login icon:

...

Info
Image Removed

CEE

...

mk-logo.png, and the name of the navbar icon: checkmk_icon.png

Code Block

language	bash
theme	RDark

➜  images cp /omd/sites/mysite/share/check_mk/web/htdocs/themes/facelift/images/mk-logo.png /omd/sites/mysite/local/share/check_mk/web/htdocs/themes/facelift/images/checkmk_icon.png
➜  images cp /omd/sites/mysite/share/check_mk/web/htdocs/themes/modern-dark/images/mk-logo.png /omd/sites/mysite/local/share/check_mk/web/htdocs/themes/modern-dark/images/checkmk_icon.png 
➜  images chown -R mysite. /omd/sites/mysite/share/check_mk/web/htdocs/themes/*

To find the other icon names, you can activate the network tools (F12) in your browser and inspect the elements:

Image Added

Additional login screen options

In the global setting (regardless of whether it's a CME or CEE), you will find an option to customize the login screen.

Setup → General → Global setting → search for "login"
Image Added
.
Here you can hide the Checkmk version, add a custom link, and put a custom login message.
Image Added
.
After saving that, the login screen will look similar to below.
Image Added