Skip to content

Running Locally without Docker

*Note: This setup method is not recommended. To ensure a consistent environment, please check out the Docker Setup Guide.

~/$ brew install libmaxminddb automake pkg-config libtool libffi gmp python3.7 openssl libvips libvips-dev libvips-tools
~/$ git clone
~/$ cd web/app
~/web/app$ cp app/local.env app/.env

You will need to edit the app/.env file with your local environment variables. Look for config items that are marked # required.

If you plan on using the Github and/or Google integration, please read the third party integration guide.

Static Asset Handling (optional)

If you're testing in a staging or production style environment behind a CDN, pass the DJANGO_STATIC_HOST environment variable to your django web instance specifying the CDN URL.

For example:


Setup Database

PostgreSQL is the database used by this application. Here are some instructions for installing PostgreSQL on various operating systems.




Once you have Postgres installed and running on your system, enter into a Postgres session.

# For linux users
~/$ sudo -u postgres psql

# For macOS users
~/$ psql -d postgres

Create the database and a new privileged user.

CREATE USER gitcoin_user WITH PASSWORD 'password';
CREATE DATABASE gitcoin WITH OWNER gitcoin_user;

Exit Postgres session

~/$ \q

Update ~/web/app/app/.env with the connection details, if required.


Setup Dependencies and Startup Server

Setup Virtual Environment with Necessary Dependencies

~/web$ virtualenv -p python3.7 gcoin
~/web$ source gcoin/bin/activate
~/web$ pip3 install -r requirements/test.txt

Alternatively, if any installation errors occur:

*Note: A single error will stop the entire installation process when installing from a requirements file, this will install each module one at a time keeping installation failures isolated

~/web$ awk '!/^(-r)/' requirements/prod.txt requirements/test.txt | xargs -n 1 pip3 install

Startup Server

~/web/app$ ./ migrate
~/web/app$ ./ createcachetable
~/web/app$ ./ get_prices
~/web/app$ ./ runserver

Navigate to http://localhost:8000/.

Create Django Admin

~/web/app$ ./ createsuperuser

Optional: Import bounty data from web3 to your database

This can be useful if you'd like data to test with:

or equivalently:

~/web/app$ ./ sync_geth rinkeby -20 99999999999