How to install Redmine on Debian Latest?

Redmine is an open-source project management and issue tracking tool that is capable of managing multiple projects and supports multiple databases. In this tutorial, we will guide you through the process of installing Redmine on Debian Latest using Apache and MySQL.

Step 1: Update your system

It's always recommended to update your server before installing any software. Use the following command to update your Debian system:

sudo apt update && sudo apt upgrade -y 

Step 2: Install dependencies

Before installing Redmine, you'll need to install some dependencies required by Redmine. Use the following command to install them:

sudo apt install -y apache2 mariadb-server libapache2-mod-passenger libapache2-mod-deflate libapache2-mod-security2 imagemagick libmagickwand-dev libsqlite3-dev cmake gcc g++ make zlib1g-dev pkg-config libcurl4-openssl-dev

Note: Modify the command according to your requirement.

Step 3: Install Ruby

Redmine is a Ruby application, so you'll need to install Ruby before installing Redmine. Use the following command to install Ruby:

sudo apt install -y ruby-full

Step 4: Install Redmine

Now, we'll download and install Redmine. Follow the steps below:

1. Download the latest version of Redmine from the official Redmine website using the following command:

wget https://www.redmine.org/releases/redmine-x.x.x.tar.gz

Note: Replace x.x.x with the latest version number.

2. Unpack the downloaded file using the following command:

tar -zxvf redmine-x.x.x.tar.gz

3. Create a symbolic link to the Redmine directory using the following command:

sudo ln -s /opt/redmine-x.x.x /opt/redmine

Note: Replace x.x.x with the latest version number.

4. Copy the configuration file to the Redmine directory:

cp /opt/redmine/config/configuration.yml.example /opt/redmine/config/configuration.yml

5. Edit the configuration file using the following command:

nano /opt/redmine/config/configuration.yml

6. Replace the sample configuration with the following configuration:

production:
   email_delivery:
        delivery_method: :smtp
        smtp_settings:
          address: your smtp server
          port: your port number
          domain: your domain
          authentication: :login
          user_name: your username
          password: your password

Note: Replace the above configuration with the correct values of your SMTP server.

7. Install the required Ruby gems:

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

Step 5: Setup the database

1. Secure the MySQL installation:

sudo mysql_secure_installation

2. Create a new MySQL database and user for Redmine:

sudo mysql -uroot -p
CREATE DATABASE redmine CHARACTER SET utf8;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'redmine_password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
FLUSH PRIVILEGES;
exit;

Note: Please replace redmine_password with your preferred password.

3. Initialize the Redmine database:

cd /opt/redmine
RAILS_ENV=production bundle exec rake db:migrate
RAILS_ENV=production bundle exec rake redmine:load_default_data

Step 6: Configure Apache

1. Download the Apache configuration file using the following command:

wget -O /etc/apache2/sites-available/redmine.conf https://www.redmine.org/projects/redmine/repository/raw/branches/4.2-stable/extra/svn/Redmine.pm/apache/redmine.conf

2. Edit the configuration file:

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

3. Replace the following line with your server's hostname:

ServerName your_domain.com:80

4. Replace the following lines with the correct path of your Redmine installation:

DocumentRoot /opt/redmine/public
<Directory /opt/redmine/public>

5. Enable the Apache configuration for Redmine:

sudo a2ensite redmine.conf
sudo a2enmod rewrite
sudo service apache2 restart

Step 7: Access Redmine

1. Navigate to your server's IP address using your web browser: http://your_ip_address/

2. You will see the Redmine login page. Enter the credentials you set up during the installation process.

Congratulations! You have successfully installed Redmine on Debian Latest. Now you can start managing your projects and issues with Redmine.