How to Install Redmine on CentOS 7

Install Redmine on CentOS 7

In this article, we will have explained the necessary steps to install and configure Redmine on CentOS 7. Before continuing with this tutorial, make sure you are logged in as a user with sudo privileges. All the commands in this tutorial should be run as a non-root user.

Redmine is one of the most popular open source project management and issue tracking software tools. It is cross-platform and cross-database and built on top of the Ruby on Rails framework. Redmine includes support for multiple projects, wikis, issue tracking system, forums, calendars, email notifications, and much more.

Install Redmine on CentOS

Step 1. The first command will update the package lists to ensure you get the latest version and dependencies.

Step 2. Install Dependency.

Install the packages required for building Redmine and Ruby from source:

Step 3. Install MariaDB.

Redmine supports MySQL/MariaDB, Microsoft SQL Server, SQLite 3 and PostgreSQL. In this tutorial we’ll use MariaDB as a database back-end:

When the installation is complete, run the following command to secure your installation:

Then, we need to create a database for our Redmine installation:

Step 4. Creating New System User.

Create a new system user for Redmine:

Switch to the new redmine user:

Step 5. Install Ruby using RVM.

The version of Ruby in the CentOS repositories is pretty outdated and not supported by Redmine. We’ll install Ruby using RVM:

To start using RVM run the following commands:

Step 6. Install Redmine.

Download the Redmine archive with the following curl command:

Once the download is completed extract the archive:

Configure database settings:

Open the file with your text editor:

Step 7. Install Gems.

Next step, install gems using following command:

Prepare the database:

Step 8. Puma configuration.

Create a new configuration file as follows:

Start the puma server with:

The output should be similar to the following:

Step 9. Access Redmine.

Finally your can start your browser and access your new Redmine installation at: http://IP_ADDRESS:9000

Congratulation, you have learned how to install and configure Redmine on CentOS 7. If you have any question, please leave a comment below.