Installing Redmine in Ubuntu 18.04

Redmine is a powerful project management system open source. The program allows you to work in a web interface with several projects and subprojects. Redmine is cross-platform development based on Ruby on Rails.

It is very functional: a set of useful and convenient tools for managing projects and documents, databases, and similar functions. The program can work with several projects using access control lists based on roles and version control system – like Git, SVN and CVS). In this article we will discuss how to install Redmine Ubuntu 18.04.

Key benefits:

  • Multilingual;
  • Works with multiple databases, tracking the time;
  • There is the management of news, documents and files;
  • Manages feeds and email notifications.

Installing Redmine on Ubuntu 18.04

1. Install Apache and MariaDB

feeds and email notifications.
To work need the Redmine Apache server, and for storing the data, the program uses MariaDB. First you need to install Apache and MariaDB. To do this, run:

sudo apt install apache2 mariadb-server libapache2-mod-passenger-y

After installation is complete, start the services Apache and MariaDB. Next we need to add in startup:

sudo systemctl start apache2

sudo systemctl start mariadb

sudo systemctl enable apache2

sudo systemctl enable mariadb

2. Configure MariaDB

By default, MariaDB is not protected. Therefore, the first step is to establish security. This can be done using a script:

sudo mysql_secure_installation

Type answers to all questions:

Enter current password for root (enter for none):
Set root password? [Y/n]: N
Remove anonymous users? [Y/n]: Y
Disallow root login remotely? [Y/n]: Y
Remove test database and access to it? [Y/n]: Y
Reload privilege tables now? [Y/n]: Y

3. Installing Redmine

Redmine package is available in the Ubuntu repositories 18.04. The installation will begin after the introduction of the following commands:

sudo apt install redmine redmine-mysql -y

During installation you are prompted to configure Redmine:

Click Yes. Should appear this page:

Here, choose the MySQL database and click OK. Then you need to enter a password to access the database. Click OK and complete the installation.

Next, install the gem bundler. It is installed using the following command:

sudo gem install bundler

Create a symbolic link in the Apache root directory:

sudo ln-s /usr/share/redmine/public /var/www/html/redmine

Then you need to create the lock file:

sudo touch /usr/share/redmine/Gemfile.lock

Don’t forget to grant permissions using this command:

sudo chown www-data:www-data /usr/share/redmine/Gemfile.lock

sudo chown-R www-data:www-data /var/www/html/redmine

4. Configuring Apache

Now you need to edit the file passenger.conf and making some changes. Type the following command:

sudo vi /etc/apache2/mods-available/passenger.conf

Make the following changes:

<IfModule mod_passenger.c>
PassengerDefaultUser www-data
PassengerRoot /usr/lib/ruby/vendor_ruby/phusion_passenger/locations.ini
PassengerDefaultRuby /usr/bin/ruby

Create a file virtual host Apache using this command:

sudo vi /etc/apache2/sites-available/redmine.conf

<VirtualHost *:80>
ServerAdmin [email protected]
DocumentRoot /var/www/html/redmine
ServerAlias www.exampsudo nano /etc/apache2/mods-available/
<Directory /var/www/html/redmine>
RailsBaseURI /redmine
PassengerResolveSymlinksInDocumentroot on
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined

Replace your own domain name. After saving the file, enable the virtual host Redmine and the rewriting module with the following command:

sudo a2ensite redmine

sudo a2enmod rewrite

Finally, restart Apache to apply all changes:

sudo systemctl restart apache2

To test the Apache web server, enter this command:

sudo systemctl status apache2

It should look this:

5. The web interface of the program

After installing Redmine, it is possible to access it via a web browser. Open a web browser and enter the URL of the Redmine installation (for example, Should open this page:

Press Entrance. You will be redirected to the login page in Redmine:

Enter a name and administrator password and click Login. You should get output similar to this:

Change the password and click Apply. Should get the following page:


Great! you’ve installed and configured Redmine Ubuntu 18.04. Despite the fact that the program used is not quite the usual stack instead of php used Ruby on Rails, a program to install not too difficult. And what project managers do you use? Write in the comments!


(Visited 102 times, 1 visits today)