Simple local instance of Redmine

I've used Redmine for projects for more than a decade. I still use it for stuff I need to manage. Therefore I run it locally on my machine or tiny server. Here's how I run it.

Requirements

You'll need to have ruby, sqlite3 and subversion installed on your machine.

Setting up redmine

The documentation suggests to checkout the version you want.

svn co https://svn.redmine.org/redmine/branches/6.0-stable redmine-6.0

After the checkout create the config/database.yml file with the following contents:

production:
  adapter: sqlite3
  database: db/redmine.sqlite3

Now install the redmine ruby dependencies:

gem install bundler
bundle config set --local without 'development test'
bundle config set --local path 'vendor/bundle'
bundle install
bundle exec rake generate_secret_token

If all succeeded we now setup the database. If you have an sqlite database from a previous version make sure it's in the right location (db/redmine.sqlite3) so it can be migrated to the new version.

RAILS_ENV=production bundle exec rake db:migrate

Otherwise just creates a new empty database with default data:

RAILS_ENV=production bundle exec rake redmine:load_default_data

We're finished, test the redmine setup by running:

bundle exec rails server -e production

Visit the redmine setup by pointing your browser to http://localhost:3000

Simple as that!

If you get an error that webrick isn't available or something like that create the file Gemfile.local in the root directory with the following content and try again:

gem "puma"