Repository files navigation

This repository demonstrates how to containerize a Django application with a PostgreSQL database using Docker. Docker allows you to package your application, its dependencies, and the database into separate containers, providing a consistent and portable environment for development and deployment.

Before getting started, make sure you have the following prerequisites installed on your machine:

• Docker:Install Docker
• Docker Compose:Install Docker Compose

Follow the steps below to run the Django application with PostgreSQL using Docker:

1. Clone this repository:

   git clone https://github.com/barzansaeedpour/docker_django_postgresql.gitcd docker_django_postgresql

2. Build the Docker images and start the containers:

   docker-compose up --build

   Thedocker-compose.yml file defines the services for the Django application and the PostgreSQL database. Running the command above will build the necessary Docker images and start the containers.

3. Access the Django application in your web browser:

   http://localhost:8000

4. Access the PostgreSQL database using a database client:

   • Host:localhost
   • Port:5432
   • Username:postgres
   • Password:postgres
   • Database:postgres

The project structure is organized as follows:

.├── docker-compose.yml├── Dockerfile├── README.md├── testproject│   ├── __init__.py│   ├── settings.py│   ├── asgi.py│   ├── urls.py│   └── wsgi.py├── manage.py└── requirements.txt

• docker-compose.yml: The Docker Compose configuration file that defines the services and their configurations, including the Django application and the PostgreSQL database.
• Dockerfile: The Dockerfile that describes how to build the Docker image for the Django application.
• README.md: This file, providing instructions and information about the project.
• testproject/: The Django application directory.
  • settings.py: The Django project settings file.
  • urls.py: The Django project URLs configuration.
  • wsgi.py: The WSGI application entry point.
• manage.py: The Django management script.
• requirements.txt: The Python dependencies file for the Django application.

You can customize the Django application, the PostgreSQL configuration, or the Docker setup according to your project requirements. Here are some possible modifications:

• Update the Django application code inside thedjangoapp directory.
• Modify thedocker-compose.yml file to adjust service configurations, add environment variables, or mount volumes.
• Extend theDockerfile to install additional dependencies or perform custom setup steps.
• Customize the PostgreSQL configuration by modifying thedocker-compose.yml file.

If you have any suggestions, improvements, or bug fixes, please feel free to contribute to this repository. Fork the repository, make your changes, and submit a pull request.

This project is licensed under theMIT License.

Feel free to adjust and expand thisREADME.md file to fit the specific needs and details of your Django project with PostgreSQL using Docker.