Page Comparison

...

CME / MSE

Step-by-step guide

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

For the customers

1. Go to Setup → Users → Customers and select the color palette for every customer you want to modify.
   
   
   
   ..

2. Now you can upload a picture. The needed size of that picture is described in the inline help.
   
   
   .
   .
   

3. Your customer will see that icon on the login screen and after the login.
   
   
   

   .

For the provider

1. For the provider, there is no GUI way to do that. So we will need to work on the command line. Inside the Checkmk instance, we store the icons in the ~/share/check_mk/web/htdocs/themes/ directory.

   Code Block
   language bash theme RDark
   OMD[mysite]:~$ ls share/check_mk/web/htdocs/themes/

   So there is a way to create a local branch and add your custom icon. To achieve that successfully, you must use the same icon names stored in share/check_mk/web/htdocs/themes/. The name of that icon for the log in is mk-logo.png
   .

2. The easiest way to move the icons to the provider is to copy the paths. Checkmk has two directories for the dark and light themes. In that example, I'm using root to copy both directories. After that, we must change the permissions to the Checkmk instance name.

   Code Block
   language bash theme RDark
   root@linux# cp -r /omd/sites/mysite/local/share/check_mk/web/htdocs/themes/* /omd/sites/mysite/local/share/check_mk/web/htdocs/themes/ root@linux# chown -R mysite:mysite /omd/sites/mysite/local/share/check_mk/web/htdocs/themes/*

   .

3. Now you changed the login icon of the provider site successfully:
   
   

   
   

...

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: mk-logo.png, and the name of the navbar icon: tribe29checkmk_icon.png

➜  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/tribe29checkmk_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/tribe29checkmk_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:

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.

...

Related articles

...