Themes » History » Revision 18
Revision 17 (Kelvin Quee, 2024-11-18 09:52) → Revision 18/20 (Kelvin Quee, 2024-11-19 02:54)
h1. Themes Redmine provides basic support for themes. Redmine themes can override stylesheets only (like @application.css@). h2. 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: <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><code class="xml"> Alias /assets/themes /themes <Location /themes> Allow from all Options -MultiViews Require all granted </Location> </code></pre> # 2. You now may need to restart Redmine so that it shows the newly installed theme in the list of available themes. # 2. 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.