Customize Pentaho home page, logo and login form

Pentaho Business Intelligence Platform is written in Java EE and is Open Source (Comunity Edition), this give you a lot of flexibility if you know how to program in Java. You can apply modifications on the source code as long as you accomplish the license terms.

Before proceed with this tutorial you must have at least a basic background in HTML and JSP.


Customize home page

In Pentaho BI Suite version 3.8.0 the default home page is like this.

Pentaho home page to be customized


To change Pentaho's login page edit <pentaho-home>\tomcat\webapps\pentaho\jsp\PUCLogin.jsp.

For example to remove the two bottom panels delete all the text staring from

<!--End First Box Row --> <!--Begin Second Box Row --> <!--Begin Enterprise Boxes -->
<table width="564" border="0" cellspacing="0" cellpadding="0"




And to change home page text replate the following string

<table width="100%" border="0" cellspacing="0" cellpadding="0">
    <td colspan="2" class="start_login_title">Welcome to the Pentaho User Console</td>
        <td class="start_content">
        <p>The Pentaho User Console provides access to powerful ...... </p>
<table width="100%" border="0" cellspacing="0" cellpadding="0">
    <td colspan="2" class="start_login_title">Business Intelligence Portal</td>
        <td class="start_content">
        <p>Click on Pentaho User Console Login to start. Write some usefull text here.</p>


when you refresh the page in your browser the result should be as follow:

Pentaho home page customized


Customize Login form dialog

All Pentaho's messages can be customized, but they are stored in many different directory and this make things a bit harder. To customize the message in login form dialog, as in the following picture, open and edit <pentaho-home>\tomcat\webapps\pentaho\mantle\messages\ If you have a default language set (es English) you must edit the localized version of this file, for example

Now we replace the string 'Sample User' with 'Select User':

sampleUser=Select a User

Refresh your browser (and clear borwser cache) to show the changes. 
Be sure to refresh the browser page and clear browser cache to show the result.

Customize Pentaho Login form dialog


Use your own logo

Pentaho login images are located in <pentaho-gome>\tomcat\webapps\pentaho-style\images\login.

To change the logo in start page replace the file <pentaho-gome>\tomcat\webapps\pentaho-style\images\login\start_logo.png with your own logo.

Customize Pentaho Logo on Login page


To change the logo afer login page replace the following files with your own version:


If you need to modify the background under the top-right logo you can replace the following file.


The result shoul'd be as follow. The browser can mantain all old images in cache, so you need to refresh the pages to see the changes.

Customize Pentaho Logo on Login page


Pentaho BI Suite Comunity Edition 3.8.0 is released under GPL license, so make sure you are following the license terms for each modification you made. You can use Pentaho commercial version if you need a customizable product without releasing you changes as Open Source.