docker-compose-dev

Orchestrate a local multi-service Docker Compose stack with PostgreSQL.

1|1|Updated May 3, 2026
One-click install
npx skills add https://github.com/matt-riley/agent-skills --skill docker-compose-dev-matt-riley
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docker-compose-dev
Source: https://github.com/matt-riley/agent-skills/tree/main/skills/docker-compose-dev
Command: npx skills add https://github.com/matt-riley/agent-skills --skill docker-compose-dev-matt-riley

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Run a real service stack locally using Docker Compose to mirror production for integration testing with a PostgreSQL database and app.

Core Features & Use Cases

  • Orchestrates a docker-compose-based local stack (db + app) for prod-like development.
  • Supports migrations, health checks, environment wiring, and deterministic startup order.
  • Use case: debugging connectivity, local QA, or onboarding with a reproducible local environment.

Quick Start

Copy .env.example to .env, edit credentials as needed, then bring up the stack and verify the health endpoint.

Frequently Asked Questions about docker-compose-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a local multi-service stack with Docker Compose for integration testing?

To set up a local multi-service stack with Docker Compose, you need a working docker-compose.yml, an .env template for credentials, and startup verification steps. The stack orchestrates your app and a real database backend like PostgreSQL to mirror production behavior.

What's the best way to reproduce production database connectivity issues during local development?

Reproducing production database connectivity issues during local development requires a Docker Compose stack with a real PostgreSQL backend. This approach wires up service interdependencies and health checks to deterministically mirror production behavior for debugging.

Do I need a .env file to run database migrations with Docker Compose?

Yes, you need a .env file to run database migrations with Docker Compose. You must copy the .env.example template to .env and edit the credentials as needed before bringing up the stack and running optional migrations and seeds.

Can Docker Compose enforce a deterministic startup order for an app and PostgreSQL database?

Yes, Docker Compose can enforce a deterministic startup order for an app and PostgreSQL database. The configuration supports health checks and service interdependencies to ensure the database backend is ready before the application starts.

When should I use Docker Compose instead of a mock database for local QA?

You should use Docker Compose instead of a mock database when you need a real PostgreSQL backend to reproduce production behavior during integration testing, debugging, or onboarding with a reproducible local environment.