Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info
If you want to customize The

...

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

Status
colourGreen
titleLAST TESTED ON CHECKMK 2.2.0P1


Panel
borderColorblack
bgColor#f8f8f8
titleTable 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

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

    Image Removed

    Image Removed
  3. you want to modify.
    Screenshot showing the Customers link location under the Users category.Image Added

    Screenshot of location of where the color palette icon is on the screen.Image Added
    ..
  4. Now you can upload a picture. The needed size of that picture is described in the inline help.
    Screenshot of the Login mask logo option enabledImage Added

    info


    Screenshot of new customer logo uploadedImage Added.

    Image Removed

    .

  5. Now your

    Your customer will see that icon

    in

    on the login screen

    as well as

    and after the login.

    InfoImage RemovedImage Removed

    Screenshot of new customer logo on login screenImage Added

    Screenshot showing the new customer logo on the top left corner of the screenImage Added

    .

For the provider

  1. 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
    languagebash
    themeRDark
    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
    .

  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

    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
    languagebash
    themeRDark
    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/*

    .

  3. Now you changed

    successfully

    the login icon of the provider site successfully:

    info


    Screenshot of new customer logo on login screenImage Added

    Image Removed

 CEE

...



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. Make sure Ensure that in the CEE version, you will need two files for the login icon and the navbar iconicons.

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

Code Block
languagebash
themeRDark
➜  images cp /omd/sites/testmysite/local/share/check_mk/web/htdocs/themes/facelift/images/mk-logo.png /omd/sites/testmysite/local/share/check_mk/web/htdocs/themes/facelift/images/tribe29checkmk_icon.png
➜  images cp /omd/sites/testmysite/local/share/check_mk/web/htdocs/themes/modern-dark/images/mk-logo.png /omd/sites/testmysite/local/share/check_mk/web/htdocs/themes/modern-dark/tribe29images/checkmk_icon.png 
➜  images chown -R testmysite. /omd/sites/test/localmysite/share/check_mk/web/htdocs/themes/*


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

...


Screenshot showing page inspector enabled detailing the image sourceImage Added

...

Image Removed


Additional login screen options

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

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

...

  1. Screenshot showing the customize login screen option under global settingsImage Added

...

  1. .
  2. Here you

...

  1. can hide the Checkmk version,

...

  1. add a custom link, and

...

  1. put a custom login message.

...

  1. Screenshot of editing global settings with my company and its url.Image Added

...

  1. .
  2. After saving that, the login screen will look

...

  1. similar to below.

...

  1. Screenshot showing that the title and url have been updated on the login screen.Image Added


Image Removed

Note

If you're running Checkmk in a distributed setup, you may want to do that in the site-specific global settings rather than globally!


Filter by label (Content by label)
showLabelsfalse
max5
spacesCON
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel in ( "setup" , "cme" , "howto" ) and type = "page" and space = "CONKB"
labelscme setup


Page Properties
hiddentrue


Related issues


...