Skip to content

abutahabahaa/simple-store

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🛒 Simple Store – Django + Docker

This is a fully dockerized Django backend for a simple online store project.
The whole system runs inside Docker using Docker Compose with auto-build and live reload enabled.

You do NOT need to install Python, Django, or PostgreSQL on your machine.
Everything runs inside Docker.


🚀 Technologies

  • Python 3.11
  • Django
  • Docker
  • Docker Compose
  • WSL2 (Windows)

📁 Project Structure

simple-store/ │ ├── docker-compose.yml ├── Dockerfile ├── requirements.txt ├── manage.py ├── products/ ├── simple_store/


🧰 Requirements

Before running this project, make sure you have:

  • Docker Desktop installed
  • WSL2 enabled (Windows users)
  • Docker Compose

Check installation:

docker --version
docker compose version

▶️run the project:

Open terminal inside the project folder and run:

docker compose up --build

🌐 Open in Browser

After the containers are running, open:

Main site:

[text](http://localhost:8000)

Admin panel:

[text](http://localhost:8000/admin)

👤 Create Admin User

Run this command in another terminal:

docker compose exec backend python manage.py createsuperuser

🔧 Run Django Commands inside Docker

Migrations:

docker compose exec backend python manage.py migrate

Collect static files:

docker compose exec backend python manage.py collectstatic

🔄 Live Reload

The project uses Django StatReloader. Any code change will automatically reload Django inside the container.

No restart needed.

🛑 Stop the Project

docker compose down

🔁 Rebuild Everything

docker compose up --build

🧠 How It Works

Django runs inside a Docker container

Your project files are mounted into the container SS Docker builds the environment

Django watches file changes

Browser updates instantly

This gives you:

Professional Docker-based Django environment

📦 Deployment Ready

This Docker setup can be deployed on:

VPS

AWS

DigitalOcean

Render

Railway

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published