Installing Redmine on Ubuntu 20.04

Redmine is a popular open-source project management and issue tracking application. It provides various features such as task management, Gantt charts, time tracking, wiki, and more. Redmine is built using Ruby on Rails framework and uses a database backend like MySQL or PostgreSQL.

Prerequisites

Before installing Redmine, make sure you have the following prerequisites:

• A fresh installation of Ubuntu 20.04
• Root or sudo access to the server
• Ruby and RubyGems
• MySQL or PostgreSQL database server
• Web server (Apache or Nginx)

Step 1: Install Required Packages

Start by updating the system packages using the following command:

sudo apt update && sudo apt upgrade

Install the required packages for Redmine by running the following command:

sudo apt install -y build-essential mariadb-server libmariadb-dev nodejs imagemagick libmagickwand-dev libcurl4-gnutls-dev libssl-dev zlib1g-dev libxslt-dev libxml2-dev gcc g++ make patch pkg-config libc6-dev patch ruby-dev libmysqlclient-dev

Step 2: Install Ruby and RubyGems

Install Ruby and RubyGems by executing the following command:

sudo apt install -y ruby-full

Once the installation is complete, you can verify the installed version of Ruby by running:

ruby --version

Step 3: Install Redmine

Download the latest stable release of Redmine using the following command:

cd /opt
sudo wget https://www.redmine.org/releases/redmine-latest.tar.gz
sudo tar zxf redmine-latest.tar.gz

Step 4: Configure the Database

Create a new database and database user for Redmine. Replace ``, ``, and `` with your desired values.

sudo mysql -u root -p
CREATE DATABASE  CHARACTER SET utf8mb4;
CREATE USER ''@'localhost' IDENTIFIED WITH mysql_native_password BY '';
GRANT ALL PRIVILEGES ON .* TO ''@'localhost';
FLUSH PRIVILEGES;
EXIT;

Step 5: Setup Redmine Configuration

Edit the database configuration file by running:

cd /opt/redmine/config
sudo cp database.yml.example database.yml
sudo nano database.yml

Update the configuration file with the database connection details you created in the previous step. During the configuration, you can also set the Redmine administrator account details by modifying `username`, `password`, and `email` fields in `database.yml` file. Save and close the file when you are finished.

Step 6: Install Required Gems

Install the required gems for Redmine by running the following command:

cd /opt/redmine
sudo gem install bundler
sudo bundle install --without development test

Step 7: Generate Secret Key

Generate a unique secret key for Redmine by running:

sudo bundle exec rake generate_secret_token

Step 8: Setup Database

Run the following command to setup the database schema:

sudo RAILS_ENV=production bundle exec rake db:migrate

Step 9: Load Default Data

Load the default data into the database using:

sudo RAILS_ENV=production bundle exec rake redmine:load_default_data

Step 10: Configure Web Server

Configure your web server to serve Redmine. If you choose Apache, create a new VirtualHost configuration file:

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

Insert the following content into the file:

    ServerName your_domain_or_ip
    ServerAdmin webmaster@localhost
    DocumentRoot /opt/redmine/public

    
        Options FollowSymLinks
        AllowOverride None
        Order allow,deny
        Allow from all
        Require all granted
    

    ErrorLog ${APACHE_LOG_DIR}/redmine_error.log
    CustomLog ${APACHE_LOG_DIR}/redmine_access.log combined

Replace `your_domain_or_ip` with your domain name or server IP address.

Enable the Redmine virtual host configuration and restart Apache:

sudo a2ensite redmine.conf
sudo systemctl restart apache2

Step 11: Access Redmine

You can now access Redmine by visiting `http://your_domain_or_ip` in your browser. The first time you access it, you will be prompted to create the initial administrator account. Once done, you can start using Redmine for managing your projects and tracking issues.

This concludes the installation of Redmine on Ubuntu 20.04.