What Is Redmine?

Redmine is basically an issue tracker at its core. It was created to aid teams in collaborating on project tasks, issues, features, and steps, as well as visually tracking their progress and planning their future actions. Redmine also makes it simple to discuss ideas with your team members and manage your team's expertise, in addition to the normal project management setup. You can keep track of details unrelated to the issues you're tracking on an internal blog, forum, or wiki.

Despite the fact that there are a plethora of project management tools on the market, some of which duplicate Redmine's functionality, Redmine stands out since it is open source. This implies that anyone can read and download the source code, as well as rewrite portions of it and contribute to the project. Multiple project and database support, role-based access to projects and issues, custom fields for issues, time-entries, projects, and user issue submission through email are just a few of the features that the Redmine community has built and distributed over the years.

Redmine Demo

What Do We Serve?

1. Application Consultation For Redmine Open Source Software.

We have a skilled and experienced consultation team at AssistNix that delivers excellent application consulting services for open source software such as Redmine. We assist businesses in creating and implementing a complete project strategy, as well as authenticating it for end-user acceptance. Our holistic approach begins with an assessment of your business needs, after which we collaborate with you to develop a path for transforming your company into a business intelligence company.

2. Redmine On-Premises Installation And Configuration.

We also offer on premise installation and configuration of Redmine apps at AssistNix. We'll set up and organize the app, install files and make shortcuts, and set up and configure specific files and data, such as the registry and software servers. In a nutshell, we'll make sure it's installed correctly for you.

3. Issues Fixes On Self Hosted Servers

Our knowledgeable team at AssistNix also assists customers with difficulties related to self-hosted servers. Many factors might create server failures, making it difficult to pinpoint the source of the problem. But there's good news: Our experts will assist you in determining the source of the problem and then resolve all of the troubles that your self-hosted server is experiencing.

4. Redmine Application SaaS Hosting.

At AssistNix, we offer the most adaptable Redmine app hosting available. Our luxury application hosting is available on all platforms. We open you limitless possibilities for your digital journey and ensure that you have the greatest online App Hosting to frame your smart space. We offer the most appropriate and cost-effective App Hosting services.

5. Redmine Application User Guide & Application Use

You'll also get a fantastic Redmine program user guide. The user manual will assist you in learning how to use the application and getting the most out of it. As a result, we deliver high-quality user documentation for the Redmine software program, ensuring customer happiness and improving customer support.

Key Features Of Redmine

Redmine has all the features you need to accelerate your business growth and provide exceptional customer experiences.

List Of Key Features 

• Time Tracking
• Task management
• File Sharing
• Project Planning
• Status Tracking
• Reporting
• Workflow management
• Gantt Charts
• Milestone Tracking
• Collaboration
• Document Comparison
• Dashboard
• Data Exports/Imports

Redmine Plugins Directory

What is redmine plugin? This plugin will report all exceptions thrown in your redmine installation to a defined Sentry-Server. Supported are both the cloud version and on-premise sentry installations.

Redmine Plugins: Install / Uninstall / Write / Migrate 

All exceptions thrown in your Redmine installation will be sent to a Sentry-Server using the Redmine Sentry Client plugin.

Both the cloud version and on premise sentry installations are supported.

Notes on installation; To install Redmine plugins, use the default method. Get the plugin's source code. Unpack the downloaded ZIP into your Redmine-installation>/plugins directory, either from the Plugins Directory or the Git Repository.

With bundle install, you can install dependencies.

Redmine should be restarted. You can look through and search for Redmine plugins here. Plugin authors can use their account to register their own plugins.

The plugins page contains general information about Redmine plugins and how to install them in your Redmine. Redmine Plugins come in a range of shapes and sizes. If you wish to install one, go to #RAILS ROOT/plugins and copy your plugin directory there. If you want to get the plugin directly from GitHub, go to your plugin directory and do a git clone. Run the command in #RAILS ROOT to upgrade your database if the plugin demands it (make a DB backup before). After that, restart Redmine. In Administration -> Plugins, you should now be able to see the plugin list and configure the newly installed plugin (if the plugin requires to be configured).

Redmine Installation

