Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ldcmleo/postgress-boilerplate
This repository provides a ready-to-use setup for deploying a PostgreSQL database service using Docker and Docker-Compose. It’s ideal for developers and teams who want to quickly and easily set up a database environment without hassle.
https://github.com/ldcmleo/postgress-boilerplate
docker postgres
Last synced: 21 days ago
JSON representation
This repository provides a ready-to-use setup for deploying a PostgreSQL database service using Docker and Docker-Compose. It’s ideal for developers and teams who want to quickly and easily set up a database environment without hassle.
- Host: GitHub
- URL: https://github.com/ldcmleo/postgress-boilerplate
- Owner: ldcmleo
- License: mit
- Created: 2024-09-06T23:08:33.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-09-10T22:59:47.000Z (5 months ago)
- Last Synced: 2024-11-22T01:08:54.803Z (3 months ago)
- Topics: docker, postgres
- Homepage:
- Size: 3.91 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PostgreSQL Database Service with Docker and Docker-Compose
This repository provides a ready-to-use setup for deploying a PostgreSQL database service using Docker and Docker-Compose. It’s ideal for developers and teams who want to quickly and easily set up a database environment without hassle.
## 🚀 Features
- **Simplified Setup**: Includes a `compose.yml` file to define and run a PostgreSQL container with just one command.
- **Data Persistence**: Database data is stored in a Docker volume to ensure it is not lost when the container is removed.
- **Customizable Configuration**: Adjust PostgreSQL settings through environment variables in the `compose.yml` file.
## 🛠️ Requirements
- [Docker](https://docs.docker.com/get-docker/) (v20.10 or higher)
- [Docker-Compose](https://docs.docker.com/compose/install/) (v1.29 or higher)
## 🔧 Installation and Usage
1. **Clone the repository:**
```bash
git clone https://github.com/ldcmleo/Postgress-Boilerplate.git
cd your-repository
```
2. **Run Docker-Compose:**
```bash
docker compose up -d
```
3. Access the Database:
You can connect to the PostgreSQL database using the PostgreSQL client or any compatible tool using the parameters specified in the docker-compose.yml file.
## 📝 Configuration
You can modify PostgreSQL settings in the compose.yml file. Key variables you can adjust include:
- POSTGRES_USER: Database username
- POSTGRES_PASSWORD: User password
- POSTGRES_DB: Database name to create
## 🔄 Updates
To update the service, stop and remove the existing containers, then start new ones with:
```bash
docker-compose down
docker-compose up -d
```
## 🤝 Contributing
Contributions are welcome. If you encounter any issues or want to add new features, feel free to open an issue or submit a pull request.
## 📄 License
This project is licensed under the MIT License.