Redmine

h1. Themes

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

h2. Installing a theme

# 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:

<pre>

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

</pre>

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:

<pre>

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

</pre>

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:

<pre>

    Alias /assets/themes /themes

    <Location /themes>

        Allow from all

        Options -MultiViews

        Require all granted

    </Location>

</code></pre>

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

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

h2. Theme list

A list of available Redmine themes can be found at the [[Theme List|Redmine theme list]].

h2. Creating custom themes

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