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>

1. You now may need to restart Redmine so that it shows the newly installed theme in the list of available themes.

1. 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.