On the remote machine, go ahead and delete your public key from the root users home directory.

rm /root/id_rsa.pub

After cloning the Gitosis repository to your local machine, you simply modify and commit changes to the 'gitosis.conf' file inside of the 'gitosis-admin' folder.

If you're configuring new users, simply add their public SSH keys to the 'keydir' folder with the '.pub' file extension. Refer to these users using the filename of the public key file without the '.pub' extension.

For instance I've added a repository called 'marketsim', and then added 'marketsim' to the 'writable' setting for the gitosis-admin group.

[gitosis]

[group gitosis-admin]
writable = gitosis-admin marketsim
members = jason@mymacbook.local

[repo marketsim]
gitweb = no
description = Market Simulation App
owner = Jason Miller
daemon = no

Alternatively I could create a new group with writable access to the 'marketsim' repository.

[gitosis]

[group gitosis-admin]
writable = gitosis-admin
members = jason@mymacbook.local

[group marketsim-team]
members = jason@mymacbook.local
writable = marketsim

[repo marketsim]
gitweb = no
description = Market Simulation App
owner = Jason Miller
daemon = no

I could add 'newteammember.pub' in the 'keydir' folder, then add 'newteammember' after 'jason@mymacbook.local' separated by a space. This would make another team member part of that group which has write access to the repository.

After configuring a new repository, and giving my own local user write access to that repository, I've push the changes via a commit to the remote gitosis-admin repository.

NOTE: You may receive the warning "remote: WARNING:gitosis.gitweb.set_descriptions:Cannot find 'yourrepo' in '/home/git/repositories'". Ignore this and continue.

Now I'm going to initialize my new repository and push it to the remote server.

$ cd marketsim
$ git init .
$ git add .
$ git commit -m "initial commit"
$ git remote add origin git@vps.web-app-host.com:marketsim.git
$ git push origin master
stdin: is not a tty
Initialized empty Git repository in /home/git/repositories/marketsim.git/
Counting objects: 3, done.
Writing objects: 100% (3/3), 209 bytes, done.
Total 3 (delta 0), reused 0 (delta 0)
To git@vps.web-app-host.com:marketsim.git
 * [new branch]      master -> master

Deploying to Server

I've created an account with the username 'marketsi' to host the deployed application (cPanel only allows up to 8 characters for the username). Then I've logged into that account and added my public key via the SSH/Shell Access > Manage SSH Keys section of the cPanel account.

For property deployment you'll need to install the 'Bundler' gem so that the deployment script can install the gems needed for your application. You'll need to install this as 'root' so that the 'bundle' script is available under /usr/bin/bundle.

$ ssh root@vps.web-app-host.com
root@vps [~]# gem install bundler
Fetching: bundler-1.0.21.gem (100%)
Successfully installed bundler-1.0.21
1 gem installed
Installing ri documentation for bundler-1.0.21...
Installing RDoc documentation for bundler-1.0.21...
root@vps [~]# which bundle
/usr/bin/bundle

I've modified my deploy.rb file for my Rails application like so:

require "bundler/capistrano"
load "deploy/assets"

#############################################################
# Settings

set :application, "marketsim"
default_run_options[:pty] = true  # Must be set for the password prompt from git to work
set :use_sudo, false

set :user, "marketsi"  # The server's user for deploys
set :deploy_to, "/home/#{user}/rails"
set :ssh_options, { :forward_agent => true }

set :domain, "marketsim.org"
server domain, :app, :web
role :db, domain, :primary => true

#############################################################
# Git

set :scm, :git
set :repository,  "git@vps.web-app-host.com:marketsim.git"
set :branch, "master"
set :deploy_via, :remote_cache

#############################################################
# Passenger

namespace :passenger do
  desc "Restart Application"
  task :restart do
    run "touch #{current_path}/tmp/restart.txt"
  end
end

after :deploy, "passenger:restart"

Now to run the script to setup the deployment directories on the remote server.

cap deploy:setup

This created a folder under /home/marketsi/rails with the 'releases' and 'shared' folder. Now I'll actually deploy.

cap deploy

The gems were installed with no issue by Bundler for me. Hopefully the same goes for you.

Passenger

The next step is to configure Apache to serve the Rails application for my domain name. Install the Passenger gem via SSH logged in as root:

gem install passenger

Install Passenger using the Apache module installation command. All dependencies should be found and displayed in green.

passenger-install-apache2-module

At the end of the installation script it provides the Apache configuration settings which you place in httpd.conf. Since we're using cPanel, which over-writes the Apache configuration when the EasyApache system is used to rebuild Apache, PHP, and other modules, place this configuration in /usr/local/apache/conf/includes/pre_main_global.conf.

# /usr/local/apache/conf/includes/pre_main_global.conf
LoadModule passenger_module /usr/lib/ruby/gems/1.8/gems/passenger-3.0.11/ext/apache2/mod_passenger.so
PassengerRoot /usr/lib/ruby/gems/1.8/gems/passenger-3.0.11
PassengerRuby /usr/bin/ruby

Next make a backup of the httpd.conf, run the configuration distiller script, rebuild, and then restart Apache.

cp /usr/local/apache/conf/httpd.conf /usr/local/apache/conf/httpd.conf.bak-modrails
/usr/local/cpanel/bin/apache_conf_distiller --update
/scripts/rebuildhttpdconf
/etc/init.d/httpd restart

The cPanel system makes the Apache Document Root for each account map to /home/username/public_html. Because of this you will need to remove the 'public_html' directory, and then create a symlink from that directory to the 'public' directory for your applications current release:

rm -rf /home/marketsi/public_html/
ln -s /home/marketsi/rails/current/public /home/marketsi/public_html
chown marketsi:nobody public_html/
chmod 750 public_html/

Next add a .htaccess file in your application under the 'public' folder, and make sure it contains 'RailsBaseURI /', as well as a directive with the PassengerAppRoot.

RailsBaseURI /
PassengerAppRoot /home/marketsi/rails/current

MySQL Database

If your application returns an error page 'We're sorry, but something went wrong.', check the production.log file on the server. In my case, the application was running, but it couldn't connect to the database with the existing database.yml settings for production.

As cPanel controls the MySQL databases and usernames, you'll have to create a database manually via the cPanel, create the user and assign all privileges to it for the database, and then configure your database.yml appropriately.