Docker Compose Full Stack

DeployMart v1.0: Build a Full-Stack Multi-Domain App with Docker Compose

You are building a shopping mall. One main entrance. One security guard. Inside: a warehouse for inventory, a showroom for customers, and a vault for records. Every visitor goes through the same door but ends up exactly where they need to be.

What You Will Build

By the end of this module, you will have a complete production-like application called DeployMart — an e-commerce platform running entirely inside Docker Compose on your local machine. It includes:

All five services start with one command: docker compose up -d.

Architecture Overview

Traffic Flow:

1. User visits api.deploymart.local → Nginx → Django API (port 8000 internal)
2. User visits app.deploymart.local → Nginx → Next.js (port 3000 internal)
3. Static assets (CSS, JS, images) → Nginx serves directly from disk
4. Django talks to PostgreSQL and Redis through the internal backend network
5. PostgreSQL and Redis are unreachable from the internet

Project Structure

deploymart/
├── docker-compose.yml          # Orchestrates all 5 services
├── .env                        # Secrets (NEVER commit this)
├── .env.example                # Template for other developers
├── .gitignore
├── nginx/
│   ├── nginx.conf              # Main Nginx config
│   └── conf.d/
│       └── default.conf        # Virtual hosts
├── django/
│   ├── Dockerfile              # Multi-stage production build
│   ├── requirements.txt
│   ├── manage.py
│   └── deploymart/
│       ├── __init__.py
│       ├── settings.py
│       ├── urls.py
│       ├── wsgi.py
│       └── apps/
│           ├── products/
│           ├── orders/
│           └── users/
└── nextjs/
    ├── Dockerfile              # Standalone output build
    ├── package.json
    ├── next.config.js
    └── src/
        ├── app/
        │   ├── page.tsx
        │   ├── layout.tsx
        │   └── api/
        └── components/

Step 1: Environment Configuration

.env (Add to .gitignore)

bashCopy
1# Database
2DB_NAME=deploymart
3DB_USER=deploymart_user
4DB_PASSWORD=super_secret_password_2024
5DB_HOST=postgres
6DB_PORT=5432
7
8# Django
9DJANGO_SECRET_KEY=django-insecure-dev-only-change-in-production
10DJANGO_DEBUG=True
11DJANGO_ALLOWED_HOSTS=api.deploymart.local,localhost,127.0.0.1
12
13# Redis
14REDIS_URL=redis://redis:6379/0
15
16# Next.js
17NEXT_PUBLIC_API_URL=http://api.deploymart.local

.env.example (Commit this)

bashCopy
1DB_NAME=deploymart
2DB_USER=deploymart_user
3DB_PASSWORD=changeme
4DB_HOST=postgres
5DB_PORT=5432
6DJANGO_SECRET_KEY=changeme
7DJANGO_DEBUG=True
8DJANGO_ALLOWED_HOSTS=api.deploymart.local,localhost
9REDIS_URL=redis://redis:6379/0
10NEXT_PUBLIC_API_URL=http://api.deploymart.local

.gitignore

gitignoreCopy
1.env
2__pycache__/
3*.pyc
4*.pyo
5*.pyd
6.Python
7*.sqlite3
8node_modules/
9.next/
10*.log
11.DS_Store

Step 2: Django API Backend

django/Dockerfile

