Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Home

Jump to bottom
Vicky Kumar edited this page Jun 16, 2025 · 1 revision

🚀 How to Create and Publish Your Own Docker Package (Hello World Django)

image

Have you ever wanted to package your Django app into a Docker image and share it with the world — just like ghcr.io container packages? In this tutorial, we’ll walk through how to:

  • Dockerize a Django app (Hello World)

  • Build it into an image

  • Push it to GitHub Container Registry (GHCR)

  • Make it publicly available

📁 Step 1: Project Setup

Create a simple Django app (or use your existing one). You should have a project structure like this:

docker-django-deploy/
├── Dockerfile
├── requirements.txt
├── manage.py
├── hello/
├── helloworld/
└── ...

🐳 Step 2: Write Your Dockerfile

Here’s a minimal and clean Dockerfile for your Django app:

FROM python:3.10-slim

WORKDIR /app

COPY . .

RUN pip install --upgrade pip && \
    pip install -r requirements.txt

EXPOSE 8080

CMD ["python3", "manage.py", "runserver", "0.0.0.0:8000"]

🔐 Step 3: Generate a Personal Access Token (PAT) on GitHub

Go to GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)

Click Generate new token

Select scopes:

  • write:packages ✅

  • read:packages ✅

  • (Optional) delete:packages

Click Generate token and copy it immediately (you won’t see it again).

🔑 Step 4: Log In to GitHub Container Registry

echo YOUR_PAT | docker login ghcr.io -u YOUR_GITHUB_USERNAME --password-stdin

Example:

echo ghp_abcd1234xyz | docker login ghcr.io -u imvickykumar999 --password-stdin

🏗️ Step 5: Build Your Docker Image

From your project directory:

docker build -t ghcr.io/imvickykumar999/docker-django-deploy:latest .

This tells Docker to:

  • Use the current directory (.)

  • Tag the image for GHCR

📤 Step 6: Push Your Image to GHCR

docker push ghcr.io/imvickykumar999/docker-django-deploy:latest

You’ll see the layers get uploaded. Once done, visit:

👉 https://github.com/imvickykumar999/docker-django-deploy/pkgs/container/docker-django-deploy

🔓 Optional: Make Your Package Public

To let others pull your image without login:

  1. Go to the package page

  2. Click "Package settings"

  3. Change Visibility to Public

📥 Step 7: Pull and Run the Image Anywhere

On another machine or VM:

docker pull ghcr.io/imvickykumar999/docker-django-deploy:latest
docker run -p 8000:8000 ghcr.io/imvickykumar999/docker-django-deploy:latest

🎉 You Did It!

You now have:
✅ A Dockerized Django app
✅ Published on GitHub Container Registry
✅ Reusable and shareable with the world

📎 Bonus: Automate with GitHub Actions

You can even set up a .github/workflows/publish.yml to automatically build and push your Docker image on every git push. (Let me know if you want this too.)

💬 Have questions? Drop a comment or open an issue in your GitHub repo.

Clone this wiki locally