a community of people building open source church software

Install Church.IO Profiles

Profiles is free software. You can download the source code and deploy it to a server you control.

To upgrade an existing Profiles install, click here.

This document assumes you'll be deploying to the free cloud-based service Heroku. If you want to install to another service or your own dedicated server, please hop onto the mailing list and get some help.

1. Create a Facebook "App"

For the sake of these instructions, let's pretend your church's name is "OneChurch of Grand Rapids."

  1. Go to (log into Facebook if you're not already).
  2. Click on "Apps" at the top.
  3. Click the "Create New App" button.
  4. Enter your church name, e.g. "OneChurch of Grand Rapids"
  5. For the namespace, enter a similar name, but only with lowercase characters and dashes, e.g. "onechurch-grandrapids".
  6. On the app settings page, click "Website" and enter URL where your app will be, "" (see note at right for more help).
  7. Now copy the App ID and App Secret from the top of the page (we'll need this in a bit).
  8. Save changes.

2. Install Ruby and Git

You'll need to install Ruby and Git on your system in order to download and deploy to Heroku.

  1. Visit and download the installer for Ruby 1.9.3.
    Ruby Download
  2. During the Ruby install, you should choose to have the Ruby executables added to your path:
    Add Ruby to your PATH
  3. You should already have Ruby on your Mac system. You can verify by running ruby -v and verifying it is version 1.8.7 or higher.
  4. Use your system package manager to install Ruby, e.g. sudo apt-get install ruby rubygems (actual command will depend on your particular distribution).
  5. Once you have Ruby, open the command promptterminal and install the "heroku" gem with the following command:
    sudo gem install heroku
  6. Visit and click on Windows Mac on the right to install Git.
  7. Choose "Run Git from the Windows Command Prompt" when asked:
    Add Git to your PATH
  8. Use your system package manager to install Git. On some systems, the package is called "git-core".

3. Download Profiles

We'll use Git to download the source code for Profiles.

In the command promptterminal, change to the directory where you want to download the package, then type the following commands:

git clone git://
cd profiles

4. Configure Profiles

There are a few settings we need to configure before installation can occur.

  1. Create your new Heroku app with the following command, replacing NAME with the name you chose before, e.g. onechurch-grandrapids.
    heroku create --stack cedar NAME
  2. On the Start menu, open "Git Bash" and type the following:
    You can accept each default setting by just pressing enter. Once your key has been generated, close this window and return to the command prompt for the next step.
  3. Add your ssh key to Heroku:
    heroku keys:add
  4. Copy config/settings.yml.example to config/settings.yml and edit the file appropriately. Set the facebook_app_id and facebook_secret to what you copied down from step one above.
  5. Back in the command promptterminal, type:
    rake -f lib/tasks/heroku.rake profiles:heroku:config
    There are no line breaks in the above command.
  6. Then copy and paste the displayed commands into the command promptterminal.
  7. To set up outgoing email (optional; see note to the side), type the following:
    heroku addons:add sendgrid:starter

5. Deploy

git push heroku v0.2.3:master
heroku run rake db:migrate

Now, visit your new site!


To upgrade to a new release, run the following commands:

git pull
git push heroku v0.2.3:master
heroku run rake db:migrate

Getting Help

To get help, please send a message to the mailing list or jump into the IRC chat room on freenode.