DHIS2 Custom Login Page

I would like to inquire about the possibility of implementing a fully customized login page in DHIS2.

Specifically, I want to use my own custom login.html file instead of the default DHIS2 login interface.

Could you please guide me on the following points:

  • Is it possible to replace or override the default DHIS2 login page with a custom one?
  • Where should the custom login file be placed (e.g., dhis2/custom directory, /opt/dhis2 , or another location)?
  • What is the recommended or supported method for implementing this customization?
  • Are there any best practices or limitations I should be aware of?

I would appreciate your guidance on how to properly implement this.

Regards,
Tahir

I have Successfully changed the login page by changing the index file in webapps folder in dhis-web-login folder.
there we can can find folder for assets and can also change or alter the index.html file for the login page.

2 Likes

Hi @Tahir_Zaman

There’s an option to have custom login page from the Settings app as explained in the docs: Settings and configuration - DHIS2 Documentation

I think you need to be in version 41, so I assume your workaround is for earlier versions? Thanks for sharing it! :slight_smile:

Yeah I was Working on the version 2.40.5

1 Like