Free — no signup required

Introduction: "It Works on My Machine

2 min read

The Dependency Hell

You clone a repository, follow the README, run the setup script, and it immediately fails. Sound familiar?

Error: Python 3.9 required, you have 3.8.
Error: libssl-dev not found.
Error: This script assumes Linux, but you are on Windows.

You spend four hours debugging your local laptop just to write one line of code. Meanwhile, your colleague on a different OS has a completely different set of errors. The application works fine in production — but nobody can agree on a local setup that works for everyone.

This is dependency hell: the state where the tools, libraries, and OS-level packages required to run a project are not consistently defined, so every developer's machine drifts into a unique, fragile snowflake configuration. The root cause is almost always the same — the development environment was never treated as a first-class artifact of the project.

The Solution: Codified Environments

Modern engineering demands that the development environment be defined in code, just like the application itself. If the environment is expressed as a file checked into version control, it can be reproduced identically on any machine — a new hire's laptop, a CI runner, or a cloud-hosted workspace. Every developer gets the exact same toolchain, OS libraries, compiler versions, and editor extensions, automatically.

This principle is sometimes called environment-as-code, and it is the foundation of two technologies we will cover in this lesson:

  1. Dev Containers — Use Docker to package your entire development toolchain into a container that your IDE connects to.
  2. Nix — Use a functional package manager to declare dependencies with mathematical precision, guaranteeing bit-for-bit reproducibility.

Both solve the same problem from different angles. Understanding both — and knowing when to reach for each — is a mark of a senior engineer.

This is one of 18 chapters

Every chapter is free — Kubernetes, Terraform, SRE, distributed systems, and more — with fast daily review built in.

Sign up free