Manager ManagerURL Prefix (sub-uri) server configuration

Author: Manager Manager Displayed: 3781
Created: 27/02/2019 Updated: 27/02/2019
Version: 1


In most cases, Easy Redmine is run on a subdomain (e.g. This is the most stable way.

However, due to internal policies, some companies run it on a sub-uri (e.g. If this is your case, you need to be extra careful about the server configuration. Here are our tips for correct functioning.

Using incorrect configuration may result in problems with some functions. Most notably: Exports, Javascript components like Gantt or WBS, modal windows and others.

This guidline is based on original Redmine (

The sample configuration is for application

Setup puma

For puma you need to edit 2 files - and config/environment.rb -> add map for "/redmine" around current run application
map  '/redmine' do
  run RedmineApp::Application
config/environment.rb -> append this line to end of file
Redmine::Utils::relative_url_root = "/redmine"


Update root, add location for "/redmine" and create aliases. Example:

upstream {
  server                      unix:///home/easyproject/;

server {

  listen                      443 ssl http2;
  server_name       ;
#  root                        /home/easyproject/;
  root                        /home/easyproject/;

  access_log                  /var/log/nginx/;
  error_log                   /var/log/nginx/;

location /redmine {
#    root                        /home/easyproject/;
    alias                        /home/easyproject/;
    proxy_pass      ;
    include default.d/upstream.conf;

  location /cable {
    proxy_pass      ;
    include default.d/websocket.conf;

location ~ ^/redmine/(images|system|assets|plugin_assets)/ {
    alias                        /home/easyproject/;
    proxy_pass      ;

    gzip_static               on;
    expires                   3M;
    add_header                Cache-Control public;
    add_header                ETag '';

  ssl_certificate             /etc/nginx/ssl/easyredmine_com.crt;
  ssl_certificate_key         /etc/nginx/ssl/easyredmine_com.key;



    <Directory /path/to/redmine/>                
            RailsBaseURI /redmine
            PassengerResolveSymlinksInDocumentRoot on
            Options Indexes FollowSymLinks MultiViews
            AllowOverride None
            Order allow,deny
            allow from all

Don't forget!

In the application settings, enter the full URL.

Administration >> Settings >> General - Host name and path


Add picture from clipboard