Installation

Installing Molehill with Docker

Molehill is distributed on dockerhub. Pull it with:

docker pull molescrape/molehill:0.0.1-alpha

Configuration is done through environment variables that you need to pass to the container on startup:

docker run --env MOLEHILL_DB_HOST=localhost \
    --env MOLEHILL_DB_DATABASE=molescrape \
    --env MOLEHILL_DB_USERNAME=molescrape \
    --env MOLEHILL_DB_PASSWORD=secret \
    molescrape/molehill

Installing Molehill with Ansible (on Debian)

There is an ansible role to install molehill on a Debian server. You call install it with ansible-galaxy from our github repository with the following requirements.yml:

- name: molehill-debian
  src: git+https://github.com/molescrape/ansible-molehill-debian.git

Note

Defining the name manually is required, because currently ansible-galaxy does not consider role_name from the role definition when using Git URLs.

Then you can install the role with ansible-galaxy install -r requirements.yml.

To deploy the role to a server you need to create a playbook:

- hosts: molescrape-web
  vars_files:
    - "vars/molescrape_molehill.yml"
  roles:
    - molehill-debian

In the file vars/molescrape_molehill.yml you define your configuration for this role:

molehill_port: 8080
molehill_db_host: 127.0.0.1
molehill_db_username: molescrape
molehill_db_password: my-secret
molehill_db_database: molescrape

Installing Molehill from Sources

Molehill is an Erlang project and can be built and run with rebar3. Clone the repository from github:

git clone https://github.com/molescrape/molehill.git

You can compile and run this project with rebar3:

rebar3 compile

Configuration is done through environment variables:

export MOLEHILL_DB_HOST=localhost
export MOLEHILL_DB_DATABASE=molescrape
export MOLEHILL_DB_USERNAME=molescrape
export MOLEHILL_DB_PASSWORD=secret

When running Molehill outside a docker container you can also configure the port to which Molehill should listen:

export MOLEHILL_PORT=9000

After setting the configuration you can run it with:

rebar3 shell