Skip to content

Installing and Running Overview

Jump to bottom
Jonathan Stray edited this page Apr 24, 2014 · 31 revisions

Installing on Windows 8

...working on it...

Installing on Mac OS X

First you will need the Postgres database software. The easiest way is to download and install from http://postgresapp.com

Next you will also need Java 7 installed. Get that here http://www.java.com/en/download/index.jsp

Then download the latest release of overview-server-YYYYMMDDRR.zip from https://github.com/overview/overview-server/releases.

Unzip it, and open a terminal window in the directory where all of the files are unzipped. You will need to cd into this directory.

Then type ./run. The server is ready when you see the following message:

 [overview-server] [info] play - Application started (Prod)
 [overview-server] [info] play - Listening for HTTP on /0:0:0:0:0:0:0:0:9000

Open your web browser and go to localhost:9000. You should see a login screen! Login with the default username and password of [email protected] and you are done!

Installing on Ubuntu Linux

Warning We support Overview on Ubuntu Linux 14.04 LTS and above. (Really, we support any distribution that includes Postgresql 9.3 or above.) Older versions of Postgresql might not work perfectly.

First, download the latest release of overview-server-YYYYMMDDRR.zip from https://github.com/overview/overview-server/releases. Done? Now you have two ways to install it.

On the command-line

Just run this:

sudo apt-get install openjdk-7-jre-headless postgresql
unzip /path/to/overview-server-YYYYMMDDRR.zip
cd overview-server-YYYYMMDDRR
./run

Leave that running, browse to http://localhost:9000 and log in as [email protected] with password [email protected].

To quit, press Ctrl+C where ./run is running. Don't worry: your data is safe no matter when you quit.

Without the command-line

  1. Using Ubuntu Software Center, install openjdk-7-jre-headless and postgresql.
  2. Move overview-server-YYYYMMDDRR.zip somewhere where you know you can find it again.
  3. Right-click on overview-server-YYYYMMDDRR.zip and click Extract here.
  4. Double-click on the new overview-server-YYYYMMDDRR folder.
  5. Wait for the colorful text to stop scrolling in the terminal that pops up.
  6. Browse to http://localhost:9000 and log in as [email protected] with password [email protected].

To quit, close the terminal. Don't worry: your data is safe no matter when you quit.

Upgrading (on all operating systems)

Want to download a new version? Download it from https://github.com/overview/overview-server/releases and then:

  1. Quit the old version of Overview.
  2. Extract the new version (probably near where you extracted the old version).
  3. Copy the database folder from the first overview-YYYYMMDDRR folder into the second overview-YYYYMMDDRR folder.
  4. Copy the data subfolder of the search-index folder from the first overview-YYYYMMDDRR folder into the second overview-YYYYMMDDRR folder's search-index subfolder. (Got that? You're copying overview-server-1111111111/search-index/data so it becomes overview-server-2222222222/search-index/data.)
  5. Run the new version of Overview.
Clone this wiki locally