Since both Redmine and Easy Redmine are Open Source and more-less platform independent, some installation & upgrade problems may occur due to various server configurations, software versions or plugins installed. We work hard to track those most common in order to help you with troubleshooting.

I run into 500 error (internal error). What should I do?

Here are some hints what you can do if you run into 500 error.

  • back-up your database
  • download the latest package from the Client Zone
  • make sure that webserver has Full access public, files, log, tmp folders
  • run bundle install --without development test
  • run bundle exec rake easyproject:install RAILS_ENV=production
  • delete any 3rd parties' Redmine plugins (also from database)
  • write us on This email address is being protected from spambots. You need JavaScript enabled to view it. and attach log/production.log

Internal error containing "Permission denied"

You have installed or updated Easy Redmine under user with insufficient permissions, not following our strong recommendation in the instructions (at least once in the past).

  1. Correct permissions by commands chgrp and chown according to server settings (eg. chgrp -R www-data public_html)
  2. Run installation again bundle exec rake easyproject:install RAILS_ENV=production which will clear cache (if you run it by root, it will not be succesful)
  3. Restart server

If you are using virtual machine provided by Easy Software, run under user easy:

sudo chown -R easy /srv/easyredmine/public_html

sudo chgrp -R easy /srv/easyredmine/public_html

cd /srv/easyredmine/public_html

bundle exec rake easyproject:install RAILS_ENV=production

sudo service unicorn restart

Remember to set the permissions for all necessary folders.

My Easy Redmine shows 502 Bad Gateway

There are many possible causes of this error. Here are a few tips:

  • browser cache problem - try deleting cache from the browser
  • dns problem
  • server setting problem

First check your connection and network (verify that server is reachable by using a ping command or traceroute command). Firewall server side.

If all above seems fine, try to get some information from nginx error.logs. Check nginx error.log at the server side - /var/log/nginx/error.log

Double check that your nginx configuration matches the standard. Standard nginx configuration can be found here:

Example of an nginx configuration (as is used by Easy Software). It's quite similar to official one only few variables are optimized:

user www-data;
worker_processes  8;

worker_rlimit_nofile 60000;

error_log  /var/log/nginx/error.log;
pid        /var/run/;

