<!-- mobian-agent-page publisher="dailydev" canonical="https://daily.dev/posts/devspeed-reproducible-dev-environments-in-one-yaml-file-j0wmrsjzm" -->

---
title: devspeed: Reproducible Dev Environments in One YAML File
description: devspeed is a new open-source CLI tool that turns a single YAML file into a reproducible Docker Compose dev environment, aiming to replace hand-rolled...
canonical: https://daily.dev/posts/devspeed-reproducible-dev-environments-in-one-yaml-file-j0wmrsjzm
twitter:card: summary_large_image
twitter:site: @dailydotdev
og:type: website
og:site_name: daily.dev
og:title: devspeed: Reproducible Dev Environments in One YAML File | daily.dev
og:description: devspeed is a new open-source CLI tool that turns a single YAML file into a reproducible Docker Compose dev environment, aiming to replace hand-rolled...
og:url: https://daily.dev/posts/devspeed-reproducible-dev-environments-in-one-yaml-file-j0wmrsjzm
og:image: https://api.daily.dev/og/posts/j0WmRSJzM.png
og:image:alt: devspeed: Reproducible Dev Environments in One YAML File
og:image:width: 1200
og:image:height: 630
og:locale: en
---

> ## Documentation Index
> Fetch the complete documentation index at: https://daily.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# devspeed: Reproducible Dev Environments in One YAML File

