Do everything listed in this section to get your site up and running locally. If you run into problems, see the Troubleshooting section.


You need to install Docker and docker-compose.

Main instructions

These instructions install Django Packages on your computer, using Docker.

Git clone the project and build Docker container

Clone the Django Packages project using git, and build the project using docker-compose:

git clone
cd djangopackages
docker-compose -f dev.yml build

Set up the development environment

In order to run the project, you need to add a file called .env.local. The file holds all the configurable settings and secrets to run properly.

There’s an example file available. To get started, copy the file:

cp .env.local.example .env.local

Running the project

To start the project, run:

docker-compose -f dev.yml up

Then point your browser to http://localhost:8000 and start hacking!

Give yourself an admin account on the site

Create a Django superuser for yourself, replacing joe with your username/email:

docker-compose -f dev.yml run django python createsuperuser --username=joe

And then login into the admin interface (/admin/) and create a profile for your user filling all the fields with any data.