When prompted, click Yes to enable dbconfig-common to configure the database, as shown in the panel below. Then you must supply the database's "root" password so that the installer can establish the Redmine database. This is the password you chose when installing MySQL. By selecting "MySQL" from the list of database options, we can tell the Redmine installer that we'll be utilizing MySQL for this installation. You will now be prompted to enter a password to safeguard the Redmine database. When Redmine needs to connect to MySQL, it will use this. Now you must confirm your Redmine password. It will also be installed.

How To Install Redmine 4.0

This is the installation documentation for Redmine 4.0 and higher. You can still read the document for older versions: 3.x , 1.4.x - 2.6.x, 1.3.x


Operating system

Redmine should run on most Unix, Linux, macOS and Windows systems as long as Ruby is available on this platform. See specific installation HowTos here.

Ruby interpreter

The required Ruby versions for a given Redmine version are:

Redmine version Supported Ruby versions Rails version used
trunk (>= r21329) Ruby 2.51, 2.6, 2.7, 3.0, 3.1 Rails 6.1
4.2 Ruby 2.41, 2.51, 2.6, 2.72 Rails 5.2
4.1 Ruby 2.31, 2.41, 2.51, 2.6 Rails 5.2

Supported database back-ends

MySQL 5.5 - 5.7

MySQL 5.6 or higher and MariaDB have known issues (#19344, #19395, #17460).

PostgreSQL 9.2 or higher

Make sure your database datestyle is set to ISO (Postgresql default setting). You can set it using: ALTER DATABASE "redmine_db" SET datestyle="ISO,MDY";

Microsoft SQL Server 2012 or higher

Redmine 4.0.0 to 4.0.6 and 4.1.0 don't support SQL Server (#30285, #32737).

SQLite 3 (not for multi-user production use!)

Optional components

  • SCM binaries (eg. svn), for repository browsing (must be available in your PATH). See RedmineRepositories for SCM compatibility and requirements.
  • ImageMagick (to enable Gantt export to PNG image and thumbnails generation).
  • Ghostscript (to enable thumbnails generation for PDF attachments in Redmine 4.1 or later).
"Get the right people. Then no matter what all else you might do wrong after that, the people will save you. That's what management is all about." ~ Tom DeMarco

Procedure Of Redmine Installation

Step 1 - Redmine application

Download a released package and extract it to an appropriate destination on your system. As an alternative one can checkout the files directly from the version control system.

Please visit the download page for further information on how to download Redmine.

Step 2 - Create an empty database and accompanying user

Redmine database user will be named redmine hereafter but it can be changed to anything else.


CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';


For versions of MySQL 5.5.2 or lower - use utf8 instead of utf8mb4

CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';


For versions of MySQL 5.0.2 or lower - skip the 'CREATE USER' step and instead:

GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'my_password';





Skip this step. A database file will be created during Step 6.

SQL Server

The database, login and user can be created within SQL Server Management Studio with a few clicks.

Step 3 - Database connection configuration

Copy config/database.yml.example to config/database.yml and edit this file in order to configure your database settings for "production" environment.

Example for a MySQL database (default port):

  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: "my_password" 

Example for a PostgreSQL database (default port):

  adapter: postgresql
  database: <your_database_name>
  host: <postgres_host>
  username: <postgres_user>
  password: "<postgres_user_password>" 
  encoding: utf8
  schema_search_path: <database_schema> (default - public)

Example for a SQLite database:

  adapter: sqlite3
  database: db/redmine.sqlite3

Example for a SQL Server database (default host localhost , default port 1433 ):

  adapter: sqlserver
  database: redmine
  username: redmine # should match the database user name
  password: "redminepassword" # should match the login password

Step 4 - Dependencies installation

Redmine uses Bundler to manage gems dependencies.

You need to install Bundler first if you use Ruby 2.5 or earlier:

gem install bundler

Then you can install all the gems required by Redmine using the following command:

bundle install --without development test

Optional dependencies


RMagick is an interface between the Ruby programming language and the ImageMagick image processing library. The library is necessary for Redmine prior to 4.1.0 to export gantt charts to PNG or PDF.

If ImageMagick (6.4.9 - 6.9.10) is not installed on your system and you are installing Redmine 4.0 or earlier, you should skip the installation of the rmagick gem using:

bundle install --without development test rmagick

Step 5 - Session store secret generation

This step generates a random key used by Rails to encode cookies storing session data thus preventing their tampering. Generating a new secret token inv

Generating a new secret token invalidates all existing sessions after restart.

bundle exec rake generate_secret_token

Step 6 - Database schema objects creation

Create the database structure, by running the following command under the application root directory:

RAILS_ENV=production bundle exec rake db:migrate

Windows syntax:

set RAILS_ENV=production bundle exec rake db:migrate

Step 7 - Database default data set

Insert default configuration data in database, by running the following command:

RAILS_ENV=production bundle exec rake redmine:load_default_data

Redmine will prompt you for the data set language that should be loaded; you can also define the REDMINE_LANG environment variable before running the command to a value which will be automatically and silently picked up by the task.



RAILS_ENV=production REDMINE_LANG=fr bundle exec rake redmine:load_default_data


set RAILS_ENV=production set REDMINE_LANG=fr bundle exec rake redmine:load_default_data

Step 8 - File system permissions

NB: Windows users can skip this section.

The user account running the application must have write permission on the following subdirectories:

  1. files(storage of attachments)
  2. log(application log file production.log)
  3. tmp and tmp/pdf (create these ones if not present, used to generate PDF documents among other things)
  4. public/plugin_assets (assets of plugins)

E.g., assuming you run the application with a redmine user account:

mkdir -p tmp tmp/pdf public/plugin_assets sudo chown -R redmine:redmine files log tmp public/plugin_assets sudo chmod -R 755 files log tmp public/plugin_assets

Note: If you have files in these directories (e.g. restore files from backup), make sure these files are not executable.

sudo find files log tmp public/plugin_assets -type f -exec chmod -x {} +

Step 9 - Test the installation

Test the installation by running WEBrick web server:

bundle exec rails server webrick -e production

Once WEBrick has started, point your browser to http://localhost:3000/. You should now see the application welcome page.

Note: Webrick is not suitable for production use, please only use webrick for testing that the installation up to this point is functional. Use one of the many other guides in this wiki to setup redmine to use either Passenger (aka mod_rails ), FCGI or a Rack server (Unicorn, Thin, Puma, hellip;) to serve up your redmine.

Step 10 - Logging into the application

Use default administrator account to log in:

  • login: admin
  • password: admin

You can go to Administration menu and choose Settings to modify most of the application settings.


Redmine settings are defined in a file named config/configuration.yml .

If you need to override default application settings, simply copy config/configuration.yml.example to config/configuration.yml and edit the new file; the file is well commented by itself, so you should have a look at it.

These settings may be defined per Rails environment ( production / development / test ).

Important : don't forget to restart the application after any change.

Email configuration is described in a dedicated page.

SCM settings

This configuration section allows you to:

  • override default commands names if the SCM binaries present in the PATH variable doesn't use the standard name (Windows .bat/.cmd names won't work)
  • specify the full path to the binary

