Commit 6857dc97 authored by Shilo B's avatar Shilo B
Browse files


parent 508a5ab9
# Peppermint Runner [![Build Status](](
Source of truth integrator for [Peppermint](
## Architecture
See [Peppermint](
## Running
### Quick set up
- Install docker-compose
- Clone [Peppermint]( and this repo under the same directory.
- Run using [Peppermint's docker-compose.yml]( `docker-compose up`
The runner will start harvesting 'crawling' the Datacrate directory specified in [config.docker.json](
### Running using Docker without docker-compose
Run `docker run --rm -v <path to datacrate directory>/:<path specified as 'source' in config file> -v <host config file>:/opt/peppermint-runner/config.json -e "RUN_AS_CRON=true" [ if peppermint target is a docker instance: --network=<network name>] qcifengineering/peppermint-runner:latest`.
E.g. `docker run --rm -v /mnt/data/publication/public/:/mnt/data/publication/public/ -v /home/vagrant/source/peppermint-runner/config.docker.json:/opt/peppermint-runner/config.json -e "RUN_AS_CRON=true" --network=peppermint_default qcifengineering/peppermint-runner:latest`
### Running as standalone, without Peppermint, Docker, etc.
- Perform 'Developing' quick set up below
- Run `node index.js` or `node index.js --config <path to config>`
## Customising
- Edit config.json
- Edit crontab
## Developing
### Quick set up
- Clone branch you are developing against (e.g. master)
- Install [Node]( version 10.15
- Install [Yarn](
- Run `yarn install`
- After making changes, run `npm run-script compile` if you don't have editor that supports `tsconfig.json`.
- Follow 'Running as standalone' above
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment