Skip to content
This repository has been archived by the owner on Mar 27, 2022. It is now read-only.

Installation

Jump to bottom
Tim Morgan edited this page Mar 21, 2016 · 101 revisions

Hardware Requirements

OneBody needs to be installed on a server with at least 1 GB of memory and enough free disk space to accommodate your community's needs. We recommend at least 1 GB of disk space per 100 users, but your needs may be different. (The user database is usually quite small, but documents and photos can take up a lot of disk space, so plan accordingly.)

Unfortunately, OneBody cannot be installed on "shared hosting" due to the very specific software requirements. You'll need a dedicated server or Virtual Private Server (VPS) to get everything running. We recommend DigitalOcean, Amazon EC2, or your own in-house hardware.

Install

We have many different ways to install OneBody, based on your expertise/needs. Choose your own path:

Method Difficulty Time Needed Advantage
Automated DigitalOcean Installer Easy ~ 10mins Just two clicks
[[Debian/Ubuntu Package Install Deb Package (Debian and Ubuntu)]] EXPERIMENTAL Moderate ~ 15mins
[[Amazon EC2 (AMI) Amazon AMI]] Moderate ~ 15mins
[[OVF (VirtualBox/VMWare) Virtual Appliance]] Moderate ~ 15mins*
[[Manual Manual Installation]] Advanced ~ 1hr
[[Capistrano Deployment with Capistrano]] Advanced ~ 30mins

*not counting the time to download the file

If you're not sure which way to go, or if you have any trouble, join the Slack chat or post to the Google Group and ask for help!

Next Steps

How to Upgrade

Based on how you chose to install OneBody, there is a different method for how you should go about upgrading your installation.

Installation Method How to Upgrade
Debian/Ubuntu Package apt-get update && apt-get install onebody and follow on-screen instructions (if any)
DigitalOcean installer on or after March 21, 2016 apt-get update && apt-get install onebody and follow on-screen instructions (if any)
DigitalOcean installer prior to March 21, 2016 instructions for manually upgrading
Amazon EC2 AMI instructions for manually upgrading
Virtual Appliance (OVF) instructions for manually upgrading
Manual install instructions for manually upgrading
Capistrano cap deploy :-)

Alternatively, if you'd rather install OneBody from a fresh download (using any of the techniques at the top of this page), you can then Upgrade by Copying Data from your old install to the new one.

Clone this wiki locally