This article describes how to install Boostmine and Zenmine theme in your Redmine application. Installing Boostmine is very easy and should not take more than a minute. We assume you already have a working Redmine installation and a user with

1. server root access
2. application admin privileges

Installing the theme in your server (Redmine 6.x) #

Since Redmine 6, the application has changed the way it manages the themes. Please follow these steps:

• Step 1: login to your Redmine server with an SFTP tool.
• Step 2: locate your Redmine application root folder
• Step 3: go to the themes folder in /redmine/themes/
• Step 4: unzip the zipped theme file that you downloaded from your Account in Best Redmine Theme.
• Step 5: upload the whole /boostmine/ or /zenmine/ folder inside the /themes/ folder.
• Step 6: restart your web server

IMPORTANT – In case the theme is still not displayed correctly in Redmine’s interface, you will need to follow these steps:

• Step 1: SSH to your Redmine’s root directory
• Step 2: launch the following command:
  bundle exec rake assets:precompile RAILS_ENV="production"
  If deploying to a sub-uri, set the relative URL root as follows:
  bundle exec rake assets:precompile RAILS_ENV="production" RAILS_RELATIVE_URL_ROOT=/sub-uri
  Note: in the commands you may need to include “sudo” first depending on your SSH user.
• Step 3: restart the web server. This should be enough for the system to recompile the theme’s assets

IMPORTANT: in Redmine 6 any time you do a change in your customize.css file, you will have to restart your web server to see the changes.

Installing the theme in your server (Redmine 3.x-5.x) #

• Step 1: login to your Redmine server with an SFTP tool.
• Step 2: locate your Redmine application root folder
• Step 3: go to the themes folder in /redmine/htdocs/public/themes/
• Step 4: unzip the zipped theme file that you downloaded from your Account in Best Redmine Theme.
• Step 5: upload the whole /boostmine/ folder inside the /themes/ folder.

And that’s it! Boostmine theme is installed in your server. Now you have to activate the theme in your Redmine application.

This is the theme directory in a Bitnami server. For other type of servers you may have other path for your server directory, but not for the theme directory, which is the same.

Activating the theme in your Redmine application #

Next, after the installation process completes, perform the following steps:

• Step 1: login to your Redmine application as an administrator.
• Step 2: Go to Administration > Settings > tab “Display”
• In “Theme”field, select Boostmine. Press “Save”.

And that’s it again. That easy! You and your users can now enjoy Boostmine’s modern interface.

Thank you for reading.