System Requirements

← Back to installer

Operating System

The installer is compatible exclusively with the following Linux distributions:

DistributionVersionCodename
Debian13Trixie
Ubuntu24.04 LTSNoble Numbat

Other distributions or older versions are not supported. The script detects the OS version automatically and will warn if it does not match.

Execution Privileges

The script must be run as root. Without administrator privileges the installer stops immediately.

sudo bash redmine-installer.sh

Minimum Hardware

ResourceMinimumNotes
CPU 1 vCPU 2 vCPUs recommended to speed up Ruby compilation
RAM 512 MB The script automatically creates a 2 GB swap file if less than 1 GB of swap is available
Disk 10 GB free Ruby + gems + Redmine + database + optional swap
On low-RAM VPS instances, Ruby compilation can take 20–30 minutes. The script will display a progress bar during this step.

Network Connectivity

The server requires outbound Internet access during installation to download:

SourceWhat is downloaded
Distribution mirrorsSystem packages via apt
redmine.orgRedmine source archive
github.comrbenv and ruby-build
rubygems.orgRuby gems (Bundler, Passenger, etc.)

Required Ports

PortProtocolRequired for
80 TCP (inbound) Serving Redmine over HTTP; required by Let's Encrypt for domain validation
443 TCP (inbound) HTTPS (only if SSL is enabled)

Make sure your firewall and/or cloud security group allows inbound traffic on these ports before running the installer.

SSL-Specific Requirements

None (HTTP only) — No additional requirements.

Let's Encrypt (automatic)

  • The domain must be registered and pointing to the server's public IP before running the installer.
  • Port 80 must be reachable from the Internet — Let's Encrypt performs an HTTP challenge to verify domain ownership.
  • A valid email address is required for certificate registration.
If DNS has not propagated yet, the installer will continue and serve Redmine over HTTP. The command to obtain the certificate later will be shown at the end of the installation summary.

Manual certificate

  • The certificate file (.crt / .pem) and private key (.key) must already exist on the server at the paths you specify in the installer wizard.

Fresh System Recommended

The installer is designed for newly provisioned servers. If another web server is already running and occupying ports 80 or 443, the installation will fail when trying to start Apache or Nginx.

Pre-flight Checklist

  • Debian 13 or Ubuntu 24.04 installed on the target server
  • Script will be executed with sudo
  • Outbound Internet access is available on the server
  • Port 80 is open in the firewall / security group
  • Domain is pointing to the server's public IP — only required for Let's Encrypt SSL
  • Certificate and private key files are present on the server — only required for manual SSL