Skip to main content
Review the requirements below before installing Redmine.

Ruby

Redmine requires Ruby 3.2 or later:
Ruby versionStatus
3.2.xSupported
3.3.xSupported
3.4.xSupported
4.0.xSupported
Redmine is built on Rails 8.1.2. Ensure your Ruby version is compatible with this Rails release.

Database

One of the following databases is required:

MySQL

Tested with MySQL 8. Requires setting transaction_isolation to READ-COMMITTED in config/database.yml. Uses the mysql2 or trilogy adapter gem.

PostgreSQL

Tested with PostgreSQL 14. Uses the pg adapter gem.

SQLite3

Tested with SQLite 3.11. Suitable for development and small deployments. Uses the sqlite3 adapter gem.

SQL Server

Tested with SQL Server 2012. Uses the tiny_tds and activerecord-sqlserver-adapter gems.
The correct database adapter gem is installed automatically by Bundler based on the adapter value in config/database.yml.

Optional dependencies

SCM binaries

To enable repository browsing, the relevant SCM command-line tools must be installed and available in PATH:
SCMBinaryDefault command
Subversionsvnsvn
Mercurialhghg
Gitgitgit
CVScvscvs
Bazaarbzrbzr
See Repositories for how to configure custom binary paths.

ImageMagick

Install ImageMagick to enable Gantt chart export to PNG images. Redmine uses the MiniMagick gem (mini_magick ~> 5.2.0) and calls the convert binary. Configure the path in config/configuration.yml if the binary is not in PATH:
default:
  imagemagick_convert_command: /usr/bin/convert

Pandoc

Install Pandoc to enable preview of Microsoft Office (.docx, .xlsx, .pptx) and LibreOffice Writer (.odt) documents. Version 3.8.3 or later is recommended. Older versions support only .docx and .odt. Configure the path in config/configuration.yml:
default:
  pandoc_command: /usr/local/bin/pandoc

Ghostscript

Install Ghostscript (gs) to enable thumbnail generation for PDF attachments:
default:
  gs_command: /usr/bin/gs

Supported browsers

Redmine supports the current release of:
  • Firefox
  • Safari
  • Chrome
  • Chromium
  • Microsoft Edge

Build docs developers (and LLMs) love