Commit f03f6be7 authored by jon richter's avatar jon richter

add : Dokku deployment environment + instructions

This implements small and basic changes to deploy frab with Dokku.
parent 038ce32d
source ''
ruby '2.2.3'
gem 'rails', '~> 4.2'
web: bundle exec rails server -p $PORT -e $RACK_ENV
# Deploying Frab with Dokku
Dokku is a Platform-as-a-Service (PaaS) engine which allows for simple `git push` deployments.
It builds on Heroku's `buildpack`s and is higly customizable.
To deploy a Frab application with `dokku`, please proceed as follows:
## 1. Setting up Dokku
Given you have access to your Dokku service via a simple alias (`alias dokku='ssh -t dokku@<DOKKU_HOST>'`) and `dokku version` works, do the following:
dokku create <APP_NAME>
The `.env` environment would then look similarily to
SECRET_KEY_BASE=<should_be_longer_than_32_chars, 'pwgen 32' suffices>
Pipe this configuration to dokku with
dokku config:set frab `paste -d " " -s .env`
Make sure you are using a branch which provides Ruby 2.2.3 in the `Gemfile` and the `web` process (only) in the `Procfile`.
dokku postgresql:create <DB_NAME>
dokku postgresql:link <APP_NAME> <DB_NAME>
## 2. Setting up frab
Then use the output of the second command to set up your `production` database connection in `config/database.yml`:
adapter: postgresql
encoding: unicode
database: <DB_NAME>
username: <DB_USER>
password: <DB_PASS>
  • Where to get the DB_PASS from? It is not shown in the DATABASE_URL variable

Please register or sign in to reply
host: postgresql
pool: 5
timeout: 5000
and force commit this file to your git tree, until the use of a `DATABASE_URL` environment variable is implemented.
## 3. Deploying Frab
git remote add dokku dokku@<DOKKU_HOST>:<APP_NAME>
git push dokku master
After this has completed successfully, you need to manually load the database schema with
dokku run frab bundle exec rake db:setup
That's it. Your application should be running at `<PROTO>://<APP_NAME>.<DOKKU_HOST>`.
  • Ah, that's the missing command to find out the credentials:

    dokku postgresql:info <APP_NAME> <DB_NAME>
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment