vervis/INSTALL.md

Vervis is still in early development. These instructions may be incomplete
and/or slightly outdated. At the time of writing, you can get a running Vervis
instance if you follow the steps below.

Install Darcs, GHC 7.10.3 and a recent `stack` version.

Download the Vervis repo:

    $ darcs clone http://hub.darcs.net/fr33domlover/vervis
    $ cd vervis

Check in `stack.yaml` near the top which extra repos are required. At the time
of writing, there are 4 of them (`hit-harder`, `hit-graph`, `hit-network` and
`ssh`). Then clone them. For example:

    $ darcs clone http://hub.darcs.net/fr33domlover/ssh

Update `stack.yaml` to specify that path in the `packages` section:

    $ vim stack.yml

Generate a new SSH key with a blank password:

    $ ssh-keygen -t rsa -f config/ssh-host-key

Install PostgreSQL. You'll need the server and the client library development
files.

    $ sudo apt-get install postgresql # TODO see exactly which pages are needed

Create a new PostgreSQL user and a new database.

    $ #TODO take this from the vervis ticket I wrote...

Update `stack.yaml` to specify correct database connection details.

    $ vim stack.yaml

Build.

    $ stack build --flag vervis:dev

Run.

    $ stack exec vervis

Browse to `http://localhost:3000` and have fun.