Custom Login Page

The default landing / login page for IRIDA can be replaced by an institution without modifying the existing one.

Create a html file called login.html on your files system, and save it to the path /etc/irida/templates/;

# Overwritten UI templates

Use IRIDA base login form.

IRIDA uses a React component as its login form and can be added to any template by adding:

Adding custom resources

Images, CSS and JS files can be added into /etc/irida/static and then loaded onto the custom login page. Ensure that the Thymeleaf attributes are added, for example:


* Image: `<img th:src="@{/static/myImage.png}" alt="A great picture or logo" >`
* JS: `<script th:src="@{/static/myFile.js}"></script>`
* CSS: `<link th:href="@{/static/myFile.css}" />`


<!DOCTYPE html>
<html lang="en">
    <link rel="stylesheet" th:href="@{/dist/css/login.bundle.css}" />
    <script th:inline="javascript">
      window.PAGE = {
        BASE_URL: /*[[@{"/"}]]*/ "/"
    <div id="login-root"></div>
    <script th:src="@{/dist/js/login.bundle.js}"></script>

Example of Custom login page

Code for a basic custom login page.

Custom Login Page

Code for a more involved login page with added CSS.

Custom Login Page

Create a custom login form

To create a fully custom login page, you need to include a form that POSTs to the url /login, with two elements:

  1. username input
  2. password input

If the authorization attempt fails, the server will redirect the /login?error=true which can be captured with JavaScript and display an error message to the user.

Please note in the example below the th: attributes on the form and other elements, this is from the server templating laguage Thymeleaf and will do the follow:

For more information of the Thymeleaf please see their online documentation.

<form method="post" th:action="@{/login}">
      <label for="name" th:text="#{LoginPage.username}">Username</label>
      <input id="name" name="username" type="text">
      <label for="password" th:text="#{LoginPage.password}">Password</label>
      <input id="password" name="password" type="password" >
    <button type="submit" th:text="#{LoginPage.submit}">Login</button>
      <a th:href="@{/password_reset}" th:text="#{LoginPage.forgot}">Forgot Password</a>
      <a th:href="@{/password_reset/activate}" th:text="#{LoginPage.activate}">Activate Account</a>