Redmine

h1. HowTos

{{>TOC}}

h2. Installation

* [[RedmineInstall|Generic installation instructions]]

* [[HowTo Install Redmine in a sub-URI|Generic sub-URI deployment instructions]]

h3. Operating Systems

h4. CentOS

* [[Redmine on CentOS installation HOWTO]]

* [[How to Install Redmine on CentOS (Detailed)|HowTo install Redmine on CentOS Detailed]]

* [[Redmine 2.0.3 with Subversion and LDAP Authentication (for Redmine and Subversion through Redmine) on Centos 6, i386 - detailed]]

* [[RedmineAndSELinuxOnCentOS|HowTo make Redmine, Phusion Passenger, Ruby Enterprise Edition, and Apache play nice with SELinux on CentOS]]

* "How To Install Redmine on CentOS with cPanel ":http://adil.az/uncategorized/installing-redmine-on-cpanel/

* "How To Install Redmine 1.3 on CentOS 5 with WHM/Cpanel using passenger ":http://borrowbits.com/2012/05/how-to-install-redmine-1-3-on-centos-server-with-whmcpanel/

h4. Debian

* [[HowTo Install Redmine 2 integrated with Gitolite 2 on Debian Wheezy with Apache and Phusion Passenger]]

* [[InstallRedmineOnDebianStableApacheMysqlPassenger|Install Ruby, Rails, Passenger and Redmine on Debian stable]]

* [[HowTo Install Redmine 2.1.0 on Debian Squeeze with Apache Passenger]]

* [[GitHub clone based on Debian Squeeze, Gitolite, Git, Git-Daemon, MySQL, Nginx and Mongrel Cluster]]

* "HowTo Install Redmine 0.8.x+ in Debian Etch with Apache fcgid":http://wiki.debuntu.org/wiki/Redmine/Install_on_Debian_Etch

* [[HowTo Install Redmine in a home directory on Debian]]

* [[HowTo Install Redmine using Debian package]]

* [[HowTo Install Redmine on Debian with Ruby-on-Rails and Apache2-Passenger]]

* "HowTo Install Redmine on Debian Squeeze with MySQL, Ruby-on-Rails and Apache2-Passenger":http://hodza.net/2012/03/15/howto-install-redmine-on-debian-6-squeeze-ruby-on-rails-apache2-passenger/

* [[HowTo Install Redmine on Debian Squeeze with Postgresql, Ruby-on-Rails and Apache2-Passenger]]

* [[HowTo Install Redmine on Debian Wheezy Testing with MySQL and Apache2-Passenger]]

* [[HowTo Install Redmine on subdirectory (sub-URI) on Apache]]

* [[Install Redmine with git and svn support over https on Debian wheezy using the Debian repository]]

h4. Fedora

* [[Fedora installation prerequisites]]

h4. FreeBSD

* "HowTo Install Redmine 2.1.x on FreeBSD + Apache + Passenger":http://thinkcactus.com/posts/installing-redmine-2-1-2-on-freebsd-with-passenger-and-rvm

* "HowTo Install Redmine 1.2.x on FreeBSD 8.2 Amd64 + FastCGI Apache":http://amberovsky.blogspot.com/2011/09/howto-redmine-12-on-freebsd-82-amd64.html

* "HowTo Install Redmine on FreeBSD with Mongrel Cluster and Apache Proxy Balance":http://openbr.org/2010/03/31/freebsd-e-redmine-com-mongrel-cluster-e-apache (pt-BR)

* "HowTo Install Redmine 2.3.x on FreeBSD + nginx + Passenger + Postgres":http://forums.freebsd.org/showthread.php?t=41256

h4. Gentoo

* "HowTo Install Redmine 1.1.2, 1.3.0 and 1.4.3 on Gentoo":http://en.gentoo-wiki.com/wiki/Redmine

h4. Mac OS X

* [[RedmineInstallOSX|How to install Redmine on Mac OS X]]

* [[RedmineInstallOSXServer|HowTo Install Redmine on Mac OS X Server]] 10.6 Snow Leopard

* [[RedmineInstallOSXLionServer|HowTo Install Redmine on Mac OS X Lion Server]]

h4. Microsoft Windows

* [[HowTo Install Redmine in a sub-URI on Windows with Apache]] (Zero-to-Redmine on Windows)

* "HowTo run Redmine with Mongrel as a Windows service":https://sites.google.com/site/alensit/software-tools/redmine#TOC-Running-under-Mongrel

* [[HowTo install rmagick gem on Windows]]

* [[HowTo run Redmine as a Windows service (win32-service + taskill approach)]]

* message#32693

h4. openSuse

* [[HowTo Install Redmine on openSUSE]]

h4. Solaris

* [[HowTo Install Redmine on Solaris]]

h4. Ubuntu

* [[HowTo Install Redmine 231 On Ubuntu 1204 with git and Redmine Git Hosting plugin]] 

* [[HowTo_Install_Redmine_on_Ubuntu_step_by_step]] for installing on a fresh Ubuntu 12.04

* [[HowTo Install Redmine in Ubuntu]]

* [[HowTo Install Redmine 2.1.2 in Ubuntu 12.10 and Apache Passenger]]

* [[HowToInstallRedmineOnUbuntuServer|HowTo Install Redmine 1.3.x with Mercurial and Subversion on Ubuntu Server 10.04]]

