- Before you get off to such a quick start, go ahead and
- Create a fork from augur starting at https://github.com/chaoss/augur
- Clone that fork locally
- Checkout the appropriate branch to work on (see notes below):
git checkout dev
- Usually, we'll have you checkout the dev branch.
- Make sure to install all the pre-requisites here: https://oss-augur.readthedocs.io/en/main/getting-started/installation.html#dependencies
Note
Quick Start:
If you want to start running docker against an external database right away:
- Follow the instructions to create a database, and database user (if you have just installed Postgresql locally, you may need to follow instructions to allow access to Postgresql from Docker on the next page. tl;dr, there are edits to the Postgresql pg_hba.conf and postgresql.conf files):
CREATE DATABASE augur;
CREATE USER augur WITH ENCRYPTED PASSWORD 'password';
GRANT ALL PRIVILEGES ON DATABASE augur TO augur;
- Install Docker and docker-compose. If you're not familiar with Docker, their starting guide is a great resource.
- Create a file to store all relevant enviroment variables for running docker. Below is an example file. This file should be named
.env`
AUGUR_GITHUB_API_KEY=xxxxxxxxxxxxxxxxxxxxxxx AUGUR_GITHUB_USERNAME=usernameGithub AUGUR_GITLAB_API_KEY=xxxxxxxxxxxxxxxxxxxxxxx AUGUR_GITLAB_USERNAME=usernameGitlab AUGUR_DB=yourDBString
- Execute the code from the base directory of the Augur repository:
sudo docker build -t augur-docker -f docker/backend/Dockerfile .
sudo docker-compose up