Deploy OpenProject to Heroku – the easy way

OpenProject, the web-based project management system for location-independent team collaboration can easly be deployed to Heroku in about 15 minutes.

How to

Prepare OpenProject for Heroku

1. Clone the OpenProject GitHub repo:

git clone https://github.com/opf/openproject.git

2. Inside the OpenProjects folder, checkout your own master branch from stable:

git checkout stable
git checkout -b master stable

3. Add Herokus Rails 12factor Gem to the Gemfile and remove the SQLite3 Gem:

gem 'rails_12factor', group: :production    # Add
gem "sqlite3"                               # Remove

4. Install Ruby dependencies with Bundler:

rm Gemfile.lock
bundle install

5. Install JavaScript dependencies with npm:

npm install

6. Comment out (or delete) the following line from the gitignore file:

/vendor/assets/components

7. Change the web: process type in your Procfile to:

web: bundle exec unicorn -p $PORT -c ./config/unicorn.rb

Deploy

1. Commit all your changes:

git add .
git commit -m 'Prepare for Heroku'

2. Create your new Heroku app with a Postgres database:

heroku create your-apps-name --addons heroku-postgresql

3. Push your OpenProject instance to Heroku:

git push heroku master

3. Set a new Heroku environment variable SECRET_TOKEN:

heroku config:set SECRET_TOKEN=your_super_secret_token

4. Migrate the database and populate it with seed data:

heroku run rake db:migrate
heroku run rake db:seed

Enjoy

Now you should have your instance of OpenProject deployed on Heroku and can start to configure it to your own needs.