How to install Redmine on Ubuntu 20.04 Linux

The
You can download this article in PDF format to support us through the following link.

Download the guide in PDF format

turn off
The

The
The

This short guide will guide you through the installation of Redmine on Ubuntu 20.04 LTS. Redmine is a free open source project management tool with a web-based management dashboard where users can manage projects. Redmine is built on the Ruby on Rails framework. With Redmine, you can track the time on the project, the documentation, and write Wiki pages for the project. Its RBAC ensures that there is a structured access structure.

The functions of the Redmine project management tool include:

After installing Redmine on Ubuntu 20.04, you can add this feature as needed.

Set prerequisites

You need to use Ubuntu 20.04 Linux and another running server:

  • SSH user with sudo privileges-root user can also
  • Domain for hosting Redmine-for example projects.example.com
  • SSL certificate (if security protection is planned)-If the server accesses the Internet through a public IP address, “encryption” can be used.

Step 1: Connect to the server and update

SSH to your server:

$ ssh [email protected]

Start updating it to get the latest package to be updated on the server.

sudo apt update
sudo apt upgrade
sudo reboot

Step 2: Install MariaDB database server

After updating, install and configure MariaDB database server on Ubuntu 20.04. Ubuntu 18.04.

sudo apt update
sudo apt install mariadb-server

Confirm it is working:

$ sudo mysql -u root

Enter password: 
Welcome to the MariaDB monitor.  Commands end with ; or g.
Your MariaDB connection id is 57
Server version: 10.3.22-MariaDB-1ubuntu1 Ubuntu 20.04

Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.

Type 'help;' or 'h' for help. Type 'c' to clear the current input statement.

MariaDB [(none)]> 

Step 3: Create a database for Redmine

After installing the database server on Ubuntu, let us create the database and user for the Redmine project management platform.

$ sudo mysql -u root -p
CREATE DATABASE redmine CHARACTER SET utf8mb4;
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY '[email protected]';
FLUSH PRIVILEGES;
EXIT;

Confirm that the redmine database user can log in to the MySQL Shell using the configured password.

$ mysql -u redmine -p
Enter password: 
Welcome to the MariaDB monitor.  Commands end with ; or g.
Your MariaDB connection id is 59
Server version: 10.3.22-MariaDB-1ubuntu1 Ubuntu 20.04

Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.

Type 'help;' or 'h' for help. Type 'c' to clear the current input statement.

MariaDB [(none)]> SHOW DATABASES;
+--------------------+
| Database           |
+--------------------+
| information_schema |
| redmine            |
+--------------------+
2 rows in set (0.000 sec)

MariaDB [(none)]> QUIT
Bye

Step 4: Install Apache, Ruby and Passenger

We will install passenger Application server that Ruby will use and integrate into Apache to serve Redmine on Ubuntu

sudo apt install apache2 libapache2-mod-passenger

Step 5: Install Redmine on Ubuntu 20.04

Run the following command to install Redmine on Ubuntu 20.04 Linux.

sudo apt install redmine redmine-mysql

When asked to configure the database, answer Yes.

Enter the database password:

How to install Redmine on Ubuntu 20.04 Linux

confirm password:

How to install Redmine on Ubuntu 20.04 Linux

The successful installation output is as follows:

