Customize the login screen

If you want to customize The checkmk login screen,  depending on the edition there are several ways to do that

CME

Step-by-step guide

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

1. For the customers

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

      

      

      
      

      
      

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

      

   3. Now your customer will see that icon in the login screen as well as after the login

      

2. For the provider

   1. For the provider, there is no guy way to do that. So we will need to work on the command line. Inside the checkmk instance we store the icons in:

      OMD[cme2]:~$ ls share/check_mk/web/htdocs/themes/

      so there is a way to create a local branch and put in your custom icon there. To achieve that successfully, you need to use the same icon names as stored in share/check_mk/web/htdocs/themes/. The name of that icon for the login 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 theme. In that example, I'm using root to copy both directories. After that, i need to change the permissions to the Checkmk instance name.

      cp -r /omd/sites/cme2slave/local/share/check_mk/web/htdocs/themes/* /omd/sites/cme2/local/share/check_mk/web/htdocs/themes/
      chown -R cme2. /omd/sites/cme2/local/share/check_mk/web/htdocs/themes/*

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

      

 CEE

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

The name of the login icon: mk-logo.png, the name of the navbar icon: tribe29_icon.png

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

To find also the other icon names, you can activate the network tools 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 customice the login screen:

Setup → General → Global setting → search for "login"

Here you're able to hide the Checkmk version, to add a custom link and also to put a custom login message

After saving that, the login screen will look like that.

Related articles