Themes » History » Revision 21
Revision 20 (Katsuya HIDAKA, 2024-12-05 02:02) → Revision 21/21 (Daniel Melo, 2025-03-28 15:23)
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 /public/assets/themes /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.