Administration/Self-Host

If you're looking to self host an ohmage server, look no further! While our partners on the Mobilize project have been nice enough to offer a free sandbox server for use, if you project plans are lofty or you'd just like the stability of hosting ohmage on your own you can get it up and running in minutes on a linux server in your datacenter or in the cloud!



Vagrant

apt-get

Chef (beta)

Instructions

Vagrant

A super fast way to get an ohmage environment for testing! Install vagrant, grab this box and just type 'vagrant up'. This is extremely suitable for a fast testing/development environment.


Chef (beta)

If you're a fan of infrastructure automation, this method is probably for you. Please note that at this time this method is still heavily in development. The project maintainer would love to be contacted with questions, comments or requests to replicate this process with other infrastructure automation tools!


Ubuntu/Debian packages

Jeroen Ooms has been nice enough to provide us apt packages to use for installation. The commands below are all you need to get started on a debian/ubuntu system.


sudo apt-get install python-software-properties
sudo add-apt-repository ppa:opencpu/ohmage-2.16
sudo apt-get update
sudo apt-get install ohmage-server

Instructions

If you'd prefer to install our packages on your own, feel free! Below are the basic steps/dependencies you'll need to resolve for ohmage server to run!


ohmage needs only java, tomcat and mysql to work! We've done the majority of our testing/support on Ubuntu LTS releases (12.04 and 14.04) though, so you may want to start there. If you'd like the 'express' version, we support a chef cookbook for ohmage on the supermarket! If you're really ready to go it alone, check out the quickstart steps below:

  1. install java, tomcat and mysql
  2. download/compile the ohmage server project
  3. copy the resulting war file to tomcat's webapp directory
  4. run the db prep scripts from the `db` directory in the ohmage server source
  5. create a simple /etc/ohmage.conf file with this db information
  6. restart tomcat

Now, it's likely you'll want to add some/all of the frontend clients you've seen on this site. Take a look at the projects to see if they need to be compiled and start serving the static pages with your favorite web server (we really like nginx, for obvious reasons)! Note that these projects may expect ohmage to be running at /app.