MirrorNest
← All guides

Redmine

Redmine is a mature, flexible project management and issue-tracking tool built on Ruby on Rails; its official documentation covers installing it from source rather than via Docker.

Target: Ubuntu 22.04 LTSProject ManagementOfficial homepage ↗Official docs ↗
This guide is synthesized from Redmine's own official documentation, linked above — always cross-check exact package/version names there before running these commands on a production server, since distro and project versions move over time.

  1. 1Install prerequisites

    Redmine needs Ruby, Bundler, and a supported database (PostgreSQL, MySQL, or SQLite). Install Ruby and your chosen database server via your distribution's packages before continuing.

  2. 2Download and extract Redmine

    Download a released package from the official downloads page and extract it to your install directory.

    Official Redmine downloads page ↗

  3. 3Create the database

    Example shown for PostgreSQL; run these in psql as a superuser.

    CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';
    CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;

  4. 4Configure the database connection

    Copy config/database.yml.example to config/database.yml and fill in the production adapter, database name, host, username, and password.

  5. 5Install gem dependencies

    bundle config set --local without 'development test'
    bundle install

  6. 6Generate the secret token and initialize the database

    bundle exec rake generate_secret_token
    RAILS_ENV=production bundle exec rake db:migrate
    RAILS_ENV=production bundle exec rake redmine:load_default_data

  7. 7Set permissions and start Redmine

    mkdir -p tmp tmp/pdf public/assets
    sudo chown -R redmine:redmine files log tmp public/assets
    sudo chmod -R 755 files log tmp public/assets
    bundle exec rails server -e production

    Log in with the default admin / admin account and change the password immediately. For real production traffic, run Redmine behind Passenger or Puma with nginx rather than the built-in test server.