HowTos¶

• Table of contents
• HowTos
  • Installation
    • Operating Systems
      • CentOS
      • Debian
      • Fedora
      • RHEL
      • FreeBSD
      • OpenBSD
      • Mac OS X
      • Microsoft Windows
      • openSuse
      • Solaris
      • Ubuntu
    • Web- and Application Servers
      • Apache
      • Apache Tomcat
      • Mongrel
      • Nginx
      • Phusion Passenger
    • Application Stacks
      • Bitnami
      • IBM Cloud
      • Cloudron
      • alwaysdata
  • 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 4.2.x on Centos 7 with SELinux (Apache 2.4, Passenger)
• 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
• 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 3.4.2 on CentOS 7 (vagrant and provision script)
• 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¶

• Install Redmine 6.0.3 on Debian 12.4 (MySQL)
• How to Install Redmine 4.2 on Debian 10
• Install Redmine 3.3.4 on Debian 9 (Postgresql)
• Install Redmine 3.3 on Debian 8 (Passenger)
• Install Redmine 3.0.1 on Debian 8 (mysql)
• Install Redmine 1.3.2 on Debian Squeeze
• Install Redmine 1.3.7 on Debian (mysql)
• Install Redmine 1.3.7 on Debian 6.0.1 (Postgresql)
• Install Redmine 3.4.x on Debian 9 in about 30 minutes
• Install Redmine 2.5.1 on Debian7 (+ rbenv including Basic-Auth-Login w/ Apache) || Nginx
• Archived Debian How-Tos Redmine Version 0.6.0 - 2.x.x

Fedora¶

• Install Redmine 4.0.0 on Fedora 29
• Install Redmine 2.5.x on Fedora 20

RHEL¶

• Redmine 3.4 on RHEL 7.4

FreeBSD¶

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

OpenBSD¶

• Install Redmine with privsep on OpenBSD using ansible

Mac OS X¶

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

Microsoft Windows¶

• 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)
• Installing Redmine on Windows Server 2008 R2 and Apache w...
• HowTo install rmagick gem on Windows
• HowTo run Redmine with Mongrel as a Windows service
• Install Redmine on Windows Server 2008 R2 (Apache with Thin as a windows service)

openSuse¶

• Install Redmine on OpenSUSE 12.2 (Startscript)

Solaris¶

• Install Redmine on Solaris

Ubuntu¶

• 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)
• Install Redmine 3.0.x on Ubuntu 14.04 (Apache2, Phusion Passenger, MySQL, Subversion and Gitolite)
• Install Redmine 2.5.x on Ubuntu 14.04 (Apache2, Phusion Passenger, MySQL and Subversion)
• Install Redmine 2.3.4 On Ubuntu 12.04 (with git and Redmine Git Hosting plugin)
• Install Redmine 2.2, 1.3.x, 0.9.x on Ubuntu 10.04 using Passenger
• Install Redmine 2.1.2 on Ubuntu 12.10 (Apache Passenger)
• Install Redmine 1.3.x on Ubuntu Server 10.04(with Mercurial and Subversion)
• Install Redmine on Ubuntu 12.04
• Install Redmine 3.x on Ubuntu 14.04 (rvm + nginx + Phusion Passenger + MySQL)
• Install Redmine 2.6 on an Ubuntu 14.04 server (MariaDB, Puma and Nginx)
• Install Redmine 2.5 on Ubuntu 14.04(using Nginx, Puma, and MariaDB/MySQL)
• Install Redmine 2.5.x on Ubuntu 14.04 (Apache2, RVM and Passenger)
• Install Redmine 2.3.3 on Ubuntu 13.04 (rvm + Apache + Phusion Passenger + MySQL)
• Install Redmine 2.2 on Ubuntu 12.04(and keep system clean)
• Install Redmine 2.0.0 on Ubuntu 12.04 (using Apache and mod_passenger with Subversion repositories)
• Install Redmine 1.3.0 on Ubuntu 10.04 LTS (with Apache + mod passenger + full GIT integration)
• Install Redmine 1.1.x on Ubuntu 11.04 (with Git and Gitosis)
• Install Redmine Apache+SVN+Postfix完整配置指南 (简体中文)
• Install Redmine on Ubuntu 8.04 (with SVN, Git and Gitosis)
• 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)

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 (redmine 0.8.7)

Mongrel¶

• HowTo run Redmine with a Mongrel cluster

Nginx¶

• HowTo configure Nginx to run Redmine (2010)
• How to securely configure nginx and Redmine (2016)

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

IBM Cloud¶

• How to install Redmine on IBM Cloud

Cloudron¶

• Install Redmine on Cloudron

alwaysdata¶

• 1-click Redmine Installation on alwaysdata

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
• A howto (Alternative/custom authentication HowTo) for implementing authentication against a different database.

Database¶

• HowTo Install 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
• How to use encrypted database credentials

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
• HowTo keep Redmine in sync with Github without dedicated plugin (Apache CGI + Github Webhook)

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