Django Starter Kit: Simplifying Development with Docker Compose, Celery, ElasticSearch, PostgreSQL, and Swagger
Welcome to the Django Starter Kit, a comprehensive setup designed to streamline Django development using Docker, Celery, ElasticSearch, PostgreSQL, and Swagger.
This repository contains a pre-configured development environment for Django-based applications, enabling developers to set up a robust development environment with a single command.
- Docker Integration: Run your Django project and essential services in isolated containers for consistent development across different environments.
- Components Included:
- Django: High-level Python web framework for rapid development.
- PostgreSQL: Open-source relational database management system.
- ElasticSearch: Powerful search engine for efficient data indexing and querying.
- Celery & Celery Beat: Asynchronous task queue with a scheduler for background tasks.
- Swagger (OpenAPI): Generates interactive API documentation for easy understanding and testing of endpoints.
- Simplified Setup Process: No need to individually install Python, PostgreSQL, ElasticSearch, etc. Run a single command to initialize the entire development environment.
To get started with the Django Starter Kit:
- Clone the Repository:
git clone https://github.com/codewithmuh/django-starter-kit.git
- Configure Environment Variables: Modify the
local.backend.env
available in build-process folder , we will use this file to customize settings according to your requirements. - Run Setup Command:
docker compose -f "./build-process/docker-compose-django-backend.yml" up -d --build
With the development environment up and running, start coding your Django application without worrying about individual service installations or configurations. Focus on building your application and leave the rest to the Dockerized setup!
Contributions to the Django Starter Kit are highly encouraged! Follow these guidelines to contribute:
Note: Make sure the Docker desktop is installed and running on your system. You can download it from the official website of dockerhub.
- Fork the repository.
- Create a new branch:
git checkout -b feature/your-feature
. - Make your changes and commit them:
git commit -m 'Add your feature'
. - Push to the branch:
git push origin feature/your-feature
. - Submit a pull request!
This project is licensed under MIT License, granting you the freedom to use, modify, and distribute the code.
Special thanks to codewithmuh for creating this incredible Django Starter Kit and simplifying the development process.