Examples (with Subversion):

Command name override:

scm_subversion_command: "svn_replacement.exe"

Absolute path:

scm_subversion_command: "svn_replacement.exe"

Attachment storage settings

You can set a path where Redmine attachments will be stored which is different from the default 'files' directory of your Redmine instance using the attachments_storage_path setting.


attachments_storage_path: /var/redmine/files
attachments_storage_path: D:/redmine/files


Redmine backups should include:

  • data (stored in your redmine database)
  • attachments (stored in the files directory of your Redmine install)

Please refer to Backing up and restoring Redmine for more details.

Notes on Linux/Unix installation

Be sure to disable security hardenning tools during the installation process if you run into bizarre permission problems. These problems are mostly silent and can be caused by tools like extended ACLs, SELinux, or AppArmor. There tools are mostly used in big companies with a strict security policy, default Linux/Unix distributions settings shouldn't be a problem.

Notes on Windows installation

There is an prebuilt installer of Ruby MRI available from
After installing it, select Start Command Prompt with Ruby in the start menu.

Specifying the RAILS_ENV environment variable:

When running command as described in this guide, you have to set the RAILS_ENV environment variable using a separate command.

I.e. commands with the following syntaxes:

RAILS_ENV=production <any commmand><any commmand> RAILS_ENV=production

