Themes¶

Redmine provides basic support for themes. Redmine themes can override stylesheets only (like application.css).

Installing a theme¶

1. If you are on Redmine version 5 or below: First, copy the theme-directory into ../public/themes/. This would result in a directory-path to application.css like:
   

   ../public/themes/<themename>/stylesheets/application.css
   

   
   If you are on Redmine version 6.0 or above: Please copy the theme-directory into /themes/ instead. This would result in a directory-path to application.css like:
   

   /themes/<themename>/stylesheets/application.css
   

   
   This is consistent with the requirements (breaking change) as document here: #39111
   Additionally, for Redmine 6 or above, you will need to serve another directory on your chosen web server. For Apache2, you may consider adding the following config to your current site:
   

       Alias /public/assets/themes /themes
       <Location /themes>
           Allow from all
           Options -MultiViews
           Require all granted
       </Location>
   

2. You now may need to restart Redmine so that it shows the newly installed theme in the list of available themes.
3. Go to "Administration -> Settings" -> "Display" and select your newly created theme in the "Theme" drop-down list. Save your settings.
4. Starting with version 6.0, Redmine tries to automatically generate the assets at startup time. In case of any issue, you can review the instructions from RedmineInstall.

Redmine should now be displayed using the selected theme.

Theme list¶

A list of available Redmine themes can be found at the Redmine theme list.

Creating custom themes¶

There is a howto (HowTo create a custom Redmine theme) which explains how to create a custom Redmine theme.