# Docker Dev Environment

> Use when setting up local development services or running the project locally. Establishes the "stateful services in Docker, app runs native" pattern with Postgres, Redis, MinIO, and Mailpit.

- **Type:** Skill
- **Install:** `agentstack add skill-martian56-claude-engineer-docker-dev-environment`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [martian56](https://agentstack.voostack.com/s/martian56)
- **Installs:** 0
- **Category:** [Databases](https://agentstack.voostack.com/c/databases)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [martian56](https://github.com/martian56)
- **Source:** https://github.com/martian56/claude-engineer/tree/main/plugins/claude-engineer/skills/docker-dev-environment

## Install

```sh
agentstack add skill-martian56-claude-engineer-docker-dev-environment
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Docker Dev Environment

**Announce at start:** "I'm using claude-engineer:docker-dev-environment to run services in Docker and the app native."

## Iron Law
**Only stateful services run in Docker. The app (frontend + backend) runs NATIVELY** in its own shell.
Rationale: instant `uvicorn --reload` / `next dev` / `vite` HMR, real debuggers, and CI/toolchain parity -
Docker handles only the painful-to-install backing services.

## The baseline services (`docker-compose.yml`)
- **PostgreSQL** - primary DB (`localhost:5432`).
- **Redis** - cache, sessions, rate-limit, job broker (`localhost:6379`).
- **MinIO** - S3-compatible object storage (`localhost:9000` API / `9001` console) + a bucket-bootstrap step.
- **Mailpit** - email capture for signup/reset flows (`localhost:1025` SMTP / `8025` UI).
All with healthchecks and named volumes. The native app connects via `localhost` URLs in `.env`.

## The dev flow
1. `docker compose up -d` (services only).
2. Backend in shell A: `uv run uvicorn ...` (native).
3. Frontend in shell B: `pnpm dev` / `bun dev` / `vite` (native).

## Non-negotiables
1. Never containerize the app for local dev (the guard hook will remind you).
2. Healthchecks on every service; the app waits for healthy services.
3. Secrets/connection strings via `.env` (git-ignored), documented.

**Full detail (the complete compose file, MinIO bucket bootstrap, Mailpit SMTP config, connection settings):**
read `references/dev-services.md` on demand.

## Red flags - STOP
- `docker compose up` that builds/starts the app itself for local dev.
- Hardcoded service URLs instead of `.env`.
- A service with no healthcheck.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [martian56](https://github.com/martian56)
- **Source:** [martian56/claude-engineer](https://github.com/martian56/claude-engineer)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-martian56-claude-engineer-docker-dev-environment
- Seller: https://agentstack.voostack.com/s/martian56
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.