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

Installation

Tim Morgan edited this page Feb 9, 2017 · 101 revisions

Hardware Requirements

Resource Minimum
Memory (RAM) 1 GiB
Disk Space 1 GiB per 100 users*
Shell Access Root

*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
DigitalOcean Installer Easy ~ 10mins Just two clicks
[[Deb Package Install Deb Package (Debian and Ubuntu)]] 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

*Plus the time it takes to download a 1 GiB 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 / Amazon EC2 AMI / Virtual Appliance (OVF) if `dpkg -s onebody
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.

If you installed using the DigitalOcean installer prior to March 21, 2016, you may wish to convert your install to use the Debian/Ubuntu package, which will make future upgrades much easier.