Set up

Quick

Quick set up can be done with docker-compose up

You would need docker-compose and docker for that.

Long

To set up this you will need

• RabbitMQ
• Postgres
• python3 - this works on python3.6 and probably won't work on other versions, but you can try
• (Optional) nodejs environment to build frontend

RabbitMQ

Install with the credentials from https://github.com/c0rvax/project-black/blob/master/config/config.yml

Postgres

Install with the credentials from https://github.com/c0rvax/project-black/blob/master/config/config.yml

Install Python3

Install that for your architecture (3.6 and 3.7 seem to be OK).

Example setup for Ubuntu:

sudo apt-get update
sudo apt-get install -y software-properties-common
sudo add-apt-repository ppa:jonathonf/python-3.6
sudo apt-get update

sudo apt install -y \
    build-essential \
    python3.6 \
    python3.6-dev \
    python3-pip

sudo python3.6 -m pip install --upgrade pip

Next install dependencies from https://github.com/c0rvax/project-black/blob/master/requirements.txt

sudo python3.6 -m pip install -r requirements.txt

Install nodejs

Goto app/ and run

npm i
npm run dev

Run python server

In the main app directory run python3 server.py

Run amass worker

In the main app directory run python3 spawn_worker.py amass

Troubleshooting

Docker not found

If docker is not found, do

sudo curl -sSL https://get.docker.com/ | sh

Not authenticated

Some browsers like Firefox ESR (which is default in Debian, at least in my Debian) does not support Basic Authentication for some reason. In such cases please try diffrnet browser, for example, Chrome, Firefox or Safari.