AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
SKILL verified MIT Self-run

Docker Dev Environment

skill-martian56-claude-engineer-docker-dev-environment · by martian56

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.

No reviews yet
0 installs
16 views
0.0% view→install

Install

$ agentstack add skill-martian56-claude-engineer-docker-dev-environment

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • Prompt-injection patterns
  • Secret / credential exfiltration
  • Dangerous shell & filesystem operations
  • Untrusted network calls
  • Known-malicious package signatures

What it can access

  • Network access No
  • Filesystem access No
  • Shell / process execution No
  • Environment & secrets Used
  • Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/skill-martian56-claude-engineer-docker-dev-environment)

Reliability & compatibility

Security review passed
0 installs to date
no reviews yet
1mo ago

Declared compatibility

Claude CodeClaude Desktop

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.

How agent discovery & health will work →
Are you the author of Docker Dev Environment? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

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.

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

Reviews

No reviews yet, be the first.

Versions

  • v0.1.0 Imported from the upstream source.