dockerfileCopy
1# ============================================
2# STAGE 1: Builder
3# ============================================
4FROM python:3.12.4-slim AS builder
5
6ENV PYTHONDONTWRITEBYTECODE=1 \
7    PYTHONUNBUFFERED=1 \
8    PIP_NO_CACHE_DIR=1
9
10WORKDIR /app
11
12RUN apt-get update && apt-get install -y --no-install-recommends \
13    build-essential \
14    libpq-dev \
15    && rm -rf /var/lib/apt/lists/*
16
17RUN python -m venv /opt/venv
18ENV PATH="/opt/venv/bin:$PATH"
19
20COPY requirements.txt .
21RUN pip install --upgrade pip && \
22    pip install -r requirements.txt
23
24# ============================================
25# STAGE 2: Production
26# ============================================
27FROM python:3.12.4-slim AS production
28
29ENV PYTHONDONTWRITEBYTECODE=1 \
30    PYTHONUNBUFFERED=1 \
31    PATH="/opt/venv/bin:$PATH"
32
33RUN apt-get update && apt-get install -y --no-install-recommends \
34    libpq5 \
35    curl \
36    && rm -rf /var/lib/apt/lists/*
37
38RUN groupadd -r django && useradd -r -g django django
39
40WORKDIR /app
41
42COPY --from=builder /opt/venv /opt/venv
43COPY --chown=django:django . .
44
45RUN python manage.py collectstatic --noinput
46
47USER django
48
49EXPOSE 8000
50
51HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \
52    CMD curl -f http://localhost:8000/health/ || exit 1
53
54CMD ["gunicorn", \
55     "--bind", "0.0.0.0:8000", \
56     "--workers", "4", \
57     "--worker-class", "uvicorn.workers.UvicornWorker", \
58     "--access-logfile", "-", \
59     "--error-logfile", "-", \
60     "deploymart.asgi:application"]

django/requirements.txt

Django==5.0.6
djangorestframework==3.15.1
django-cors-headers==4.3.1
django-redis==5.4.0
psycopg2-binary==2.9.9
gunicorn==23.0.0
uvicorn[standard]==0.30.1
python-dotenv==1.0.1

django/deploymart/settings.py

pythonCopy
1import os
2from pathlib import Path
3from dotenv import load_dotenv
4
5load_dotenv()
6
7BASE_DIR = Path(__file__).resolve().parent.parent
8
9SECRET_KEY = os.getenv('DJANGO_SECRET_KEY')
10DEBUG = os.getenv('DJANGO_DEBUG', 'False').lower() == 'true'
11ALLOWED_HOSTS = os.getenv('DJANGO_ALLOWED_HOSTS', '').split(',')
12
13INSTALLED_APPS = [
14    'django.contrib.admin',
15    'django.contrib.auth',
16    'django.contrib.contenttypes',
17    'django.contrib.sessions',
18    'django.contrib.messages',
19    'django.contrib.staticfiles',
20    'rest_framework',
21    'corsheaders',
22    'deploymart.apps.products',
23]
24
25MIDDLEWARE = [
26    'corsheaders.middleware.CorsMiddleware',
27    'django.middleware.security.SecurityMiddleware',
28    'django.contrib.sessions.middleware.SessionMiddleware',
29    'django.middleware.common.CommonMiddleware',
30    'django.middleware.csrf.CsrfViewMiddleware',
31    'django.contrib.auth.middleware.AuthenticationMiddleware',
32    'django.contrib.messages.middleware.MessageMiddleware',
33    'django.middleware.clickjacking.XFrameOptionsMiddleware',
34]
35
36ROOT_URLCONF = 'deploymart.urls'
37
38TEMPLATES = [{
39    'BACKEND': 'django.template.backends.django.DjangoTemplates',
40    'DIRS': [],
41    'APP_DIRS': True,
42    'OPTIONS': {
43        'context_processors': [
44            'django.template.context_processors.debug',
45            'django.template.context_processors.request',
46            'django.contrib.auth.context_processors.auth',
47            'django.contrib.messages.context_processors.messages',
48        ],
49    },
50}]
51
52WSGI_APPLICATION = 'deploymart.wsgi.application'
53ASGI_APPLICATION = 'deploymart.asgi.application'
54
55DATABASES = {
56    'default': {
57        'ENGINE': 'django.db.backends.postgresql',
58        'NAME': os.getenv('DB_NAME'),
59        'USER': os.getenv('DB_USER'),
60        'PASSWORD': os.getenv('DB_PASSWORD'),
61        'HOST': os.getenv('DB_HOST'),
62        'PORT': os.getenv('DB_PORT'),
63    }
64}
65
66CACHES = {
67    'default': {
68        'BACKEND': 'django_redis.cache.RedisCache',
69        'LOCATION': os.getenv('REDIS_URL'),
70        'OPTIONS': {
71            'CLIENT_CLASS': 'django_redis.client.DefaultClient',
72        }
73    }
74}
75
76SESSION_ENGINE = 'django.contrib.sessions.backends.cache'
77SESSION_CACHE_ALIAS = 'default'
78
79LANGUAGE_CODE = 'en-us'
80TIME_ZONE = 'UTC'
81USE_I18N = True
82USE_TZ = True
83
84STATIC_URL = '/static/'
85STATIC_ROOT = BASE_DIR / 'staticfiles'
86
87MEDIA_URL = '/media/'
88MEDIA_ROOT = BASE_DIR / 'mediafiles'
89
90DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'
91
92REST_FRAMEWORK = {
93    'DEFAULT_PERMISSION_CLASSES': [
94        'rest_framework.permissions.AllowAny',
95    ],
96    'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.PageNumberPagination',
97    'PAGE_SIZE': 20,
98}
99
100CORS_ALLOWED_ORIGINS = [
101    "http://app.deploymart.local",
102    "http://localhost:3000",
103]
104
105SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')

django/deploymart/urls.py

pythonCopy
1from django.contrib import admin
2from django.urls import path, include
3from django.http import JsonResponse
4
5def health_check(request):
6    return JsonResponse({"status": "healthy", "service": "deploymart-api"})
7
8def ready_check(request):
9    return JsonResponse({"status": "ready"})
10
11urlpatterns = [
12    path('admin/', admin.site.urls),
13    path('health/', health_check, name='health'),
14    path('ready/', ready_check, name='ready'),
15    path('api/products/', include('deploymart.apps.products.urls')),
16]

django/deploymart/apps/products/models.py

pythonCopy
1from django.db import models
2
3class Product(models.Model):
4    name = models.CharField(max_length=255)
5    description = models.TextField(blank=True)
6    price = models.DecimalField(max_digits=10, decimal_places=2)
7    stock = models.PositiveIntegerField(default=0)
8    image = models.URLField(blank=True)
9    created_at = models.DateTimeField(auto_now_add=True)
10    updated_at = models.DateTimeField(auto_now=True)
11
12    class Meta:
13        ordering = ['-created_at']
14
15    def __str__(self):
16        return self.name

django/deploymart/apps/products/serializers.py

pythonCopy
1from rest_framework import serializers
2from .models import Product
3
4class ProductSerializer(serializers.ModelSerializer):
5    class Meta:
6        model = Product
7        fields = ['id', 'name', 'description', 'price', 'stock', 'image', 'created_at']

django/deploymart/apps/products/views.py

pythonCopy
1from rest_framework import viewsets
2from rest_framework.decorators import action
3from rest_framework.response import Response
4from django.core.cache import cache
5from .models import Product
6from .serializers import ProductSerializer
7
8class ProductViewSet(viewsets.ModelViewSet):
9    queryset = Product.objects.all()
10    serializer_class = ProductSerializer
11
12    def list(self, request, *args, **kwargs):
13        cache_key = 'products_list'
14        cached = cache.get(cache_key)
15        if cached:
16            return Response({"source": "cache", "data": cached})
17        
18        response = super().list(request, *args, **kwargs)
19        cache.set(cache_key, response.data, timeout=300)  # Cache 5 minutes
20        return Response({"source": "database", "data": response.data})
21
22    def perform_create(self, serializer):
23        serializer.save()
24        cache.delete('products_list')  # Invalidate cache

django/deploymart/apps/products/urls.py

pythonCopy
1from django.urls import path, include
2from rest_framework.routers import DefaultRouter
3from .views import ProductViewSet
4
5router = DefaultRouter()
6router.register(r'', ProductViewSet)
7
8urlpatterns = [
9    path('', include(router.urls)),
10]

Step 3: Next.js Frontend

nextjs/Dockerfile

dockerfileCopy
1# ============================================
2# STAGE 1: Dependencies
3# ============================================
4FROM node:20-alpine AS deps
5RUN apk add --no-cache libc6-compat
6WORKDIR /app
7COPY package.json package-lock.json* ./
8RUN npm ci
9
10# ============================================
11# STAGE 2: Builder
12# ============================================
13FROM node:20-alpine AS builder
14WORKDIR /app
15COPY --from=deps /app/node_modules ./node_modules
16COPY . .
17ARG NEXT_PUBLIC_API_URL
18ENV NEXT_PUBLIC_API_URL=${NEXT_PUBLIC_API_URL}
19RUN npm run build
20
21# ============================================
22# STAGE 3: Production
23# ============================================
24FROM node:20-alpine AS runner
25WORKDIR /app
26
27ENV NODE_ENV=production \
28    NEXT_TELEMETRY_DISABLED=1
29
30RUN addgroup --system --gid 1001 nodejs && \
31    adduser --system --uid 1001 nextjs
32
33COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
34COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
35COPY --from=builder --chown=nextjs:nodejs /app/public ./public
36
37USER nextjs
38
39EXPOSE 3000
40
41ENV PORT=3000 \
42    HOSTNAME="0.0.0.0"
43
44HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \
45    CMD wget --no-verbose --tries=1 --spider http://localhost:3000/api/health || exit 1
46
47CMD ["node", "server.js"]

nextjs/package.json

jsonCopy
1{
2  "name": "deploymart-web",
3  "version": "1.0.0",
4  "private": true,
5  "scripts": {
6    "dev": "next dev",
7    "build": "next build",
8    "start": "next start"
9  },
10  "dependencies": {
11    "next": "14.2.5",
12    "react": "^18.3.1",
13    "react-dom": "^18.3.1"
14  },
15  "devDependencies": {
16    "@types/node": "^20.14.0",
17    "@types/react": "^18.3.3",
18    "typescript": "^5.4.5"
19  }
20}

nextjs/next.config.js

javascriptCopy
1/** @type {import('next').NextConfig} */
2const nextConfig = {
3  output: 'standalone',
4  images: {
5    unoptimized: true,
6  },
7  poweredByHeader: false,
8  async headers() {
9    return [
10      {
11        source: '/:path*',
12        headers: [
13          { key: 'X-Frame-Options', value: 'SAMEORIGIN' },
14          { key: 'X-Content-Type-Options', value: 'nosniff' },
15          { key: 'Referrer-Policy', value: 'strict-origin-when-cross-origin' },
16        ],
17      },
18    ];
19  },
20};
21
22module.exports = nextConfig;

