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

Clone the Django Packages project using git:

git clone
cd djangopackages

Set up the development environment

In order to run the project, you first 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

Build Docker container

Now build the project using docker-compose:

docker-compose -f dev.yml build

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.