Nuxeo Server

How to Override the Login Page

This page is scheduled for review and update. Check back soon for updated content!

Login Page

The Login Page when the server is deployed is located at <nuxeo_server>/nxserver/nuxeo.war/login.jsp. In the source code, this page is located at nuxeo-platform-webapp/src/main/resources/nuxeo.war/login.jsp.

The easiest way to override it is to create a new JSP page with the exact same name and put it in at the root of the directory nuxeo.war of your bundle.

You will find more information related to the authentication here: Authentication.

An helper class will help you to access configuration for the login page, like the image to display on the background for example. The class is org.nuxeo.ecm.platform.ui.web.auth.LoginScreenHelper.

Here is an example getting few configuration data:


<%@ page import="org.nuxeo.ecm.platform.ui.web.auth.LoginScreenHelper"%>
LoginScreenConfig screenConfig = LoginScreenHelper.getConfig();
// fetch Login Screen config and manage default
boolean showNews = screenConfig.getDisplayNews();
String iframeUrl = screenConfig.getNewsIframeUrl();
String bodyBackgroundStyle = LoginScreenHelper.getValueWithDefault(screenConfig.getBodyBackgroundStyle(), "url('" + context + "/img/login_bg.jpg') no-repeat center center fixed #333");
String headerStyle = LoginScreenHelper.getValueWithDefault(screenConfig.getHeaderStyle(), "");
String loginBoxBackgroundStyle = LoginScreenHelper.getValueWithDefault(screenConfig.getLoginBoxBackgroundStyle(), "none repeat scroll 0 0 #fff");
String footerStyle = LoginScreenHelper.getValueWithDefault(screenConfig.getFooterStyle(), "");
boolean disableBackgroundSizeCover = Boolean.TRUE.equals(screenConfig.getDisableBackgroundSizeCover());
String logoWidth = LoginScreenHelper.getValueWithDefault(screenConfig.getLogoWidth(), "113");
String logoHeight = LoginScreenHelper.getValueWithDefault(screenConfig.getLogoHeight(), "20");
String logoAlt = LoginScreenHelper.getValueWithDefault(screenConfig.getLogoAlt(), "Nuxeo");
String logoUrl = LoginScreenHelper.getValueWithDefault(screenConfig.getLogoUrl(), context + "/img/nuxeo_logo.png");


In order to be sure that your JSP page will override the default one, a modification must be added in the deployment-fragment.xml file of your bundle. In Nuxeo Platform, the module containing the login page is nuxeo-platform-webapp.

We want our bundle to be loaded after this module because our custom login page will override the default login page. To achieve this, add the following requirement in the deployment-fragment.xml, at the top of the file, just after the <fragment> tag.



a month ago Manon Lumeau Fix wording
3 years ago Solen Guitter 11
3 years ago Solen Guitter 10 | Update how-to topics
4 years ago Manon Lumeau 9
4 years ago Arnaud Kervern 8
5 years ago Manon Lumeau 7
5 years ago Manon Lumeau 6
5 years ago Solen Guitter 5
5 years ago Gildas Lefevre 4
5 years ago Gildas Lefevre 3
5 years ago Gildas Lefevre 2 | NXDOC-363: How to override the login page
5 years ago Gildas Lefevre 1
History: Created by Gildas Lefevre

We'd love to hear your thoughts!

All fields required