How to Install Redmine on CentOS 8

Redmine is a flexible and open-source project management and issue tracking web application. It is written in Ruby on Rails, and offers multiple functionalities such as time tracking, version control integration, file management, and much more. Redmine is widely used by teams and organizations to manage their projects efficiently.

Step-by-Step Installation Guide:

Follow the steps below to install Redmine on CentOS 8:

First, update your system packages by running the following commands:

sudo dnf update
sudo dnf upgrade -y

Redmine requires several dependencies to work properly. Install them by running the following command:

sudo dnf install -y gcc mariadb mariadb-devel ImageMagick-devel ruby ruby-devel rubygem-bundler zlib-devel libcurl-devel patch sqlite-devel postgresql-devel nodejs

Redmine needs a database to store its data. Install MariaDB, create a new database, and a database user by executing the following commands:

sudo dnf install -y mariadb-server
sudo systemctl enable --now mariadb.service
sudo mysql_secure_installation
sudo mysql -u root -p
CREATE DATABASE redmine CHARACTER SET utf8mb4;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Download and install Redmine by running the following commands:

sudo mkdir /opt/redmine
sudo chown -R ${USER}:${USER} /opt/redmine
cd /opt/redmine
wget https://www.redmine.org/releases/redmine-4.2.0.tar.gz
tar xvf redmine-4.2.0.tar.gz
mv redmine-4.2.0 /opt/redmine/
cd redmine
cp config/configuration.yml.example config/configuration.yml
cp config/database.yml.example config/database.yml

Edit the configuration files to include your database settings. Open the database.yml file and modify the following lines:

sudo nano config/database.yml
...
production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: password
...

Save the changes and close the file.

Install the required gems by running the following command:

gem install bundler
bundle install --without development test

Generate a secret key for your Redmine installation using the following command:

rake generate_secret_token

Create the database structure and default data by running the following commands:

RAILS_ENV=production rake db:migrate
RAILS_ENV=production rake redmine:load_default_data

Configure your web server to serve Redmine. For example, if you are using Nginx, create a new configuration file:

sudo nano /etc/nginx/conf.d/redmine.conf

Add the following configuration:

server {
    listen       80;
    server_name  your_domain.com;
    root         /opt/redmine/redmine/public;

    passenger_enabled on;
    passenger_app_env production;
    rails_env production;
}

Save the changes and close the file.

Restart your web server for the changes to take effect:

sudo systemctl restart nginx

You can now access your Redmine installation by visiting your domain name or server's IP address in your web browser.

Follow the on-screen instructions to create an administrator account and configure additional settings.

1. Update System Packages:
2. Install Required Dependencies:
3. Install and Configure MariaDB:
4. Install Redmine:
5. Configure Redmine:
6. Install Required Gems:
7. Generate Secret Key:
8. Initialize Database:
9. Configure Web Server:
10. Restart Web Server:
11. Access Redmine:

Congratulations! You have successfully installed Redmine on CentOS 8.