**[Nidhal](https://daily.dev/sources/j6mmq3qgquldfbve05qrs)** · [@nidhal12](https://daily.dev/nidhal12) · 3 min read · 0 upvotes · 0 comments

## Summary

devspeed is a new open-source CLI tool that turns a single YAML file into a reproducible Docker Compose dev environment, aiming to replace hand-rolled docker-compose.yml files that drift out of sync. It supports stacks like node-postgres-redis, fastapi-postgres, and django-postgres, with commands like devspeed init, up, doctor, and status. The author positions it against plain Docker Compose, VS Code Dev Containers, and Nix, and is soliciting feedback on which stack to add next.

## Content

**New project setup should take one minute, not one afternoon.**

If you've ever onboarded a new teammate and watched them spend half a day fighting Docker Compose files, mismatched Node versions, or a Postgres container that "worked yesterday," you already know the problem. Every project reinvents its own local dev setup, usually as a hand-written `docker-compose.yml` that slowly drifts out of sync with what's actually needed.

I built **devspeed** to fix that.

#### What it does

devspeed turns a small, shareable YAML file into a ready-to-run Docker Compose environment for your app and its dependencies:

```
devspeed.yaml  ->  devspeed up  ->  app + databases + useful connection URLs
```

No global installs. No copy-pasted Compose files. No "works on my machine" ritual.

#### Quick start

```
pip install -e .
devspeed create
devspeed doctor
devspeed up
```

Prefer explicit, scriptable setup?

```
devspeed init node-postgres-redis --name my-api
```

This generates a `devspeed.yaml` you commit to git. The runtime files (`docker-compose.devspeed.yml`, `.env.devspeed`) stay local and gitignored — so every teammate gets identical services, ports, and credentials without anyone touching Docker Compose syntax directly.

#### The team workflow

```
# One developer creates the project recipe
devspeed init fastapi-postgres --name billing-api
git add devspeed.yaml && git commit -m "Add dev environment"

# A new teammate clones the repo and runs
devspeed doctor
devspeed up
devspeed status
```

That's the entire onboarding process. `devspeed.yaml` is the single source of truth teammates review in PRs — the same way you'd review a `package.json` change.

#### What you get out of the box

- **One config file** — same ports, services, and credentials for the whole team
- **Fast onboarding** — generate a stack in seconds, start it with one command
- **Isolated dependencies** — databases and caches run in containers, not on your machine
- **Sane defaults** — health checks, hot reload, volumes, and local connection URLs generated automatically
- **Runnable starters** — a fresh `init` scaffolds a tiny working app when entry files don't exist yet, without ever overwriting your code
- **A clear escape hatch** — the generated Compose file is plain, readable YAML you can inspect or extend as your project grows

#### Available stacks today

| Stack | Includes |

|---|---|

| `node-postgres-redis` | Node.js / Express, PostgreSQL, Redis |

| `fastapi-postgres` | FastAPI, PostgreSQL |

| `django-postgres` | Django, PostgreSQL |

More are coming — see the [roadmap](#) — and adding one is intentionally simple: a stack module just exposes `NAME`, `DESCRIPTION`, `defaultconfig()`_,_ `composeyaml()`, `envfile()`_, and_ `postup_hints()`.

#### Why not just... Docker Compose / devcontainers / Nix?

- **Plain Docker Compose** works, but every project hand-rolls its own file, and it drifts as the project grows. devspeed generates it _for_ you from a small declarative config, and regenerates it consistently.
- **VS Code Dev Containers** solve editor-level reproducibility well, but they're tied to VS Code and JSON config. devspeed is editor-agnostic and CLI-first.
- **Nix** is powerful but has a steep learning curve. devspeed's goal is the opposite: zero learning curve, one YAML file, one command.

#### What's next

The first release is intentionally focused on getting the container workflow rock solid. On the roadmap: more stack templates, configurable lifecycle commands, generated `.env.example` files, and optional local-install support for teams that can't use Docker.

#### Try it / contribute

The project is MIT-licensed and open to contributions — adding a new stack template is one of the easiest ways to get started. Repo: [https://github.com/ZitouniNidhal/devspeed](https://github.com/ZitouniNidhal/devspeed)

If you've felt this exact pain onboarding a new teammate, I'd genuinely love feedback — what stack should I add next?

## Similar posts on daily.dev

- [The Frustration, The Fire, and The Blueprint for Devspace\*](https://daily.dev/posts/the-frustration-the-fire-and-the-blueprint-for-devspace--mvbdhdmuc) · Medium · 0 upvotes · 0 comments
- [My favorite VS Code upgrade isn’t another AI extension, it's something even better](https://daily.dev/posts/my-favorite-vs-code-upgrade-isn-t-another-ai-extension-it-s-something-even-better-rgep1di7c) · XDA Developers · 2 upvotes · 0 comments
- [From devcontainers to VMs: parallel dev environments for AI agents](https://daily.dev/posts/from-devcontainers-to-vms-parallel-dev-environments-for-ai-agents-bjgmxlpxi) · Arcjet · 3 upvotes · 0 comments
- [Verify faster](https://daily.dev/posts/verify-faster-zmkbwrxol) · RUBYLAND · 0 upvotes · 0 comments

---

Tags: [#docker-compose](https://daily.dev/tags/docker-compose)

[View this post on daily.dev](https://daily.dev/posts/devspeed-reproducible-dev-environments-in-one-yaml-file-j0wmrsjzm)

```json
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]}
{"@context":"https://schema.org","@type":"DiscussionForumPosting","mainEntityOfPage":"https://daily.dev/posts/devspeed-reproducible-dev-environments-in-one-yaml-file-j0wmrsjzm","headline":"devspeed: Reproducible Dev Environments in One YAML File","text":"devspeed is a new open-source CLI tool that turns a single YAML file into a reproducible Docker Compose dev environment, aiming to replace hand-rolled docker-compose.yml files that drift out of sync. It supports stacks like node-postgres-redis, fastapi-postgres, and django-postgres, with commands like devspeed init, up, doctor, and status. The author positions it against plain Docker Compose, VS Code Dev Containers, and Nix, and is soliciting feedback on which stack to add next.","url":"https://daily.dev/posts/devspeed-reproducible-dev-environments-in-one-yaml-file-j0wmrsjzm","datePublished":"2026-09-27T05:23:58.272Z","dateModified":"2026-09-27T05:24:13.650Z","author":{"@type":"Person","name":"Nidhal","url":"https://daily.dev/nidhal12","image":"https://media.daily.dev/image/upload/s---6PytCRL--/f_auto/v1738855579/avatars/avatar_J6Mmq3qGqULDfBVE05qRs","interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"EndorseAction"},"userInteractionCount":140}},"image":"https://media.daily.dev/image/upload/s--Qglz5Ws6--/f_auto/v1790486638/posts/j0WmRSJzM?_a=BAMAMicg0","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":0},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"isPartOf":{"@type":"WebPage","url":"https://daily.dev/sources/j6mmq3qgquldfbve05qrs","name":"Nidhal"}}
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Nidhal","item":"https://daily.dev/sources/j6mmq3qgquldfbve05qrs"},{"@type":"ListItem","position":3,"name":"devspeed: Reproducible Dev Environments in One YAML File"}]}
```

