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

The old “setup mode” plugin is no longer installed by default. If you need it, check out the onebody-setup project.

OneBody uses sqlite database by default, but you can switch to MySQL by editing the config/database.yml file. Migrate the database with the 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

First, 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.