1.5 KB


A django backed record distro

Getting Started


Clone the latest from the master branch in the git repository.

$ git clone

I am using virtualenv to manage my python environment and pip to manage my dependencies. Django and all the dependencies work with python 2 or 3, but I've chosen to go with 3 for this project.

$ cd ddistro
$ virtualenv -p python3 env
$ source env/bin/activate
$ pip install -r requirements.txt

First time setup will involve a migration and creating a superuser. Then it should be all set up and ready to run the server.

$ cd ddistro
$ python migrate
$ python createsuperuser

Assets are managed by webpack, to allow for compilation of SASS and processing of Javascript files. I am using nvm to manage my node environment, and we will install required files from npm.

$ nvm use stable
$ npm install

For the next step we will need to have two terminal windows running. One to run the Django server, and one to watch and compile the webpack sources. I use tmux to run these all in one terminal window.

In terminal 1

$ npm run watch

In terminal 2

$ python runserver


  • Create production config for webpack [blog] [docs]