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

* [[Install_Redmine_421_on_Centos_7|Install Redmine 4.2.x on Centos 7 with SELinux (Apache 2.4, Passenger)]]

* [[Install_Redmine_346_on_Centos_75|Install Redmine 3.4.6 on Centos 7.5 (MySQL 8, Apache 2.4, GIT, SVN, LDAP)]]

* [[Install Redmine 2.5.x on Centos 6.5 complete|Install Redmine 2.5.x on Centos 6.5]]

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

* [[Redmine on CentOS installation HOWTO|Install Redmine 1.3.2 on CentOS 5 or Centos 6]]

* [[How to Install Redmine on CentOS (Detailed)|Install Redmine 1.3.0 on CentOS 5 or 6]]

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

* "Install Redmine 3.4.2 on CentOS 7 (vagrant and provision script) ":https://github.com/jiannelli/vagrant-redmine

* "Install Redmine 2.1.2 on CentOS 6 VPS":https://www.rosehosting.com/blog/installing-redmine-on-centos-6-vps/

* "Install Redmine 1.4.2 on CentOS 5 (with cPanel) ":http://web.archive.org/web/20120715041206/http://adil.az:80/uncategorized/installing-redmine-on-cpanel/

* "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

* "How to Install Redmine 4.2 on Debian 10":https://www.atlantic.net/dedicated-server-hosting/how-to-install-redmine-4-2-on-debian-10/

* [[HowTo Install Redmine on Debian 9|Install Redmine 3.3.4 on Debian 9 (Postgresql)]]

* [[InstallRedmineOnDebianStableApacheMysqlPassenger|Install Redmine 3.3 on Debian 8 (Passenger) ]]

* [[HowTo Install Redmine on Debian 8 with Apache2-Passenger|Install Redmine 3.0.1 on Debian 8 (mysql) ]]

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

* [[HowTo Install Redmine on Debian with Ruby-on-Rails and Apache2-Passenger|Install Redmine 1.3.7 on Debian (mysql) ]]

* [[HowTo Install Redmine on Debian Squeeze with Postgresql, Ruby-on-Rails and Apache2-Passenger|Install Redmine 1.3.7 on Debian 6.0.1 (Postgresql) ]]

* "Install Redmine 3.4.x on Debian 9 in about 30 minutes (MariaDB/Passenger/Apache)":https://martin-denizet.com/30-minutes-to-redmine-3-4-an-express-installation-guide/

* "Install Redmine 2.5.1 on Debian7 (+ rbenv including Basic-Auth-Login w/ Apache) || Nginx":https://www.mare-system.de/blog/page/1396355085/

* [[Archived Debian How-Tos Redmine Version 0.6.0 - 2.x.x]]

h4. Fedora

* [[Install Redmine on Fedora|Install Redmine 4.0.0 on Fedora 29]]

* [[FedoraInstallation|Install Redmine 2.5.x on Fedora 20]]

h4. RHEL

* [[Install_Redmine_34_on_RHEL74|Redmine 3.4 on RHEL 7.4]]

h4. FreeBSD

* "Install Redmine 2.1.x on FreeBSD + Apache + Passenger":http://thinkcactus.io/posts/installing-redmine-freebsd-passenger-rvm

* "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

* "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)

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

h4. OpenBSD

* "Install Redmine with privsep on OpenBSD using ansible (both puma and unicorn)":https://github.com/bsd-ac/openbsd-redmine

h4. Mac OS X

* [[RedmineInstallOSX|Install Redmine on Mac OS X]]

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

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

* [[RedmineInstallOSXMavericksServer|Install Redmine on Mac OS X 10.9 Mavericks / 10.10 Yosemite / 10.11 El Capitan - Server and Client]]

h4. Microsoft Windows

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

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

* message#32693

* [[HowTo install rmagick gem on Windows]]

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

* "Install Redmine on Windows Server 2008 R2 (Apache with Thin as a windows service) ":http://www.redmine.org/boards/1/topics/32693

h4. openSuse

* [[HowTo Install Redmine on openSUSE|Install Redmine on OpenSUSE 12.2 (Startscript)]]

h4. Solaris

* [[HowTo Install Redmine on Solaris|Install Redmine on Solaris]]

h4. Ubuntu

* [[HowTo Install Redmine 5.0.x on Ubuntu 20.04 with Apache2|Install Redmine 5.0.x on Ubuntu 20.04 with Apache2]]

