HowTos¶

• Table of contents
• HowTos
  • Installation
    • Operating Systems
      • CentOS
      • Debian
      • Fedora
      • FreeBSD
      • Gentoo
      • Mac OS X
      • Microsoft Windows
      • openSuse
      • Solaris
      • Ubuntu
    • Web- and Application Servers
      • Apache
      • Apache Tomcat
      • Mongrel
      • Nginx
      • Phusion Passenger
    • Application Stacks
      • Bitnami
      • Cloudron
  • Configuration
    • BrowserCaching
    • Authentication
    • Database
    • Email
    • Source Code Management (SCM)
  • Migration
  • Customizing Redmine
  • Miscellaneous

Installation¶

• Generic installation instructions
• Generic sub-URI deployment instructions

Operating Systems¶

CentOS¶

• Install Redmine 2.5.x on Centos 6.5
• Install Redmine 2.0.3 on Centos 6.3 (Subversion and LDAP Authentication)
• Install Redmine 1.3.2 on CentOS 5 or Centos 6
• Install Redmine 1.3.0 on CentOS 5 or 6
• 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 2.1.2 on CentOS 6 VPS
• Install Redmine 1.4.2 on CentOS 5 (with cPanel)
• Install Redmine 1.3 on CentOS 5 (with WHM/Cpanel using passenger)

Debian¶

• HowTo Install Redmine on Debian 9
• Howto Install Redmine + rbenv on Debian7 including Basic-Auth-Login w/ Apache || Nginx
• Install Ruby, Rails, Passenger and Redmine on Debian stable
• GitHub clone based on Debian Squeeze, Gitolite, Git, Git-Daemon, MySQL, Nginx and Mongrel Cluster
• HowTo Install Redmine on Debian with Ruby-on-Rails and Apache2-Passenger
• HowTo Install Redmine on Debian Squeeze with Postgresql, Ruby-on-Rails and Apache2-Passenger
• Redmine with Apache and MySQL on Debian 8 jessie

• Archived Debian How-Tos Redmine Version 0.6.0 - 2.x.x

Fedora¶

• HowTo Install Redmine 2.5.x on Fedora 20

FreeBSD¶

• HowTo Install Redmine 2.1.x on FreeBSD + Apache + Passenger
• HowTo Install Redmine 1.2.x on FreeBSD 8.2 Amd64 + FastCGI Apache
• HowTo Install Redmine on FreeBSD with Mongrel Cluster and Apache Proxy Balance (pt-BR)
• HowTo Install Redmine 2.3.x on FreeBSD + nginx + Passenger + Postgres

Gentoo¶

• HowTo Install Redmine 1.1.2, 1.3.0 and 1.4.3 on Gentoo

Mac OS X¶

• How to install Redmine on Mac OS X
• HowTo Install Redmine on Mac OS X Server 10.6 Snow Leopard
• HowTo Install Redmine on Mac OS X Lion Server
• HowTo Install Redmine on Mac OS X 10.9 Mavericks / 10.10 Yosemite / 10.11 El Capitan - Server and Client

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
• HowTo install rmagick gem on Windows
• HowTo run Redmine as a Windows service (win32-service + taskill approach)
• Installing Redmine on Windows Server 2008 R2 and Apache w...

openSuse¶

• HowTo Install Redmine on openSUSE

Solaris¶

• HowTo Install Redmine on Solaris

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
• HowTo Install Redmine 1.3.x with Mercurial and Subversion on Ubuntu Server 10.04
• How To Install Redmine using Nginx, Puma, and MariaDB/MySQL on Ubuntu 14.04
• How To Install Redmine on Ubuntu 12.04 Server using Apache and mod_passenger with Subversion repositories.
• How To Install Redmine on Ubuntu 11.10 Server using Apache and mod_passenger with performance improving options.
• HowTo Install Redmine 1.1.x with Git and Gitosis on Ubuntu 11.04
• Redmine+Apache+SVN+Postfix完整配置指南 (简体中文)
• HowTo Install Redmine with SVN, Git and Gitosis on Ubuntu 8.04
• HowTo Redmine Appliance from scratch with Ubuntu JeOS + Apache + Phusion Passenger + Ruby Enterprise (es-ES)
• HowTo Redmine Appliance from scratch with Ubuntu JeOS + Apache + Mongrel cluster + Webmin integration 1 2 3 (es-ES)
• Howto install Redmine on Ubuntu 10.04 LTS with Apache + mod passenger - With full GIT integration
• HowTo Install Redmine on Ubuntu and keep system clean
• Screencast - Installing Redmine 2.2 + Passenger + nginx + rvm on Ubuntu 12.04
• Howto install Redmine on Ubuntu with rvm + Apache + Phusion Passenger + MySQL
• Install Redmine 2.5.x on Ubuntu 14.04 with Apache2, RVM and Passenger
• HowTo Install Redmine 2.5.x on Ubuntu 14.04 with Apache2, Phusion Passenger, MySQL and Subversion
• HowTo Install Redmine 3.0.x on Ubuntu 14.04 with Apache2, Phusion Passenger, MySQL, Subversion and Git (Gitolite)
• How to Install Redmine 3.x on Ubuntu 14.04 with rvm + nginx + Phusion Passenger + MySQL
• Install Redmine on an Ubuntu 14.04 server with MariaDB, Puma and Nginx

Web- and Application Servers¶

Apache¶

• HowTo configure Apache to run Redmine
• HowTo Install Redmine on subdirectory (sub-URI) on Apache

Apache Tomcat¶

• HowTo install Redmine in Apache Tomcat

Mongrel¶

• HowTo run Redmine with a Mongrel cluster

Nginx¶

• HowTo configure Nginx to run Redmine
• How to securely configure nginx and Redmine

Phusion Passenger¶

• HowTo have both development and production environment available from Apache with VirtualHost

Application Stacks¶

Bitnami¶

• How to install Redmine using BitNami installer (Windows, OS X, Linux)
• Install GitHub clone with Redmine with BitNami and Gitosis
• Screencast How to install Redmine with plugins in Windows 2008 using BitNami stack

Cloudron¶

• Install Redmine on Cloudron

Configuration¶

BrowserCaching¶

Authentication¶

• HowTo Authenticate Apache against Redmine with AuthMySQL

• CAS and Redmine

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

Database¶

• HowTo Install Redmine with an Oracle backend
• HowTo make Wiki history working with Postgres 9.0

Email¶

• HowTo configure Redmine to mail to MS Exchange server

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

Migration¶

• HowTo Migrate Redmine to a new server to a new Redmine version

Customizing Redmine¶

• HowTo translate Redmine in your own language
• HowTo create a custom Redmine theme
• HowTo add a logo to your Redmine banner

Miscellaneous¶

• How to connect a Mylyn repository to Redmine
• Scaling infrastructure - load balancing
• 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 Configure Fail2ban For Redmine
• HowTo find out the redmine version number you are using
• HowTo import issues