HowTo Install Redmine in a sub-URI » History » Version 3
HowTo Install Redmine in a sub-URI¶
This page explains how to run Redmine in a subdirectory of your site, for instance
Using Rails features (prefered solution)¶
Add the following line at the end of your config/environment.rb :
ActionController::AbstractRequest.relative_url_root = "/redmine"Rails will then prefix all links with "/redmine". It can be considered as the simplest, cleanest and most flexible solution. Then restart your application.
Using Mongrel features¶
If you run Redmine under Mongrel server, you can alternatively use the "--prefix" option of Mongrel :
mongrel_rails start --prefix=/redmineYou may not run Mongrel on port 80 : if you have an Apache server on the same host, and you run Mongrel on port 8000, you can use the following Apache config to redirect (with Apache's mod_proxy enabled) :
ProxyPass /redmine http://localhost:8000/redmine ProxyPassReverse /redmine http://localhost:8000/redmine
Using Passenger (aka mod_rails) features¶
If you run Redmine under Apache web server with Phusion Passenger module, you can follow this guide ; please note it won't work correctly on some versions of Passenger or some Linux distributions.
With a reverse proxy¶
If you have an Apache webserver in front of it (with mod_proxy enabled), or an Apache reverse proxy on another machine, you can run Redmine on a specific port and use this kind of config so it appears to be running in a subdirectory :
ProxyPass /redmine http://real-redmine-server.localdomain:3000/ ProxyPassReverse /redmine http://real-redmine-server.localdomain:3000/See Apache official documentation to adapt it.
Old versions of Redmine and Rails¶
If you run a very old version of Redmine (don't know exactly which ones), maybe your version of Rails' ActionController does not support the "relative_url_root" mentionned above. Then you can look at this page to reproduce the same behaviour, but it is NOT a very good idea in most cases, you should consider upgrading Redmine.