* "Install Redmine 3.4.x on Ubuntu 16.04 (rvm + nginx + Phusion Passenger + MySQL) ":http://www.untrustedconnection.com/2018/01/redmine-passenger-and-nginx-on-ubuntu.html

* [[HowTo Install Redmine 3.0.x on Ubuntu 14.04 with Apache2, Phusion Passenger, MySQL, Subversion and Git (Gitolite)|Install Redmine 3.0.x on Ubuntu 14.04 (Apache2, Phusion Passenger, MySQL, Subversion and Gitolite) ]]

* [[HowTo Install Redmine 2.5.x on Ubuntu 14.04 with Apache2, Phusion Passenger, MySQL and Subversion|Install Redmine 2.5.x on Ubuntu 14.04 (Apache2, Phusion Passenger, MySQL and Subversion)]]

* [[HowTo Install Redmine 231 On Ubuntu 1204 with git and Redmine Git Hosting plugin|Install Redmine 2.3.4 On Ubuntu 12.04 (with git and Redmine Git Hosting plugin)]] 

* [[HowTo Install Redmine in Ubuntu|Install Redmine 2.2, 1.3.x, 0.9.x on Ubuntu 10.04 using Passenger]]

* [[HowTo Install Redmine 2.1.2 in Ubuntu 12.10 and Apache Passenger|Install Redmine 2.1.2 on Ubuntu 12.10 (Apache Passenger)]]

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

* [[HowTo_Install_Redmine_on_Ubuntu_step_by_step|Install Redmine on Ubuntu 12.04]]

* "Install Redmine 3.x on Ubuntu 14.04 (rvm + nginx + Phusion Passenger + MySQL) ":http://www.untrustedconnection.com/2016/04/redmine-passenger-and-nginx-on-ubuntu.html

* "Install Redmine 2.6 on an Ubuntu 14.04 server (MariaDB, Puma and Nginx) ":https://www.rosehosting.com/blog/install-redmine-on-an-ubuntu-14-04-server-with-mariadb-puma-and-nginx/

* "Install Redmine 2.5 on Ubuntu 14.04(using Nginx, Puma, and MariaDB/MySQL) ":https://blog.rudeotter.com/install-redmine-with-nginx-puma-and-mariadbmysql-on-ubuntu-14-04/

* "Install Redmine 2.5.x on Ubuntu 14.04 (Apache2, RVM and Passenger) ":http://martin-denizet.com/install-redmine-2-5-x-git-subversion-ubuntu-14-04-apache2-rvm-passenger/

* "Install Redmine 2.3.3 on Ubuntu 13.04 (rvm + Apache + Phusion Passenger + MySQL) ":http://ociotec.com/servidor-redmine-en-ubuntu-desde-cero/

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

* "Install Redmine 2.0.0 on Ubuntu 12.04 (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/

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

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

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

* "Install Redmine on Ubuntu 8.04 (with SVN, Git and Gitosis) ":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)

h3. Web- and Application Servers

h4. Apache

* [[HowTo configure Apache to run Redmine]]

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

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]]

* "How to securely configure nginx and Redmine":http://www.untrustedconnection.com/2016/05/nginx-https-with-lets-encrypt-and.html

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

h4. IBM Cloud

* [[How to install Redmine on IBM Cloud kubernetes cluster|How to install Redmine on IBM Cloud]]

h4. Cloudron

* "Install Redmine on Cloudron":https://cloudron.io/button.html?app=org.redmine.coudronapp

h4. alwaysdata

* "1-click Redmine Installation on alwaysdata":https://www.alwaysdata.com/en/marketplace/redmine/

h2. Configuration

h3.  [[BrowserCaching]]

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]]

* A howto ([[Alternative/custom authentication HowTo]]) for implementing authentication against a different database.

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]]

* [[HowTo convert a database from utf8 to utf8mb4]]

* [[How to migrate old databases, i.e. previous to redmine 4.2.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]]

* [[HowTo keep Redmine in sync with Github without dedicated plugin (Apache CGI + Github Webhook)]]

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 Install Redmine (> 2.5.x) on Heroku|HowTo Install Redmine (> 2.5.x) on Heroku]]

* [[HowTo Install Redmine (3.x.x) on Heroku ]]

* [[HowTo Configure Fail2ban For Redmine]]

* [[HowTo find out the redmine version number you are using]]

* [[HowTo import issues]]