nextjs/src/app/api/health/route.ts

typescriptCopy
1import { NextResponse } from 'next/server';
2
3export async function GET() {
4  return NextResponse.json({ status: 'healthy', service: 'deploymart-web' });
5}

nextjs/src/app/page.tsx

typescriptCopy
1async function getProducts() {
2  const res = await fetch(`${process.env.NEXT_PUBLIC_API_URL}/api/products/`, {
3    next: { revalidate: 60 },
4  });
5  if (!res.ok) throw new Error('Failed to fetch products');
6  return res.json();
7}
8
9export default async function Home() {
10  const data = await getProducts();
11  const products = data.data || data;
12
13  return (
14    <main className="min-h-screen bg-gray-50 p-8">
15      <h1 className="text-4xl font-bold text-gray-900 mb-8">DeployMart</h1>
16      <p className="text-gray-600 mb-8">Source: {data.source || 'direct'}</p>
17      
18      <div className="grid grid-cols-1 md:grid-cols-3 gap-6">
19        {products?.results?.map((product: any) => (
20          <div key={product.id} className="bg-white rounded-lg shadow-md p-6">
21            <h2 className="text-xl font-semibold text-gray-800">{product.name}</h2>
22            <p className="text-gray-600 mt-2">{product.description}</p>
23            <p className="text-2xl font-bold text-green-600 mt-4">${product.price}</p>
24            <p className="text-sm text-gray-500 mt-1">{product.stock} in stock</p>
25          </div>
26        ))}
27      </div>
28    </main>
29  );
30}

