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. |
|
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