have to be turned into 2 subsequent commands:

set RAILS_ENV=production <any commmand>

MySQL gem installation issue:

You may need to manually install the mysql gem using the following command:

gem install mysql

And in some case it is required to copy the libmysql.dll file in your ruby/bin directory.

Not all libmysql.dll are ok this seem to works.

Replace localhost with in database.yml.

Step By Step Guide Of How To Use Redmine By AssistNix

This AssistNix tutorial explains how to install and use the Redmine project management tool.

1. Register

To use the application, you must first register. The user must fill out all mandatory fields highlighted with a red asterisk in order to complete the registration process.

The program can only be accessed when a user has registered with Redmine. To sign up for the Redmine app, go to the registration page and click the Register button in the upper right corner.

2. Login

A login page will show when you first launch Redmine. You can then enter your login ID and password and be logged in. In the event that you forget or lose your password, you can create a new one by clicking the "Lost Password" link. It takes the user to the Lost Password page, where they can enter a valid email address and create a new password.

3. Create An Issue

The user must first login before creating a new problem. Users must navigate to the 'New Issue' tab in the header to create a new issue. Users can also choose from a variety of Trackers, such as Defect, Feature, and Patch. You'll need to fill in information like the tracker, subject, description, status, and files to create an issue.

4.Project Management Using Redmine

Redmine is one of the most effective project management solutions. In Redmine, users can create any issue, such as a bug, feature, or task, and assign it to the appropriate member by specifying a start and end date. The "Activity" page can be used to track all of the activities conducted on the projector for the subtask.

5. Creating Space For Project

To make room for new projects, go to the Project tab and select New Project. Only the site administrators and the Project Manager have access to establish new project space by default. A name and a unique identifier must be provided when creating a project; the identifier is used as part of the project space's URL.

Important Concept Of Redmine

Following are the important concepts of the Redmine;

• Project Overview

On the left-hand side, the "Issue Tracking" section displays the current status of all open and closed issues. The "Members" block on the right-hand side lists all of the project's participants. The "Latest News" block contains all of the project's most recent updates. The Activity Report, on the other hand, contains all of the audit logs or historical information relating to the Project or the issues that were searched.

• Issue Tracking

There are two ways to keep track of issues. One method is to go over a list of issues. Users can examine the list of issues from here and select a specific issue to learn more about it. The second method is to use an 'Issue summary.' The Issue Summary report comprises all of the issues linked to the project in all of its versions.

• Time Tracking

It displays the overall time spent on the project in detail. When the project's "Time Tracking" module is turned on, the time log feature becomes available. Users can view Time log Details in CSV format if that is what they want. The Time log Report can be seen by going to Overview => Spent time => Report.

• Tracking Progress

You'll need to look at the Gantt Chart to keep track of the process. It's used to keep track of the project's progress, such as the start date, due dates, status, and resolution. It's a plugin that may be installed by the user. You may easily and quickly track the progress of your project from here.

• Calendar

Each project's calendar module can be enabled or disabled from the Project configuration tab. The calendar view, like other calendar shows, displays project-related data on a monthly basis. It will display all of the issues, at the very least the start and due dates.

• Repository

The user can see the Repository tab in the header, and clicking it takes them to the project repository, where they can see the most recent commits. By clicking the "+" icon, users can expand the directory. If the user clicks on the Revision number, the details of the commit will be displayed.

FAQs For Redmine Applications

1.What kind of services does Assistnix provide?

At AssistNix, we offer a wide range of services, including Redmine application consultation, installation, configuration, application hosting, and application user guides. All of these services are available from our experienced staff at very cheap costs. We have a competent and experienced consultation team that provides outstanding application consulting services for open source software such as Redmine. If you're having problems with self-hosted servers, we'll take care of them as well. In addition, we offer excellent application hosting services and build application user guides. AssistNix is a top-notch company that offers top-notch Redmine and other open-source software support.

2.Are there AssistNix demos or trial versions available?

Trial versions are vital because they allow you to determine whether or not our tactics will work for you. Trial versions of AssistNix are available on our website. It is simple to gain access to. This sample version was intended to ensure that you have a good understanding of how our services work before committing to the entire project. You can use these demos and trial versions to learn more about how we work and what tactics we employ. As a result, you will have a better understanding of our services and how our team operates. It will also be easy for you to decide whether or not to continue working with us.