events {
    worker_connections  10240;
    # multi_accept on;

http {
    ssl_protocols  TLSv1 TLSv1.1 TLSv1.2;  # dont use SSLv3 ref: POODLE
    include       /etc/nginx/mime.types;
                default_type  application/octet-stream;
                server_names_hash_bucket_size 2048;

    access_log  /var/log/nginx/access.log;

    sendfile        on;
    #tcp_nopush     on;

    #keepalive_timeout  0;
    keepalive_timeout  65;
    tcp_nodelay        on;

    send_timeout 1800;
    client_body_timeout  1800;
    client_header_timeout 1800;
    proxy_read_timeout 1800;
    client_max_body_size 220m;
    fastcgi_buffer_size 64K;
    fastcgi_buffers 128 16k;
    proxy_max_temp_file_size 0;
    types_hash_max_size 4096;
    types_hash_bucket_size 128;

    proxy_busy_buffers_size   256k;
    proxy_buffers 8 256k;
    proxy_buffer_size 256k;

    gzip  on;
    gzip_disable "MSIE [1-6]\.(?!.*SV1)";

    include /etc/nginx/conf.d/*.conf;
    include /etc/nginx/sites-enabled/*;
    include /etc/nginx/sites-auto/*;


Other possible causes of 502 error include...

Unicorn is not running at all, due to

  • Insufficient permissions
  • Wrong version of passenger
  • Wrong Ruby version
  • Missing gems
  • Broken filesystem

To find out the exact problem, you need to check error logs in unicorn or apache + application log from Easy Redmine (log/production.log)


If low timeout is configured, this error will appear on:

  • large exports
  • overload of server
  • rake tasks run from the GUI

Limit of MySQL connections

Make sure you have a sufficient number of connections allowed to MySQL. It depends on the number of users, but you should have at least a 100 allowed.

After upgrading to version 2016, icons are missing throughout the system

This problems occurs when you use a suffix on your Easy Redmine URL, for example:

In this case, you need to make sure that you have the variable RAILS_RELATIVE_URL_ROOT configured to your correct suffix /easyredmine



  1. Create an additional configuration file config/additional_environment.rb
  2. config.action_controller.relative_url_root = "/easyredmine"
  3. then precompile assets (rake easyproject:install RAILS_ENV=production) and restart the server

Printing templates do not work

Make sure wkhtmltopdf is installed and running ( wkhtmltopdf needs X server or other emulation)
Test it using: "wkhtmltopdf google.pdf"

Application uses SSL, but some content uses insecure URLs

Add to your proxy configuration:

proxy_set_header X-Forwarded-Proto https

Easy Gantt PRO installation on Bitnami

If the installation fails, run manually:

$ bundle update
$ rake db:migrate
$ rake redmine:plugins:migrate

Error RequestURITooLarge

Make sure your webserver supports actual size of URL address

Make sure you are NOT using Webrick webserver!

Easy Redmine runs very slow. What to do?

There are no attachments after upgrade?

Copy files folder from your old Redmine.

You can change the default files location in the Redmine's configuration file or you can use a symlink. LAN or cloud based network storages for attachments are not recommended because of reliability issues.


  # Absolute path to the directory where attachments are stored.
  # The default is the 'files' directory in your Redmine instance.
  # Your EasyRedmine instance needs to have read/write permission on this directory.
  # Examples: attachments_storage_path: /var/www/redmine/files


If you can't open an attachment, see ./log/production.log for common errors:

Cannot send attachment, /var/www/redmine/files/2015/08/150805095407_xxx.PNG does not exist or is unreadable

ENOENT, Permission Denied... etc.

What actually is Easy Redmine?

Easy Redmine is an Open Source software for complex project management with extensions for resources, finance and customer management. In the cloud or on your own server, all comes with professional implementation and support.

CIOreview Stamp Easy Redmine Top 20 Open Source Provider
iOS ANdroid compatible Easy Redmine
IPMA PMI standarts compatible Easy Redmine 01

*SHINE Consulting Ltd.- holder of accreditation of the Project Management
Training Program “Project Management in Practice” (International Standard IPMA)
and is also a member of the PMI R.E.P. Registered Education Provider.
**The PMI Registered Education Provider logo is
a registered mark of the Project Management Institute, Inc.


500x290xUpdate Map



Easy Redmine Drives More Than 1400 Organisations Worldwide

Explore More...


What users say about Easy Redmine on Capterra?

  • All in one application - that is Easy Redmine

    Aug 25, 2015

    RTL Radio use Easy Redmine to maintain help desk, resources, attendance and of course all IT and software projects. We like the complexity - using all-in-one solution is just wonderful.

    Timo Muller
    Chief Information Officer , RTL Radio Deutschland GmbH
    Ease of Use
    Customer Support
  • AllInOneSolution for project management

    Apr 5, 2016

    Easy Redmine is a great software that helps us manage project costs, better define our work and is packed with many features that were missing in Redmine. All this embedded in a user-friendly interface.

    Nelson Rodrigues
    Belo Solutions
    Ease of Use
    Customer Support
  • Better control over cost and staffing resources

    Mar 24, 2016

    We adopted Easy Redmine six months ago in order to control all of our web projects. We are very happy as we now have a strong visibility in terms of control of costs and staffing resources and we also have a powerful tool for interaction with our customers.

    Cyril Lécot
    Operations Manager , Netquarks
    Ease of Use
    Customer Support
  • Easy and robust project management

    Apr 21, 2016

    EasyRedmine is a real step-forward compared to Redmine! More functionalities thanks to many plugins. Better user interface. Very reactive and professional customer service.

    IT Department
    Monaco Paradigm
    Ease of Use
    Customer Support
  • Help desk solutions

    Jun 29, 2016

    Professional solution with a lot of features. It help us to manage our customers in more efficient way. Highly recommended especially if you are IT company.

    Felicien Bikang
    Ease of Use
    Customer Support
  • Lot of useful extra plugins

    Jun 11, 2016

    Akquinet is using Redmine for years. We love all the extra plugins and support that Easy Redmine delivers to let us focus on our job.

    Konrad Mattheis
    Head of Consulting , Akquinet
    Ease of Use
    Customer Support
  • Powerful Project Management Tool

    Apr 27, 2016

    Simple Interface and easy to use. Flexible and fit your own need.

    Helen Tang
    Ease of Use
    Customer Support
  • Very good software for planning and reporting IT projects

    Apr 6, 2016

    We use Easy Redmine every day to plan projects and all staff reports the time they work using the brilliant timer feature. 

    Mattias Eriksson
    Team manager , People and Solutions AB
    Ease of Use
    Customer Support
  • Very useful product!

    Apr 6, 2016

    Our working environment is all based on easy redmine product- tasks, milestones, all managed in one platform which helps us to planing, view progress and more! 

    Alon Almog
    IT , Gita Technologies
    Ease of Use
    Customer Support

Capterra is Independent platform.

Test for Freein 14 day trial Free & Full Featured Trial SSL Certified Daily Backups

we will call you to help with settings

no credit card or installation needed