......................
/usr/share/rubygems-integration/all/gems/activerecord-5.2.3/lib/active_record/persistence.rb:705: warning: Using the last argument as keyword parameters is deprecated; maybe ** should be added to the call
/usr/share/rubygems-integration/all/gems/activerecord-5.2.3/lib/active_record/timestamp.rb:105: warning: The called method `_update_record' is defined here
/usr/share/rubygems-integration/all/gems/activerecord-5.2.3/lib/active_record/connection_adapters/mysql/database_statements.rb:12: warning: Using the last argument as keyword parameters is deprecated; maybe ** should be added to the call
/usr/share/rubygems-integration/all/gems/activerecord-5.2.3/lib/active_record/connection_adapters/abstract/query_cache.rb:95: warning: The called method `select_all' is defined here
/usr/share/rubygems-integration/all/gems/activerecord-5.2.3/lib/active_record/statement_cache.rb:90: warning: Capturing the given block using Proc.new is deprecated; use `&block` instead
/usr/share/rubygems-integration/all/gems/activerecord-5.2.3/lib/active_record/statement_cache.rb:90: warning: Capturing the given block using Proc.new is deprecated; use `&block` instead
/usr/share/rubygems-integration/all/gems/activerecord-5.2.3/lib/active_record/statement_cache.rb:90: warning: Capturing the given block using Proc.new is deprecated; use `&block` instead
/usr/share/rubygems-integration/all/gems/activerecord-5.2.3/lib/active_record/statement_cache.rb:90: warning: Capturing the given block using Proc.new is deprecated; use `&block` instead
Default configuration data loaded.
Processing triggers for man-db (2.9.1-1) ...
Processing triggers for libc-bin (2.31-0ubuntu9) ...

Install the bundler gem:

sudo gem update
sudo gem install bundler

Configure the Apache Passenger module.

sudo tee /etc/apache2/mods-available/passenger.conf<
  PassengerDefaultUser www-data
  PassengerRoot /usr/lib/ruby/vendor_ruby/phusion_passenger/locations.ini
  PassengerDefaultRuby /usr/bin/ruby

EOF

Now create a symbolic link to connect Redmine to the web document space:

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

Visit Redmine web console domain name

Create a VirtualHost file for Redmine.

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

Add configuration data-replace projects.computingforgeeks.com With your domain name.


  ServerAdmin [email protected]
  DocumentRoot /var/www/html/redmine
  ServerName projects.example.com
  ServerAlias www.projects.example.com
  
    RailsBaseURI /redmine
    PassengerResolveSymlinksInDocumentRoot on
  

  ErrorLog ${APACHE_LOG_DIR}/error.log
  CustomLog ${APACHE_LOG_DIR}/access.log combined

Create and set the ownership of the Gemfile.lock file so that the www-data user of apache can access it:

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

Enable the Redmine website according to the configuration:

sudo a2ensite redmine.conf
sudo systemctl restart apache2.service

You should now be able to access redmine using your domain: http://projects.example.com

How to install Redmine on Ubuntu 20.04 Linux

The default login credentials are:

Username: admin
Password: admin

How to install Redmine on Ubuntu 20.04 Linux

Change the password in the next screen.

How to install Redmine on Ubuntu 20.04 Linux

Now, you have made Redmine work on Ubuntu 20.04 Linux.

How to install Redmine on Ubuntu 20.04 Linux

Use the IP address to access the Redmine web console

Modify the default Apache configuration:

sudo tee /etc/apache2/sites-available/000-default.conf<
  ServerAdmin [email protected]
  DocumentRoot /var/www/html
  ErrorLog ${APACHE_LOG_DIR}/error.log
  CustomLog ${APACHE_LOG_DIR}/access.log combined
  
    RailsBaseURI /redmine
    PassengerResolveSymlinksInDocumentRoot on
  

EOF

Create and set ownership of the Gemfile.lock file so that the www-data user of apache can access it

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

Load the Passenger module and restart the Apache server:

sudo a2enmod passenger
sudo systemctl restart apache2

You should now be able to access redmine from the server IP address or hostname: http: // server_ip_or_hostname / redmine

The default login credentials are:

Username: admin
Password: admin

Like to use Redmine Project management tool on Ubuntu 20.04 Linux machine.

More guidelines:

Install OpenProject Community Edition on CentOS 8

Install OpenProject Community Edition on Debian

Install OpenProject on Ubuntu

The
You can download this article in PDF format to support us through the following link.

Download the guide in PDF format

turn off
The

The
The

Sidebar