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: https://www.redmine.org/issues/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 /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.

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.