Skip to main content
Version: Next

Redmine

Redmine is A web-based project management and issue tracking tool, used for Cloud Infrastructure Monitoring Agile Boards . Redmine is a flexible project management web application. Written using the Ruby on Rails framework, it is cross-platform and cross-database.

gui

Prepare​

When referring to this document to use Redmine, please read and ensure the following points:

  • This application is installed by Websoft9 console.

  • The purpose of this application complies with the GPL-2.0 open source license agreement.

  • Configure the domain name or server security group opens external network ports for application access.

Getting started​

Login to reset password​

  1. After installing Redmine in the Websoft9 console, view the application details through My Applications and get the login information in the “Access”.

  2. After entering the Redmine interface, click Login in the upper right corner.

  3. According to the system prompts, change the password and officially access the console.

Manage plugins​

Manage Redmine plugin is manage plugin sources at Redmine container directory /usr/src/redmine/plugins and need restart Redmine container takes effect

  • Install Plugins: Run below commands at Redmine container

    apt update -y && apt install unzip 
    curl -L -o plugin_name.zip  https://url/plugin_name.zip 
    unzip rplugin_name.zip -d /usr/src/redmine/plugins

  • Uninstall Plugin: Delete the plugin directory

  • After downloading and unzipping the plug-in, restart the container to take effect

  • Plugin version mismatch will cause the container can not start, need to uninstall the plugin

Set SMTP​

  1. Prepare the your SMTP
  2. Modify the configuration. yml file in the Redmine container and add below SMTP configurations at production: 
    production: 
    delivery_method: smtp 
    smtp_settings: 
       address: smtp.exmail.qq.com 
       port: 465 
       ssl: true 
       enable_starttls_auto: true 
       domain: websoft9.com 
       authentication: :login 
       user_name:  [email protected] 
       password: ********
  3. It works after restarting the Redmine container
  4. Redmine Console Settings for SMTP: Administration > Configuration > Email Notification

Configuration options​

  • Plugin Center(✅)
  • Multilingual(✅): Support project multilingualism and user multilingualism
  • Site directory in container(Have mounted): /usr/src/redmine
  • Configuration directory in container(Have mounted): /usr/src/redmine/configure
  • Configuration file in container (Have mounted): /usr/src/redmine/configuration/configuration.yml
  • CLI
  • API
  • SMTP (✅)

Administer​

Troubleshooting​

System error when project name is Chinese?​

Redmine Database character encoding needs to be modified to utf8

New registered users cannot login?​

Administrator needs to activate in the background before logging in