Customize logo

Inside the stack.cfg, you can configure the front-end logo and name to match your own visual identity. You need to define a new resource in both web and keycloak modules.

{
    "resources":
    [
        {
            "source": "theme/images", //File or folder path in the configuration (relative path)
            "destination": "images" //File or folder path on the running module (relative path)
        }
    ]
}

In the stack.cfg file, you can specify following properties:

• name: Name of the stack, displayed on the front-end

• theme.logoWithoutText: The logo to display on the login page, account page and dashboard. If it is not defined, the logo with text will be used or the default one. The file must be added in Keycloak and web modules resources.

• theme.favicon: The favicon image. The file must be added in Keycloak and web modules resources.

{
    "name": "OnSphere",
    "theme": {
        "logoWithoutText": "images/logo.png",
        "favicon": "images/favicon.png"
    }
}

Warning

Keycloak themes are cached for one hour. This results in multiple logos appearing on top of each other when changing it. To solve this issue, you can restart Keycloak, but bear in mind that this will terminate all open sessions.