* "How To Install Redmine on Ubuntu 12.04 Server using Apache and mod_passenger with Subversion repositories.":http://grandslam90.wordpress.com/2012/05/22/howto-redmine-2-0-0-passenger-subversion-repositories-in-ubuntu-12-04/

* "How To Install Redmine on Ubuntu 11.10 Server using Apache and mod_passenger with performance improving options.":http://finiteline.homeip.net/index.php/programming/70-ruby/100-redmine-on-ubuntu-11-10

* "HowTo Install Redmine 1.1.x with Git and Gitosis on Ubuntu 11.04":http://www.x2on.de/2011/04/23/tutorial-redmine-with-git-and-gitosis-on-ubuntu-11-04/

* "Redmine+Apache+SVN+Postfix完整配置指南":http://www.swordair.com/docs/redmine-complete-configuration-on-ubuntu/ (简体中文)

* "HowTo Install Redmine with SVN, Git and Gitosis on Ubuntu 8.04":http://www.x2on.de/2010/10/30/tutorial-redmine-with-svn-git-and-gitosis-on-ubuntu-8-04/

* "HowTo Redmine Appliance from scratch with Ubuntu JeOS + Apache + Phusion Passenger + Ruby Enterprise":http://adminsq3.blogspot.com/2010/02/appliance-redmineapachephusion.html (es-ES)

* HowTo Redmine Appliance from scratch with Ubuntu JeOS + Apache + Mongrel cluster + Webmin integration "1":http://adminsq3.blogspot.com/2009/07/appliance-redmine-con-ubuntu-jeos-1.html "2":http://adminsq3.blogspot.com/2009/07/appliance-redmine-con-ubuntu-jeos-2.html  "3":http://adminsq3.blogspot.com/2009/07/appliance-redmine-con-ubuntu-jeos-3.html (es-ES)

* "Howto install Redmine on Ubuntu 10.04 LTS with Apache + mod passenger - With full GIT integration":http://tolecnal.net/2012/02/howto-install-redmine-on-ubuntu-10-04-lts/

* "HowTo Install Redmine on Ubuntu and keep system clean":http://www.helplinux.ru/wiki/en:kb:redmine-installation

* "Screencast - Installing Redmine 2.2 + Passenger + nginx + rvm on Ubuntu 12.04":http://redminecrm.com/boards/4/topics/448-installing-redmine-2-2-passenger-nginx-rvm-on-ubuntu-12-04

h3. Web- and Application Servers

h4. Apache

* [[HowTo configure Apache to run Redmine]]

h4. Apache Tomcat

* [[HowTo install Redmine in Apache Tomcat]]

h4. Mongrel

* [[HowTo run Redmine with a Mongrel cluster]]

h4. Nginx

* [[HowTo configure Nginx to run Redmine]]

h4. Phusion Passenger

* [[HowTo have both development and production environment available from Apache with VirtualHost]]

h3. Application Stacks

h4. Bitnami

* [[How to install Redmine in Linux Windows and OS X using BitNami Redmine Stack|How to install Redmine using BitNami installer (Windows, OS X, Linux)]] 

* "Install GitHub clone with Redmine with BitNami and Gitosis":http://xdissent.com/2010/05/04/github-clone-with-redmine/

* "Screencast How to install Redmine with plugins in Windows 2008 using BitNami stack":http://redminecrm.com/boards/4/topics/1153

h2. Configuration

h3. Authentication

* "HowTo Authenticate Apache against Redmine with AuthMySQL":http://ailoo.net/2009/03/authenticate-apache-against-redmine-with-authmysql/

* "CAS and Redmine":http://blogs.igalia.com/mrego/2009/07/22/casify-redmine/

* [[HowTo configure a single sign-on into Redmine from an other App on the same server]]

h3. Database

* "HowTo Install Redmine with an Oracle backend":http://matthewrupert.net/2011/03/11/running-redmine-with-an-oracle-backend/

* [[HowTo make Wiki history working with Postgres 9.0]]

h3. Email

* [[HowTo configure Redmine to mail to MS Exchange server]]

h3. Source Code Management (SCM)

* [[HowTo setup automatic refresh of repositories in Redmine on commit]]

* [[HowTo configure Redmine for advanced git integration]]

* [[HowTo Easily integrate a (SSH secured) GIT repository into redmine]]

* [[HowTo configure Redmine for advanced Mercurial integration]]

* [[HowTo configure Redmine for advanced Subversion integration]]

* [[HowTo configure Redmine for advanced Bazaar integration]]

* [[HowTo keep in sync your git repository for redmine]]

* [[HowTo simply keep Redmine in sync with GitHub]]

h2. Migration

* [[HowTo Migrate Redmine to a new server to a new Redmine version]]

h2. Customizing Redmine

* [[HowTo translate Redmine in your own language]]

* [[HowTo create a custom Redmine theme]]

* [[HowTo add a logo to your Redmine banner]]

h2. Miscellaneous

* [[HowTo Mylyn|How to connect a Mylyn repository to Redmine]]

* "Scaling infrastructure - load balancing":/boards/1/topics/24727?r=24739#message-24739

* [[HowTo FixUpImportedUsers|How to fix up users imported from another system]] or when you change authentication systems.

* [[HowTo Install Redmine on Heroku]]

* [[HowTo Configure Fail2ban For Redmine]]