This guide will show you how to install Redmine or Easy Redmine from scratch using Redmine Installer Gem. As ever you need to have proper software and hardware/server configuration.

A prerequisite for installing is to have a Redmine or Easy Redmine package downloaded to the server. This package is available in the client zone. If you do not know your login credentials to the client zone, contact us via web chat (right bottom corner icon) or reach us on our support contacts.

0) Before you start

Please make sure you have proper hardware and software server configuration as described here. Some more useful information:

  • The webserver must have FULL access to public, files, log, tmp folders => DO NOT RUN REDMINE INSTALLER UNDER ROOT!
  • Webrick web server is NOT supported
  • Easy Redmine plugins go to [redmine_root]/plugins/easyproject/easy_plugins
  • The installation does NOT set-up CRON automatically - you need to do it manually
  • For correct running of the Redmine installer, at least 250 MB is required free on the root disc
  • Server must have unrestricted internet connection, at least at the time of installation
  • For smooth running of Easy Redmine we recommend this server configuration
  • Download and run this automatic check to uncover any problematic points

1) Redmine Installer Ruby Gem

In order to install new Redmine or Easy Redmine, you need to install Redmine installer Ruby into a compiled Ruby. To install this gem use: 

Request Installer download!

$ gem install redmine-installer

2) Installation

As the installer gem is installed in your Ruby, you can run installation using this command:

$ redmine install

Instead of use name your installation package downloaded from client zone.

The installation wizard takes you through following steps:

1) Redmine Root - you need to define a folder where Redmine will be installed
2) Load Package
3) Database configuration - definition of database type (MySQL or PostgreSQL)
4) E-mail configuration
5) Installation
6) Moving Redmine - Redmine is moved to defined root (step 1)
7) Webserver configuration

Commands for Redmine Installation - from Archive

Supported archives are .zip .tar.gz

redmine install PATH_TO_PACKAGE
# with environment
redmine install PATH_TO_PACKAGE --env environment


$ redmine install

3) Further Information after Installation

  • CRON needs to be set-up manually

Find complete information in the Gem documentation

Additional information

Easy Redmine 2018 Free Trial

Full-featured, 30 Days, SSL protected, Daily Backups, In your Geo Location