27/07/2015

InstallingRedmineonWindowsinproduction|HeliconTechBlog

Installing Redmine on Windows in production

This is a very simple step by step guide to install Redmine on Windows server in production. This guide is applicable to IIS 7+ based servers, which
include Windows Server 2008, 2008 R2, Windows 2012, Windows Vista and Windows 7. Latter two are not intended to be used for production
solutions. Please follow these steps:

1. Download Microsoft Web Platform Installer

(http://www.microsoft.com/web/downloads/platform.aspx), and install it.
2. Run Web Platform Installer and click Options.

3. Add Helicon Zoo feed into Custom feeds field: http://www.helicontech.com/zoo/feed.xml

(http://www.helicontech.com/zoo/feed.xml) Select IIS as a target web server for production or IIS
Express for testing.

A new tab named Zoo should appear on the main page of Platform Installer.

4. Go to Zoo Applications and add Redmine, then click install.

http://www.helicontech.com/articles/installingredmineonwindowsinproduction/

1/9

27/07/2015

InstallingRedmineonWindowsinproduction|HeliconTechBlog

This will automatically download and install all required components, including Ruby, Rails, Helicon Zoo Module and Redmine itself.

5. Setup new web-site dialog will appear. Fill it with your server specific values.

6. Go to the /admin/ folder on this web-site. Use login admin and password admin to enter
Redmine Administration panel.

http://www.helicontech.com/articles/installingredmineonwindowsinproduction/

2/9

27/07/2015

InstallingRedmineonWindowsinproduction|HeliconTechBlog

When you install Redmine into a sub-directory additional configuration is required. Please open config/environment.rb file and add the following
line at the bottom:
Redmine::Utils::relative_url_root=ENV['APPL_VIRTUAL_PATH']

See http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_in_a_sub-URI
(http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_in_a_sub-URI) for more information.

Custom database
Redmine supports multiple database engines. By default SQLite is installed, however there are example configuration files for MySQL and
PostgreSQL within config folder of Redmine application. If you wish to use MySQL, for an instance, take database.yml.mysql file; name it as
database.yml and alter according to your MySQL database settings. If you have already run deployment script, then you need it run it again after
database change. Rename deploy_done.rb file in the root web site folder to deploy.rb and request some page. Deployment process will be initiated
and database migration tasks will be executed.
Sometimes you may need to manually execute tasks against Ruby application. Use Helicon Zoo web console for this purpose. To start web console
go to Windows Start > Programs > Helicon > Zoo > Helicon Zoo Manager select your web site and click Start Web Console button. Then use
this console to run for example rake db:migrate command and see its output in real time.

Manual installation
http://www.helicontech.com/articles/installingredmineonwindowsinproduction/

3/9

27/07/2015

InstallingRedmineonWindowsinproduction|HeliconTechBlog

If you need to install some specific or modified version of Redmine here you can find manual installation instructions that you can adapt for your
needs.
First you will need to run Web Platform Installer, go to Zoo > Templates and install Ruby Project as you normally install application on either IIS
or IIS Express.

This will install generic Ruby project running with Zoo and all requirements, including Ruby, DevKit, Zoo Module, etc. After the web site is created you
should see Ruby projects welcome page:

Download Radmine package as a ZIP file here: http://rubyforge.org/frs/?group_id=1850 (http://rubyforge.org/frs/?group_id=1850) Unzip content of
redmine-x.x.x folder from the Zip file (where config.ru file is located) directly into the web sites (or applications) root, i.e. config.ru file will be in
the same folder with web.config file.
Now we need to set up database for use with Redmine. You can follow recommendations to create database on this official page:
http://www.redmine.org/projects/redmine/wiki/RedmineInstall (http://www.redmine.org/projects/redmine/wiki/RedmineInstall)
The simplest way is to use SQLite as a database because it does not require any database installation. To use it you just need to create a
config\database.yml file in the Redmine installation with the following content:

config\database.yml:

http://www.helicontech.com/articles/installingredmineonwindowsinproduction/

4/9

27/07/2015

InstallingRedmineonWindowsinproduction|HeliconTechBlog

#SQLiteversion3.x
development:
adapter:<%="jdbc"ifdefined?(JRUBY_PLATFORM)%>sqlite3
database:db/development.sqlite3
timeout:5000
#Warning:Thedatabasedefinedas'test'willbeerasedand
#regeneratedfromyourdevelopmentdatabasewhenyourun'rake'.
#Donotsetthisdbtothesameasdevelopmentorproduction.
test:
adapter:<%="jdbc"ifdefined?(JRUBY_PLATFORM)%>sqlite3
database:db/test.sqlite3
timeout:5000
#Warning:Thedatabasedefinedas'cucumber'willbeerasedand
#regeneratedfromyourdevelopmentdatabasewhenyourun'rake'.
#Donotsetthisdbtothesameasdevelopmentorproduction.
cucumber:
adapter:<%="jdbc"ifdefined?(JRUBY_PLATFORM)%>sqlite3
database:db/cucumber.sqlite3
timeout:5000
production:
adapter:<%="jdbc"ifdefined?(JRUBY_PLATFORM)%>sqlite3
database:db/production.sqlite3
timeout:5000

Then open Gemfile, find a line with RMagick dependency and comment it out. This is needed because current versions of RMagic does not compile
on Windows platform. This gem is optional.
#OptionalgemforexportingthegantttoaPNGfile,notsupportedwithjruby
platforms:mri,:mingwdo
group:rmagickdo
#RMagick2supportsruby1.9
#RMagick1wouldbefineforruby1.8butBundlerdoesnotsupport
#differentrequirementsforthesamegemondifferentplatforms
#gem"rmagick",">=2.0.0"
end
end

Because first Redmine start may take longer than default 30-second request timeout, open web.config file and add WORKER_REQUEST_TIMEOUT
environment variable as shown below:
<heliconZoo>
<clear/>
<applicationname="ruby.project">
<environmentVariables>
<addname="RAILS_RELATIVE_URL_ROOT"value="%APPL_VIRTUAL_PATH%"/>

<!UsethisAPP_WORKERwithHTTPRubyengineandThin.Thinneedtobeinstalled.>
<!
<addname="APP_WORKER"value="GEM_HOME\bin\thinstart"/>
>
<!
<addname="APP_WORKER"value="%APPL_PHYSICAL_SHORT_PATH%\app.rb"/>
>
<!
Deployfileincludesthemostcommoncommandsrequiredtoprepareapplicationbeforelaunch(bundleinstall,migrationsetc.)
Itisalsopossibletospecifyhereanyscriptwhichevenuallywillberunbyrubyw.exe.
>
<addname="DEPLOY_FILE"value="deploy.rb"/>

<!BydefaultwerunRailsinproductionmode>
<addname="RACK_ENV"value="production"/>

<!Webconsolelocation>
<!securityrulesforconsoleareplacedin/console/web.config>
<addname="CONSOLE_URL"value="console"/>
<addname="WORKER_REQUEST_TIMEOUT"value="200"/>
</environmentVariables>
</application>
</heliconZoo>

Or you can use Windows Start > Programs > Helicon > Zoo > Helicon Zoo Manager application to edit environment variables instead of
editing web.config manually:

http://www.helicontech.com/articles/installingredmineonwindowsinproduction/

5/9

27/07/2015

InstallingRedmineonWindowsinproduction|HeliconTechBlog

Rename deploy_sample.rb file from Zoo Ruby project template to deploy.rb:

And request any page on a site this will initiate deployment process.

http://www.helicontech.com/articles/installingredmineonwindowsinproduction/

6/9

27/07/2015

InstallingRedmineonWindowsinproduction|HeliconTechBlog

After deployment is completed you should see Redmines home page. Then proceed with Admin section as form previous chapter.

Offline installation
Sometimes you may need to install Redmine on a machine that is not connected directly to the Internet. Here is the instruction how to prepare
offline installation package that you can use to install as many copies of Redmine as you need.
First you will need another machine that is connected to the Internet to prepare Redmine on it. Please follow instructions above and install Redmine
using Helicon Zoo. Make sure everything works as you need and all modules and components are installed into web sites GEM_HOME folder.
Helicon Zoo applications are self-contained this means you can simply move application from one machine to another just by copying web site
folder as long as required Zoo Hosting Package (in our case Ruby Hosting Package) is installed on this machine. So we will need to prepare offline
package to install Ruby Hosting Package. Fortunately Web Platform Installer provides a command line tool to do this.
On the Internet-enabled machine open command line interface (this could be simple command line or PowerShell) and navigate to Web Platform
Installer folder; this is usually C:\Program Files\Microsoft\Web Platform Installer. Then run the following command:
WebpiCmd.exe/offline/Products:RubyHostingPackage/Path:C:\rubyoffline/Feeds:http://www.helicontech.com/zoo/feed.xml

With the /offline key WebpiCmd.exe will download all possible dependencies for the selected product and save downloaded files plus special feed
section required for offline installation in the c:\ruby-offline folder. After generation is completed simply copy resulting folder to the Internetrestricted machine. You dont even need to install Web Platform Installer on this machine because generated folder already contain WebpiCmd.exe
file in bin location.
So open command line on Internet-restricted machine and run this command:
WebpiCmd.exe/install/Products:RubyHostingPackage/XML:C:\rubyoffline\feeds\latest\webproductlist.xml/Feeds:C:\rubyoffline\feeds\latest\su
pplementalfeeds\zooproducts4.xml

This will install Ruby Hosting Package and all possible requirements to run Ruby applications on this server. After installation is completed simply
create an empty IIS web site and copy content of Zoo Redmine web site from the Internet-enabled machine and run the site. Please dont try to
make offline copies of Redmine application directly from feed because these packages require Interned access to run gem install commands and
other deployment tasks. So you will need to copy working and completely tuned Redmine web site instead of trying to install fresh Redmine on
Internet-restricted machine.
Posted on January 3, 2012 (http://www.helicontech.com/articles/installing-redmine-on-windows-in-production/) by Slov
(http://www.helicontech.com/articles/author/slov/)
This entry was posted in Helicon Zoo (http://www.helicontech.com/articles/category/helicon-zoo/) and tagged ruby
(http://www.helicontech.com/articles/tag/ruby/) zoo (http://www.helicontech.com/articles/tag/zoo/). Bookmark the permalink
(http://www.helicontech.com/articles/installing-redmine-on-windows-in-production/).

http://www.helicontech.com/articles/installingredmineonwindowsinproduction/

7/9

27/07/2015

InstallingRedmineonWindowsinproduction|HeliconTechBlog

Node.js on Windows (with performance tests) (http://www.helicontech.com/articles/node-js-on-windows-with-performance-tests/)

Installing OSQA on Windows in production (http://www.helicontech.com/articles/installing-osqa-on-windows-in-production/)

6 Responses to Installing Redmine on Windows in production

1. Charles says:
January 17, 2012 at 9:57 pm (http://www.helicontech.com/articles/installing-redmine-on-windows-in-production/#comment-34549)
Thank you! This totally simplified it.
I did have to add the Files folder though (for the attachments). Also I wonder if there was a different way to setup/configure email
notifications for Windows installations. It is always telling me to configure and restart the app.
Slov says:
January 24, 2012 at 12:25 pm (http://www.helicontech.com/articles/installing-redmine-on-windows-in-production/#comment-34553)
Thank you for feedback!
I guess youll have more chances to get answer to the email notifications question on Redmine support forum.
2. Mohsen Heydari says:
February 3, 2012 at 11:41 pm (http://www.helicontech.com/articles/installing-redmine-on-windows-in-production/#comment-34586)
Thanks, you saved my day
3. Lluis says:
February 11, 2012 at 5:01 pm (http://www.helicontech.com/articles/installing-redmine-on-windows-in-production/#comment-34626)
Does naybody know about the configuration file for useing redmine with SQL Server, if possible?
thnx in advance
lluis
4. Pablo says:
February 28, 2012 at 11:10 am (http://www.helicontech.com/articles/installing-redmine-on-windows-in-production/#comment-34634)
Im getting the following error:
No routes matches /redmine/admin with {:method=>:get}
Do you have any idea why this is happening?
I have tried different settings (create a new site, or using an existing one,..) without positive result.
thank you in advance.
5. Slavik says:
March 1, 2012 at 2:46 pm (http://www.helicontech.com/articles/installing-redmine-on-windows-in-production/#comment-34636)
Hello.
When you install Redmine into a sub-URIadditional configuration is required. Please open config/environment.rb file and add the following
line at the bottom:
Redmine::Utils::relative_url_root = /redmine
See http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_in_a_sub-URI
(http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_in_a_sub-URI) for more information.
Thank you.

Search

Feed
Entries RSS (Really Simple Syndication) (/articles/feed/)

Categories

Tags

Helicon Ape (http://www.helicontech.com/articles/category/helicon-

caching
(http://www.helicontech.com/articles/tag/caching/)

ape/)
Helicon Jet (http://www.helicontech.com/articles/category/helicon-jet/)
Helicon Tech (http://www.helicontech.com/articles/category/helicontech/)
Helicon Zoo (http://www.helicontech.com/articles/category/heliconzoo/)
HotlinkBlocker
(http://www.helicontech.com/articles/category/hotlinkblocker/)
ISAPI_Rewrite

cms
(http://www.helicontech.com/articles/tag/cms/)
CFML (http://www.helicontech.com/articles/tag/cfml/)

Coldfusion (http://www.helicontech.com/articles/tag/coldfusion-2/)

django

(http://www.helicontech.com/articles/tag/django/) farcry
(http://www.helicontech.com/articles/tag/farcry/)

fastcgi

(http://www.helicontech.com/articles/tag/fastcgi/) from the inside

(http://www.helicontech.com/articles/tag/from-the-inside/) guide

(http://www.helicontech.com/articles/category/isapi_rewrite/)

(http://www.helicontech.com/articles/tag/guide/)

LinkFreeze (http://www.helicontech.com/articles/category/linkfreeze/)

hotlinking (http://www.helicontech.com/articles/tag/hotlinking/) humor

http://www.helicontech.com/articles/installingredmineonwindowsinproduction/

8/9

27/07/2015

InstallingRedmineonWindowsinproduction|HeliconTechBlog
(http://www.helicontech.com/articles/tag/humor/) iis (http://www.helicontech.com/articles/tag/iis/)

java
(http://www.helicontech.com/articles/tag/java/) load
iis6 (http://www.helicontech.com/articles/tag/iis6/)

balancer (http://www.helicontech.com/articles/tag/load-balancer/) manager

(http://www.helicontech.com/articles/tag/manager/) mod_auth
(http://www.helicontech.com/articles/tag/mod_auth/) mod_cache

(http://www.helicontech.com/articles/tag/mod_cache/)
mod_dbd
(http://www.helicontech.com/articles/tag/mod_dbd/)
mod_developer (http://www.helicontech.com/articles/tag/mod_developer/)
mod_disk_cache (http://www.helicontech.com/articles/tag/mod_disk_cache/)

mod_env

(http://www.helicontech.com/articles/tag/mod_env/) mod_evasive
(http://www.helicontech.com/articles/tag/mod_evasive/)

mod_expires

(http://www.helicontech.com/articles/tag/mod_expires/) mod_gzip

(http://www.helicontech.com/articles/tag/mod_gzip/)
mod_headers (http://www.helicontech.com/articles/tag/mod_headers/)

mod_hotlink

(http://www.helicontech.com/articles/tag/mod_hotlink/) mod_linkfreeze
(http://www.helicontech.com/articles/tag/mod_linkfreeze/) mod_log_config
(http://www.helicontech.com/articles/tag/mod_log_config/)

mod_proxy

(http://www.helicontech.com/articles/tag/mod_proxy/)

mod_rewrite
(http://www.helicontech.com/articles/tag/mod_rew

news
(http://www.helicontech.com/articles/tag/ne
mod_seo (http://www.helicontech.com/articles/tag/mod_seo/)

performance
(http://www.helicontech.com/articles/tag/performance/)
plesk (http://www.helicontech.com/articles/tag/plesk/) proxy
(http://www.helicontech.com/articles/tag/proxy/)

ruby

(http://www.helicontech.com/articles/tag/ruby/) security

(http://www.helicontech.com/articles/tag/security/)

SEO
(http://www.helicontech.com/articles/tag/seo/)
shared hosting (http://www.helicontech.com/articles/tag/shared-hosting/)

titbits
(http://www.helicontech.com/articles/tag/titbits/)
unicode (http://www.helicontech.com/articles/tag/unicode/) wordpress
(http://www.helicontech.com/articles/tag/wordpress-2/)

zoo

(http://www.helicontech.com/articles/tag/zoo/)

Products
Helicon Zoo (/zoo/)
Helicon Ape (/ape/)
ISAPI_Rewrite 3 (/isapi_rewrite/)
LinkFreeze (/linkfreeze/)
HotlinkBlocker (/hotlinkblocker/)
Helicon Jet (/heliconjet/)
Resources
Articles (/articles/)
Community (/community/)
Support (//support.helicontech.com/)
Old forum (/forum/)
Links
All downloads (/download.htm)
Buy (/order/)
Company
Contact us (//support.helicontech.com/)
Partners (/hosting/)
helicontech (//twitter.com/helicontech)
Helicon Tech (http://www.helicontech.com/) 20092014
Web Servers Enhancements

http://www.helicontech.com/articles/installingredmineonwindowsinproduction/

9/9