Django Project Setup Guide

Prerequisites

• Python: 3.11.9
• pip: Ensure you have the latest version installed
• virtualenv (optional but recommended)

Setup Instructions

1. Clone the Repository

git clone <your-repo-url>
cd <your-project-folder>

Probably already done this

2. Create and Activate Virtual Environment (Optional but Recommended)

python -m venv venv
# Activate on Windows
venv\Scripts\activate
# Activate on macOS/Linux
source venv/bin/activate

3. Install Dependencies

pip install -r requirements.txt

4. Apply Migrations

python manage.py migrate

5. Create a Superuser (Optional)

python manage.py createsuperuser

Follow the prompts to create an admin account.

6. Run the Development Server

python manage.py runserver

The server will start at http://127.0.0.1:8000/.

7. (Optional) Run Tests

python manage.py test

Deployment Notes

• Ensure DEBUG=False in production.
• Configure allowed hosts in settings.py (ALLOWED_HOSTS).

---