Установка Redmine 6.0.6 на Debian 12

от

Пошаговая инструкция по установке Redmine 6.0.6 на Debian 12 с использованием Apache2 и MySQL. Также будет использоваться RVM для Ruby. Пользователь redmine создается при установке системы.

1. Установка обновлений и системных зависимостей

Bash
sudo apt update && sudo apt dist-upgrade -y

sudo apt install -y autoconf bison build-essential libssl-dev libyaml-dev libreadline-dev default-mysql-server default-mysql-client libmariadb-dev-compat libmariadb-dev imagemagick libmagickwand-dev apache2 libapache2-mod-passenger curl unzip mc htop iotop gnupg2 zlib1g-dev libncurses5-dev libffi-dev libgdbm-dev libgdbm-compat-dev libdb-dev dirmngr libsqlite3-dev libpq-dev libxml2-dev libxslt1-dev apache2-dev xapian-omega ruby-xapian libxapian-dev poppler-utils antiword catdoc libwpd-tools libwps-tools gzip unrtf catdvi djview djview3 uuid uuid-dev xz-utils libemail-outlook-message-perl git subversion

2. Настройка MySQL

Bash
sudo mysql_secure_installation

Задаем пароль пользовател root бд MySQL: «password»

3. Создание базы данных Redmine

Зайти в MySQL:

Bash
sudo mysql -u root -p

Создать базу данных и пользователя:

Bash
CREATE DATABASE redmine CHARACTER SET utf8mb4;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
FLUSH PRIVILEGES;
EXIT;

4. Установка RVM и Ruby

Импорт ключей:

Bash
gpg2 --keyserver keyserver.ubuntu.com --recv-keys \
409B6B1796C275462A1703113804BB82D39DC0E3 \
7D2BAF1CF37B13E2069D6956105BD0E739499BDB

Установка RVM:

Bash
curl -sSL https://get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm

Установка Ruby 3.2:

Bash
rvm install 3.2.2
rvm use 3.2.2 --default
ruby -v

5. Установка Redmine 6.0.6

Скачиваем последнюю версию Redmine и распаковываем в папку /opt/

Bash
cd /opt/
sudo wget https://www.redmine.org/releases/redmine-6.0.6.tar.gz
sudo tar -xzf redmine-6.0.6.tar.gz
sudo rm redmine-6.0.6.tar.gz
sudo mv redmine-6.0.6 redmine

Задаем разрешения для файлов и папок

Bash
sudo chown -R redmine:redmine /opt/redmine
sudo chmod -R 755 /opt/redmine
sudo mkdir -p /opt/redmine/tmp /opt/redmine/tmp/pdf /opt/redmine/public/plugin_assets
sudo chown -R redmine:redmine /opt/redmine/tmp /opt/redmine/public/plugin_assets
sudo chmod -R 755 /opt/redmine/tmp /opt/redmine/public/plugin_assets

Настройка подключения к базе данных

Переходим в папку /opt/redmine, cкопируйте шаблон конфигурации:

Bash
cp config/database.yml.example config/database.yml

Отредактируйте файл конфигурации:

Bash
nano config/database.yml
Bash
production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: "password"
  encoding: utf8mb4
  tx_isolation: 'READ-COMMITTED'

6. Настройка Gemfile и Bundler:

Bash
cd /opt/redmine
gem install bundler
bundle config set --local without 'development test'
bundle install

Инициализация базы и секретов

Bash
bundle exec rake generate_secret_token RAILS_ENV=production
bundle exec rake db:migrate RAILS_ENV=production
bundle exec rake redmine:load_default_data REDMINE_LANG=ru RAILS_ENV=production

7. Настройка Apache2 + Passenger

Passenger уже установлен с libapache2-mod-passenger.

Создайте виртуальный хост:

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

Вставьте следующее:

Bash
<VirtualHost *:80>
    ServerName redmine.local
    DocumentRoot /opt/redmine/public

    <Directory /opt/redmine/public>
        Require all granted
        Options -MultiViews
    </Directory>
    
    PassengerRuby /home/redmine/.rvm/gems/ruby-3.2.2/wrappers/ruby
    PassengerDefaultUser redmine
    
    ErrorLog ${APACHE_LOG_DIR}/redmine_error.log
    CustomLog ${APACHE_LOG_DIR}/redmine_access.log combined
</VirtualHost>

Включите сайт и перезапустите Apache:

Bash
sudo a2enmod passenger
sudo a2ensite redmine.conf
sudo a2dissite 000-default.conf
sudo systemctl restart apache2

✅ Готово!

Теперь вы можете открыть Redmine по ip адресу сервера

Логин и пароль по умолчанию:
— Username: admin
— Password: admin

8. Установка плагинов

Распаковываем архив с плагином в папку /opt/redmine/plugins/ и выполняем команды

обычно нужные команды есть в описании плагина.

Bash
bundle install
bundle exec rake db:migrate RAILS_ENV=production
bundle exec rake redmine:plugins NAME=имя плагина RAILS_ENV=production