Chapter 3. Customizing the Fuse Console branding


You can customize the Fuse Console branding information, such as title, logo, and login page information, by using the Fuse Console branding plugin.

By default, the Fuse Console branding is defined in the hawtconfig.json that is located in the Fuse Console WAR file (eap-install-dir/standalone/deployments/hawtio-wildfly-<version>.war). When you implement the Fuse Console branding plugin, you can override the default branding with your own custom branding.

Procedure

  1. Download the branding plugin example from https://github.com/hawtio/hawtio/tree/master/examples/branding-plugin to a local directory of your choice.
  2. In an editor of your choice, open the Fuse Console branding plugin’s src/main/webapp/plugin/brandingPlugin.js file to customize the Fuse Console branding.

    You can change the values of the configuration properties listed in Table A.1, “Fuse Console Configuration Properties”.

  3. Save your changes.
  4. In an editor of your choice, open the Fuse Console branding plugin’s pom.xml file to its <parent> section:

    <parent>
        <groupId>io.hawt</groupId>
        <artifactId>project</artifactId>
        <version>2.9-SNAPSHOT</version>
        <relativePath>../..</relativePath>
      </parent>
    Copy to Clipboard Toggle word wrap
  5. Edit the <parent> section as follows:

    1. Change the value of the <version> property to match the version of your Fuse on EAP installation. For example, if your Fuse on EAP installation directory name is 2.0.0.fuse-760015, set the version to 2.0.0.fuse-760015.
    2. Remove the <relativePath>../..</relativePath> line.

      For example:

      <parent>
          <groupId>io.hawt</groupId>
          <artifactId>project</artifactId>
          <version> 2.0.0.fuse-760015</version>
            </parent>
      Copy to Clipboard Toggle word wrap
  6. In a Terminal window, build the branding-plugin project by running the following command:

    mvn clean install
    Copy to Clipboard Toggle word wrap

    This command creates a branding-plugin.war file in the project’s /target folder.

  7. Copy the branding-plugin.war file to your EAP installation’s standalone/deployments directory.
  8. If Fuse is not already running, start it by running the following command:

    On Linux/Mac OS: ./bin/standalone.sh

    On Windows: ./bin/standalone.bat

  9. In a web browser, open the Fuse Console by using the URL that the start command returned in the previous step (the default URL is http://localhost:8080/hawtio).
Note

If you have already run the Fuse Console in a web browser, the branding is stored in the browser’s local storage. To use new branding settings, you must clear the browser’s local storage.

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat
Back to top