Dockerized PostgreSQL and Django for Local Development
Docker and docker-compose make it dead simple to avoid dependency hell and have a consistent environment for your whole team while doing local development. This post walks through setting up a new Django project from scratch to use Docker and docker-compose. It is modeled after a previous post that I wrote about doing a similar thing with Laravel and MySQL.
Dockerfile
Nothing too interesting happening here. Installing python and pip.FROM ubuntu:16.04system update
RUN apt update RUN apt upgrade -y
python deps
RUN apt install -y python3-dev python3-pip
docker-compose.yml
version: '2'
services:
app:
build: .
ports:
- "8000:8000"
volumes:
- .:/app
working_dir: /app
command: bash -c "pip3 install -r requirements.txt && python3 manage.py migrate && python3 manage.py runserver 0:8000"
depends_on:
- db
db:
image: postgres:9.6.5-alpine
environment:
- POSTGRES_USER=feedread
- POSTGRES_PASSWORD=feedread
volumes:
- ./data:/var/lib/postgresql/data
ports:
- "5432:5432"
docker-compose up. Each time the app starts it will install the latest dependencies, run migrations, and start serving the app on localhost:8000Notes
- In order to do stuff with the database locally you should add the following record to your local /etc/hosts file
# /etc/hosts
127.0.0.1 db
- Since we define -
.:/appas a volume, this means that all of your local changes are immediately visible in the dockerized app. - If you need to access the running app or db container you can do so with
docker-compose exec app bashordocker-compose exec db bash. - This docker-compose file is not really suitable for production since it is not likely that you would want to build the container each time the app starts or automatically run migrations.
- You can add additional services like memcached, a mail server, an app server, a queue, etc., using the same method that we are using above with our database.
Thank you for reading! Share your thoughts with me on bluesky, mastodon, or via email.
Check out some more stuff to read down below.
Most popular posts this month
- SQLite DB Migrations with PRAGMA user_version
- Microblog
- Setting up ANTLR4 on Windows
- How to Disable Wayland in Debian Testing
- Programming
Recent Favorite Blog Posts
This is a collection of the last 8 posts that I bookmarked.
- The contagion of fear from The Observation Deck
- The revolt of the reader from The Observation Deck
- Deeper dive: Were Touch Bar’s problems software rather than hardware? from Unsung
- Joining Cursor from Fatih Arslan
- Pluralistic: Digital sewer socialism (08 Aug 2026) from Pluralistic: Daily links from Cory Doctorow
- Pluralistic: Enshittification and Reverse Centaurs go global (29 Jul 2026) from Pluralistic: Daily links from Cory Doctorow
- AI Mania Is Eviscerating Global Decision-Making from Ludicity
- The default person from https://popagandhi.com/
Articles from blogs I follow around the net
“From digital mischief to outright destruction”
The 1980s and 1990s PC viruses were a special breed. The MS-DOS operating system wasn’t particularly secure – few home computer operating systems were back then – so viruses could spread quickly, and many did. Some of the viruses focused more on actually w...
via Unsung November 11, 2026The villa of Ormen
As a child, I was never a fan of any actor or singer. David Bowie is the closest thing to a “music idol” I’ve ever had. I never had a poster of him on my wall, or a T-shirt with his face on it, but he was a constant presence in my playlists, to the point w...
via Personal Site of Andrei N. Ciobanu November 11, 2026Candidate Statement for the 2026 W3C TAG Election
Group photo of the W3C TAG in July 2022 with me to the left of Sir Tim Berners-Lee (inventor of the Web and TAG chair emeritus). Photo credit: Dan Appelquist I had the great honor of being elected to the TAG by the W3C membership in 2020 and again in 2022,...
via Lea Verou’s blog November 11, 2026Generated by openring