InstallOneBody

All instructions assume you’ll be installing on Ubuntu Linux. Other distributions of Linux should work, but the commands (especially for installing prerequisites) will be different.

You can either install OneBody on your own in-house server, on a server you control somewhere else, or on a virtual private server (VPS). See our RecommendedWebHosts.

A traditional shared web host will probably not give you the control needed to get OneBody up and running, but some have had success.

Prerequisites

sudo aptitude install ruby irb1.8 rake rdoc1.8 ruby1.8-dev mysql-server postfix courier-pop libmysql-ruby1.8 build-essential imagemagick apache2 apache2-threaded-dev apache2-mpm-worker apache2-threaded-dev libxml2-dev libxslt1-dev libcurl4-gnutls-dev libhttp-access2-ruby1.8 rsync

If you prefer to use SQLite for your database instead of MySQL:

sudo aptitude install libsqlite3-ruby1.8

The version of RubyGems shipped with Ubuntu is broken. It’s best to download and install from source:

cd /tmp
wget http://rubyforge.org/frs/download.php/60718/rubygems-1.3.5.tgz
tar xzvf rubygems-1.3.5.tgz
cd rubygems
sudo ruby setup.rb
sudo ln -sf /usr/bin/gem1.8 /usr/bin/gem
gem -v # should output 1.3.5

Download

Via Git

mkdir -p /var/www/apps
cd /var/www/apps
git clone git://github.com/seven1m/onebody.git
git checkout stable

Via Tarball

Alternatively, you may download OneBody as a tarball here.

Dependencies

sudo rake gems:install

Setup

Via “Setup Mode”

ruby script/server -e setup

Browse to http://server:3000 (replace “server” with the name or IP of your server) to finish getting everything set up. Things to do:

1. Configure your database.
2. Enter ServiceAPIKeys

Via Command Line

If you’re unable to run setup mode, you can setup your database with this command:

rake db:migrate RAILS_ENV=production

Next steps:

1. Set up your web server (we recommend Phusion Passenger on Apache)
2. EmailSetup
3. CrontabSetup
4. UpdateAgent
5. Customize your site’s Settings

It’s also good to know about the OneBody RakeTasks.

Upgrade

Fist, BACKUP your database in case a migration goes berserk! No one is responsible for destroying your data except yourself. DatabaseBackups

Be sure to check the CHANGELOG for any release-specific notes/instructions. If upgrading from an 0.7.x version to 0.8.x, you first need to upgrade to 0.7.8 and run all the migrations.

If you downloaded via Git:

git fetch --tags && git co stable

If you downloaded via tarball, you’ll need to download the latest version and update your local files.

It may also be necessary to run sudo rake gems:install after upgrading.

And finally, run the database migrations (you backed up, right?): rake db:migrate.