Docker Shared Services

Collection of containerized development services with comprehensive Docker Compose configurations, environment management, and orchestration tools.

Important

OS Compatibility: This repository is designed and optimized exclusively for macOS and Linux. It relies on Unix-specific tooling and scripts; Windows is not supported.

🚀 Quick Start

Setup (5 minutes)

# 1. Setup environment, shared networks, and certificates
make setup

# 2. Start services (interactive prompt allows selecting 'all' or specific service)
make up

# 3. Check status
make ps

Alternative Setup Methods

Using Docker Compose directly:

docker compose -f docker-compose.shared.yml \
  -f pgvector/docker-compose.yml \
  -f redis/docker-compose.yml \
  -f monitoring/docker-compose.yml \
  up -d

---

📚 Detailed Documentation

To explore service options, networking details, commands, and troubleshooting, refer to the following guides:

• Services & Access Reference: Catalog of available services, open ports, default credentials, and statistics.
• Configuration & Networking Guide: Customizing environment variables, ports, passwords, resource constraints, Docker networking, and SSL/TLS certificates.
• Commands & Operations Guide: Complete Makefile orchestrations, Docker Compose command examples, cleanup procedures, and development pro-tips.
• Troubleshooting & Support: Common startup issues, port conflicts, out-of-memory errors, and diagnostic steps.

---

📋 Project Structure

docker-shared-services/
├── docker-compose.shared.yml      # Shared external networks (infra_shared, dev_tools)
├── docs/                          # Detailed documentation guides
│   ├── services.md
│   ├── configuration.md
│   ├── usage.md
│   └── troubleshooting.md
├── Makefile                       # All-in-one management commands
├── bin/                           # Python management logic
├── [service directories]/         # (e.g., pgvector/, redis/, mongodb/, etc.)

---

🤝 Contributing & Support

• Refer to the Troubleshooting & Support guide for issues.
• Contributions are welcome! Feel free to open issues or submit pull requests.
• License: See LICENSE file.

---

Docker Version Required: 20.10+ | Docker Compose Version Required: 2.0+