3.How can I receive Assistance support?

We provide professional support to our customers at AssistNix. Please communicate all of your questions and concerns to us via email. Our team will get back to you as soon as possible. Our team of highly trained specialists will provide you with unwavering support and assistance. Feel free to engage with other users in our forums if you're using the community edition. You can get in touch with us in a variety of ways and obtain prompt responses. Our team will answer quickly regardless of how you reach us. And you'll be able to resolve all of your problems, as well as all of your doubts and concerns.

FAQ's Regarding Installing and Running Redmine

4.Does Redmine work with Rails 2.x.x?

Yes, it is compatible with Rails 2.x.x. At AssistNix, we will make every effort to answer any of your questions. Contact our team, and they will walk you through the Redmine compatibility process. They will also install the software on the server you specify, ensuring that it is installed correctly and functions properly. If you want to check its compatibility with other servers, go to Redmine's compatibility page, which lists all of the servers with which Redmine is compatible. Alternatively, you can contact our experts, who will provide you with extensive and professional guidance.

5.The application froze after a long time of inactivity.

If the application froze after a long period of inactivity, it's conceivable that the application has a bug. The ruby/MySQL adapter 2.7.3 may have a flaw that causes the database connection to be lost. Please make sure your adaptor is up to date. Alternatively, you can contact AssistNix's expert team of technicians, who can help you with any issue you're having with the application or server. They will ensure that the root cause of the problem is identified and that the application is fully functional for you. You may count on our staff to provide a quick and effective solution to any open source software-related problem.

6.I Can't browse my svn repository through redmine

f you're having trouble browsing your svn repository using Redmine, try the following:

Make sure you're using an svn client and server that are both at least version 1.3. Redmine parses subversion's -xml output, which is an svn 1.3 feature.

Check to see if the web app can run the svn binary. (Hint: double-check your path to make sure the svn binary is there.) If you're utilizing a file:/ link, be sure the system user who runs Redmine has access to the file:/ location on your local file system.(Hint: Redmine runs as the user who owns your config/environment.rb by default when using a passenger.) If it doesn't work, contact our staff and we'll take care of it for you.

7.Email notifications are not working

If your email notifications aren't working, try the methods listed below. We have years of expertise working with open source software at AssistNix. We are confident that this procedure will be beneficial.

To begin, try sending a test email by going to "Administration -> Settings -> Email notifications" and selecting "Send a test email."

It will send the following email to the address associated with your Redmine account: Check your configuration if you get an error. Check your SMTP server log to see if the email was correctly forwarded if you don't receive any email. Every email sent will be dumped into your log file after restarting the application. This allows you to check the To field of emails to ensure that all of the intended email addresses are included.

8.I get a 404-error when I try to view or diff a PHP-file

When you try to browse or diff a PHP file and get a 404 error, it's because Apache recognizes the extension.php and attempts to run the PHP interpreter on the file. A 404 error is returned because the requested URL is not a valid file. AssistNix can assist you with it because the solution is straightforward, or you can try to solve it yourself by following these simple steps. For your Redmine virtual host, you must disable mod PHP. As a result, Apache will call Redmine to serve the file. Add the following lines to your virtual host configuration to accomplish this:

PHP flag engine off RemoveHandler.php) (First, try without this line.)

9.Reset password lost without admin Redmine account but with admin Redmine database account

In the file /app/models/user.rb, the following was discovered: 'The hashed password is saved in the format SHA1(salt + SHA1)'.

As a result, you can change your password in two steps:

- remove salt from the equation - calculate sha1(sha1(new password)).

To reset a password, go to the Redmine database, find the "users" table, identify the user you want to reset the password for, clear the "salt" field's user, and put "password" in the "hashed password" field's user, then log in with the new password 'password'. To make these modifications to the Redmine database, use the following commands from the command line on the operating system where Redmine is installed:

Note the user and password in the config/database.yml file. Change the password as well. If you haven't received a change, please contact AssistNix, and we'll make sure it's reset for you

SuiteCRM - AssistNix