Step 4: Nginx Configuration

nginx/nginx.conf

nginxCopy
1user nginx;
2worker_processes auto;
3error_log /var/log/nginx/error.log warn;
4pid /var/run/nginx.pid;
5
6events {
7    worker_connections 1024;
8    use epoll;
9    multi_accept on;
10}
11
12http {
13    include /etc/nginx/mime.types;
14    default_type application/octet-stream;
15
16    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
17                    '$status $body_bytes_sent "$http_referer" '
18                    '"$http_user_agent" "$http_x_forwarded_for"';
19
20    access_log /var/log/nginx/access.log main;
21
22    sendfile on;
23    tcp_nopush on;
24    tcp_nodelay on;
25    keepalive_timeout 65;
26    types_hash_max_size 2048;
27
28    # Gzip
29    gzip on;
30    gzip_vary on;
31    gzip_proxied any;
32    gzip_comp_level 6;
33    gzip_types text/plain text/css text/xml application/json application/javascript text/javascript;
34
35    include /etc/nginx/conf.d/*.conf;
36}

nginx/conf.d/default.conf

nginxCopy
1# ============================================
2# UPSTREAM DEFINITIONS
3# Docker DNS resolves service names automatically
4# ============================================
5upstream django_backend {
6    server django:8000;
7    keepalive 32;
8}
9
10upstream nextjs_frontend {
11    server nextjs:3000;
12    keepalive 32;
13}
14
15# ============================================
16# HTTP → HTTPS REDIRECT (when SSL is enabled)
17# ============================================
18server {
19    listen 80;
20    server_name api.deploymart.local app.deploymart.local www.deploymart.local;
21    
22    location / {
23        return 301 https://$host$request_uri;
24    }
25}
26
27# ============================================
28# DJANGO API — api.deploymart.local
29# ============================================
30server {
31    listen 80;
32    server_name api.deploymart.local;
33
34    # Security headers
35    add_header X-Frame-Options "SAMEORIGIN" always;
36    add_header X-Content-Type-Options "nosniff" always;
37    add_header X-XSS-Protection "1; mode=block" always;
38    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
39
40    # Django static files
41    location /static/ {
42        alias /app/staticfiles/;
43        expires 6M;
44        access_log off;
45        add_header Cache-Control "public, max-age=15552000";
46    }
47
48    # Django media files
49    location /media/ {
50        alias /app/mediafiles/;
51        expires 1M;
52        access_log off;
53    }
54
55    # API proxy to Django
56    location / {
57        proxy_pass http://django_backend;
58        proxy_set_header Host $host;
59        proxy_set_header X-Real-IP $remote_addr;
60        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
61        proxy_set_header X-Forwarded-Proto $scheme;
62        proxy_set_header X-Forwarded-Host $host;
63        proxy_set_header X-Forwarded-Port $server_port;
64        
65        proxy_connect_timeout 60s;
66        proxy_send_timeout 60s;
67        proxy_read_timeout 60s;
68        
69        proxy_http_version 1.1;
70        proxy_set_header Connection "";
71    }
72}
73
74# ============================================
75# NEXT.JS FRONTEND — app.deploymart.local
76# ============================================
77server {
78    listen 80;
79    server_name app.deploymart.local;
80
81    # Security headers
82    add_header X-Frame-Options "SAMEORIGIN" always;
83    add_header X-Content-Type-Options "nosniff" always;
84    add_header X-XSS-Protection "1; mode=block" always;
85    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
86
87    # Next.js static files (immutable)
88    location /_next/static/ {
89        alias /app/.next/static/;
90        expires 1y;
91        access_log off;
92        add_header Cache-Control "public, immutable";
93    }
94
95    # Public assets
96    location /static/ {
97        alias /app/public/;
98        expires 1y;
99        access_log off;
100        add_header Cache-Control "public, max-age=31536000";
101    }
102
103    # Frontend proxy to Next.js
104    location / {
105        proxy_pass http://nextjs_frontend;
106        proxy_set_header Host $host;
107        proxy_set_header X-Real-IP $remote_addr;
108        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
109        proxy_set_header X-Forwarded-Proto $scheme;
110        
111        proxy_http_version 1.1;
112        proxy_set_header Upgrade $http_upgrade;
113        proxy_set_header Connection "upgrade";
114        
115        proxy_buffering off;
116    }
117}

Step 5: The Complete docker-compose.yml

yamlCopy
1version: "3.9"
2
3services:
4  # ============================================
5  # PostgreSQL Database
6  # ============================================
7  postgres:
8    image: postgres:16-alpine
9    container_name: deploymart-db
10    restart: unless-stopped
11    env_file:
12      - .env
13    environment:
14      POSTGRES_DB: ${DB_NAME}
15      POSTGRES_USER: ${DB_USER}
16      POSTGRES_PASSWORD: ${DB_PASSWORD}
17    volumes:
18      - pgdata:/var/lib/postgresql/data
19    networks:
20      - backend
21    healthcheck:
22      test: ["CMD-SHELL", "pg_isready -U ${DB_USER} -d ${DB_NAME}"]
23      interval: 10s
24      timeout: 5s
25      retries: 5
26      start_period: 30s
27
28  # ============================================
29  # Redis Cache
30  # ============================================
31  redis:
32    image: redis:7-alpine
33    container_name: deploymart-cache
34    restart: unless-stopped
35    volumes:
36      - redis_data:/data
37    networks:
38      - backend
39    healthcheck:
40      test: ["CMD", "redis-cli", "ping"]
41      interval: 10s
42      timeout: 5s
43      retries: 5
44
45  # ============================================
46  # Django API
47  # ============================================
48  django:
49    build:
50      context: ./django
51      dockerfile: Dockerfile
52    container_name: deploymart-api
53    restart: unless-stopped
54    env_file:
55      - .env
56    volumes:
57      - django_static:/app/staticfiles
58      - django_media:/app/mediafiles
59    networks:
60      - backend
61      - frontend
62    depends_on:
63      postgres:
64        condition: service_healthy
65      redis:
66        condition: service_healthy
67    healthcheck:
68      test: ["CMD", "curl", "-f", "http://localhost:8000/health/"]
69      interval: 30s
70      timeout: 10s
71      retries: 3
72      start_period: 40s
73
74  # ============================================
75  # Next.js Frontend
76  # ============================================
77  nextjs:
78    build:
79      context: ./nextjs
80      dockerfile: Dockerfile
81      args:
82        NEXT_PUBLIC_API_URL: ${NEXT_PUBLIC_API_URL}
83    container_name: deploymart-web
84    restart: unless-stopped
85    env_file:
86      - .env
87    volumes:
88      - nextjs_static:/app/.next/static
89      - nextjs_public:/app/public
90    networks:
91      - frontend
92    depends_on:
93      django:
94        condition: service_healthy
95    healthcheck:
96      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://localhost:3000/api/health"]
97      interval: 30s
98      timeout: 10s
99      retries: 3
100
101  # ============================================
102  # Nginx Reverse Proxy
103  # ============================================
104  nginx:
105    image: nginx:1.25-alpine
106    container_name: deploymart-proxy
107    restart: unless-stopped
108    ports:
109      - "80:80"
110    volumes:
111      - ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro
112      - ./nginx/conf.d:/etc/nginx/conf.d:ro
113      - django_static:/app/staticfiles:ro
114      - django_media:/app/mediafiles:ro
115      - nextjs_static:/app/.next/static:ro
116      - nextjs_public:/app/public:ro
117    networks:
118      - frontend
119    depends_on:
120      django:
121        condition: service_healthy
122      nextjs:
123        condition: service_healthy
124
125# ============================================
126# NETWORKS
127# ============================================
128networks:
129  frontend:
130    driver: bridge
131  backend:
132    driver: bridge
133    internal: true
134
135# ============================================
136# VOLUMES
137# ============================================
138volumes:
139  pgdata:
140  redis_data:
141  django_static:
142  django_media:
143  nextjs_static:
144  nextjs_public:

Step 6: Build and Run

Add Local Domains to /etc/hosts

bashCopy
1# Linux/macOS
2sudo tee -a /etc/hosts <<EOF
3127.0.0.1 api.deploymart.local
4127.0.0.1 app.deploymart.local
5127.0.0.1 www.deploymart.local
6EOF
7
8# Windows (run as Administrator in PowerShell)
9# Add-Content C:\\Windows\\System32\\drivers\\etc\\hosts "`n127.0.0.1 api.deploymart.local"
10# Add-Content C:\\Windows\\System32\\drivers\\etc\\hosts "`n127.0.0.1 app.deploymart.local"

Build and Start

bashCopy
1# Build all images and start services
2docker compose up -d --build
3
4# Watch the startup sequence
5[+] Building 3/3
6[+] Running 7/7
7 ✔ Network deploymart_backend     Created
8 ✔ Network deploymart_frontend    Created
9 ✔ Volume deploymart_pgdata       Created
10 ✔ Container deploymart-db        Healthy
11 ✔ Container deploymart-cache     Healthy
12 ✔ Container deploymart-api       Healthy
13 ✔ Container deploymart-web       Healthy
14 ✔ Container deploymart-proxy     Started

Step 7: Verification Checklist

1. All Services Healthy

bashCopy
1docker compose ps

Expected output — every service shows healthy:

NAME              IMAGE                    STATUS
deploymart-db     postgres:16-alpine       Up 2 minutes (healthy)
deploymart-cache  redis:7-alpine           Up 2 minutes (healthy)
deploymart-api    deploymart-django        Up 1 minute (healthy)
deploymart-web    deploymart-nextjs        Up 1 minute (healthy)
deploymart-proxy  nginx:1.25-alpine        Up 1 minute

2. API Responds Correctly

bashCopy
1curl http://api.deploymart.local/health/
2# {"status": "healthy", "service": "deploymart-api"}
3
4curl http://api.deploymart.local/api/products/
5# {"source": "database", "data": {"count": 0, "results": []}}

3. Frontend Loads

bashCopy
1curl -s http://app.deploymart.local/ | head -20
2# Should contain HTML with "DeployMart" title

Open http://app.deploymart.local in your browser. You should see the DeployMart storefront.

4. Static Files Served by Nginx

bashCopy
1# Check response headers — should show nginx
2curl -I http://api.deploymart.local/static/admin/css/base.css
3# Server: nginx
4# Cache-Control: public, max-age=15552000

5. Database Persistence

bashCopy
1# Create a product via API
2curl -X POST http://api.deploymart.local/api/products/ \
3  -H "Content-Type: application/json" \
4  -d '{"name": "Docker Sticker", "description": "I love containers", "price": "5.99", "stock": 100}'
5
6# Verify it exists
7curl http://api.deploymart.local/api/products/
8
9# Restart everything
10docker compose down
11docker compose up -d
12
13# Product should still exist!
14curl http://api.deploymart.local/api/products/

6. Internal Network Isolation

bashCopy
1# From the Nginx container, you CAN reach Django
2docker compose exec nginx wget -qO- http://django:8000/health/
3# {"status": "healthy"}
4
5# From your host machine, you CANNOT reach PostgreSQL directly
6curl http://localhost:5432
7# curl: (7) Failed to connect

7. Redis Caching Works

bashCopy
1# First request hits the database
2curl http://api.deploymart.local/api/products/
3# {"source": "database", ...}
4
5# Second request hits cache
6curl http://api.deploymart.local/api/products/
7# {"source": "cache", ...}

Common Errors and Solutions

Error: django.db.utils.OperationalError: could not connect to server

Cause: Django starts before PostgreSQL is ready.

Fix: Ensure depends_on uses condition: service_healthy, not just depends_on: postgres.

Error: 403 Forbidden on POST requests

Cause: Missing proxy_set_header Host $host in Nginx.

Fix: Add all forwarding headers to the Nginx location block.

Error: nextjs build fails with Cannot find module

Cause: node_modules not copied correctly in multi-stage build.

Fix: Ensure COPY --from=deps /app/node_modules ./node_modules is in the builder stage.

Error: Static files return 404

Cause: collectstatic not run or volume not shared.

Fix:

1. Django Dockerfile must run python manage.py collectstatic --noinput
2. Nginx must mount django_static:/app/staticfiles:ro
3. Nginx location /static/ must point to /app/staticfiles/

Error: bind: address already in use for port 80

Cause: Another service (Apache, local Nginx, macOS AirPlay) is using port 80.

Fix:

bashCopy
1# Find what's using port 80
2sudo lsof -i :80
3
4# Stop it or change Nginx ports in docker-compose.yml
5ports:
6  - "8080:80"

Performance Benchmarks

What You Built

Best Practices Applied

• .env is in .gitignore
• .env.example exists for team onboarding
• Database has no exposed ports
• backend network is internal: true
• All services have health checks
• depends_on uses condition: service_healthy
• Named volumes for persistence
• Images pinned to versions
• restart: unless-stopped set
• Non-root users in containers
• Multi-stage builds for smaller images
• Static files served by Nginx, not Django
• Security headers on all responses
• Gzip compression enabled

Next Steps

You now have DeployMart v1.0 running locally. In Track 2: Production Deployment, you will:

1. Module 5: Harden Django with multi-stage builds and Gunicorn
2. Module 6: Optimize Next.js with standalone output
3. Module 7: Add free SSL with Let's Encrypt auto-renewal
4. Module 8: Lock down security with non-root containers, rate limiting, and vulnerability scanning

By the end of Track 2, DeployMart will be ready for a real production server.