Image

In this guide, we have set up the Redmine application on a VPS server running Debian 12. The goal is to obtain a ready-to-use server with a working application and a clear setup. We will need to install the database, additional packages, Ruby, and configure the Apache web server. This guide is executed from the root user; if you are using a regular user, use the sudo command.
The configuration of the pre-configured server is available in the order form.
Version 5.1.3

1. Install the necessary packages

yum update
apt update && sudo apt upgrade -y
apt install ruby-full build-essential zlib1g-dev libxml2-dev libpq-dev libmagickwand-dev
apt install default-mysql-server default-mysql-client libmariadb-dev

2. Configure the database

mysql_secure_installation
mysql -u root -p
CREATE DATABASE redmine CHARACTER SET utf8mb4;
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
EXIT;

3. Download Redmine

wget https://www.redmine.org/releases/redmine-5.1.3.tar.gz
tar xzf redmine-5.1.3.tar.gz
mv redmine-5.1.3 /opt/redmine

Enter the database connection details

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

3.1 Application configuration

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

Update MariaDB to version 11.3:

https://synay.net/en/support/kb/updating-mariadb-server-debian-12

3. Import data

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

Configure the Apache2 web server:

chown -R www-data:www-data /opt/redmine

apt install libapache2-mod-passenger
a2enmod passenger

Create a file with the following content

nano /etc/apache2/sites-available/redmine.conf
< VirtualHost *:80>
#ServerName redmine.domain.tld
DocumentRoot /opt/redmine/public
< Directory /opt/redmine/public>
AllowOverride all
Options -MultiViews
< /Directory>
< /VirtualHost>

4. Apply the settings 

a2ensite redmine
service apache2 restart

Done, open your browser and access the server using its IP address

Login: admin
Password: admin

Redmine installation successfully completed.




No Comments Yet