December 9th, 2025
This project provides a complete solution for running Postgres 18 in Docker with Python 3.12 integration, automated dependency management, and a full test suite. It is one that I use as a base for coding projects.
The project includes a management script (start.sh) that handles container lifecycle, Python virtual environment setup, dependency installation, and connection testing. All components are designed to work together seamlessly with minimal configuration required.
For detailed information, see the following documentation files:
- start.sh Script Guide - Complete documentation for the main management script
- Docker Management Guide - Quick reference for Docker commands and container management
- Test Suite Documentation - Guide to running and understanding the automated test cases
- Git Workflow Guide - Step-by-step instructions for Git operations in Cursor IDE
- Python 3.12 Setup Guide - Installing Python 3.12, managing the venv, and updating dependencies
- Ensure Docker and Python 3.12 are installed
- Configure
.envfile with the included env.example file for your Postgres credentials - Run
./start.sh startto initialize and start the database - Use
./start.sh statusto verify everything is working
For more details, see the start.sh Script Guide.