Quick Start

This is a brief guide on how to get up and running. Pogo needs Postgres and Golang to run, pgAdmin is recommended as an optional extra.

1. Choose your OS

Follow the instructions on how to install these prerequisites for your operating system: Linux, OS X or Windows.

Linux

Use the command line to grab the latest versions of Golang, Postgres and pgAdmin:

  1. sudo add-apt-repository ppa:evarlast/golang1.5 ; sudo apt-get install golang-go
  2. export GOPATH=~/gocode ; go get github.com/lib/pq
  3. sudo apt-get install postgresql-9.4 pgadmin3

OS X

Download and install the latest versions of:

  1. Golang (1.5 at time of writing)
  2. Postgres.app (9.4 at time of writing)
  3. pgAdmin3 (A GUI for Postgres - handy but not required)

Then in a terminal window:

  1. export GOPATH=~/gocode (Specifies the path to Go libraries)
  2. go get github.com/lib/pq (Postgres library for Go)

Launch Postgres.app, and try running psql in the terminal window. If you get the response "command not found", you'll need to add psql to your path.


Windows

Download and install the latest versions of:

  1. Golang (1.5 at time of writing)
  2. PostgreSQL (9.4.4 at time of writing)

Then on the command line:

  1. set GOPATH=c:\Go\gocode
  2. go get github.com/lib/pq

2. Get Pogo!

Pogo is easy to install, simply download it as a zip file (latest version 1.7.2) and extract it as a folder called pogocore into the root directory of your project. A Pogo application should have one other directory in the root folder which contains all your applications files, typically called app.

This is a standard directory structure for a pogo project:

Typical Pogo Directory Structure

You should never have to edit the contents of the pogocore folder

What Next?

Now that you've installed Pogo, check out our tutorial that teaches you how to build a basic Todo app. Alternatively, you can check out the documentation and just dive in!