Ubuntu 20.04 安装 RedMine 项目管理工具

服务器系统是 Ubuntu 20.04，这里以该系统为例记录 RedMine 的安装步骤及注意事项。

安装 RVM 和 Ruby 2.8

RVM 的简介和安装步骤参考我写的。

安装 MySQL

已经安装了 MariaDB 10.5：

$ mysql --version
mysql  Ver 15.1 Distrib 10.5.6-MariaDB, for debian-linux-gnu (x86_64) using readline 5.2

创建数据库和连接信息：

MariaDB [(none)]> create database redmine default charset utf8mb4 default collate utf8mb4_unicode_ci;
MariaDB [(none)]> grant all on redmine.* to 'redmine_user'@'localhost' identified by 'xxx';

安装 Redmine

安装依赖包：

$ sudo apt install libmysqlclient-dev imagemagick

下载最新版 Redmine 4.2.3（最新版本查看）：

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

解压缩到指定目录并建立软链接：

$ sudo tar xzvf redmine-4.2.3.tar.gz -C /opt/app
$ sudo ln -s /opt/app/redmine-4.2.3/ /opt/app/redmine

配置数据库参数：

$ cd /opt/app/redmine/config
$ sudo cp database.yml.example database.yml
$ sudo vi database.yml

修改为正确的连接信息，注意替换 my_password 为正确的密码：

production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine_user
  password: "my_password"
  # Use "utf8" instead of "utfmb4" for MySQL prior to 5.7.7
  encoding: utf8mb4

Redmine 使用 Bundler 管理 gems 依赖，因此要先安装 Bundler。安装前先切换到 root 用户：

$ sudo su

安装 Bundler：

# gem install bundler

使用 Bundler 安装 Redmine 依赖：

# cd /opt/app/redmine
bundle config set --local without 'development test postgresql sqlite'
bundle install

设置密钥：

bundle exec rake generate_secret_token

创建数据表：

bundle exec rake db:migrate RAILS_ENV=production

初始化数据表：

bundle exec rake redmine:load_default_data RAILS_ENV=production

使用 webrick 测试安装：

bundle exec rails server webrick -e production

启动成功之后，默认是监听的 3000 端口，注意查看服务器防火墙是否开启了 3000 端口的流量。访问 http://ip:3000 即可打开 Redmine，默认的用户名和密码，均是 admin，首次登录会要求修改密码。

邮箱设置

TODO……

代理设置

TODO……

在线版体验

我在服务器上已经安装好了 Redmine 4.2.3，有需要使用体验的用户联系我 yxz_blue#126.com（# 替换为 @）。

参考链接

CentOS 7 安装 Redmine 4.1 - Zhanming's blog
RedMine安装教程（Redmine3.4.5） - 简书
如何在Ubuntu 18.04上安装和配置Redmine
RVM 实用指南 · Ruby China
RedmineInstall - Redmine
untrusted connection: Redmine, Passenger, and Nginx on Ubuntu 16.04