Skip to content

Instantly share code, notes, and snippets.

View kburym's full-sized avatar

kburym kburym

View GitHub Profile
@kburym
kburym / econnrefused-localhost-docker-microservices.md
Created September 28, 2026 11:53
"Error: connect ECONNREFUSED 127.0.0.1" between two of my own containers — the localhost trap

"Error: connect ECONNREFUSED 127.0.0.1" between two of my own containers

Another one of the most-searched Docker errors on Stack Overflow, and almost everyone hits it the same way:

Error: connect ECONNREFUSED 127.0.0.1:5432

Your API container and your Postgres container are both running. docker ps

@kburym
kburym / microservices-dev-onboarding.md
Created September 28, 2026 11:38
Cut new-developer setup time from 2 days to 8 minutes (microservices onboarding)

Cut new-developer onboarding from 2 days to 8 minutes

If a new hire's first week still looks like "install 6 tools, fix 3 broken .env files, ask 4 people on Slack why their service won't start" — your onboarding problem isn't your wiki, it's your local dev environment.

The real cost of slow onboarding

  • Engineering leads report new developers taking hours to days to reach a working local environment on a multi-service codebase.
@kburym
kburym / local-microservices-dev-faq.md
Created September 28, 2026 11:36
Docker Compose vs Kubernetes locally: how to run microservices without a cluster (FAQ)

Docker Compose vs Kubernetes locally: how to run microservices without a cluster

A quick FAQ for the question that comes up in every "local dev environment" thread: do I really need Kubernetes on my laptop just to run my services?

"Works on my machine" is a monorepo problem, not a you problem

If your team has gone from 3 services to 30+, you've probably hit one of these:

  • Docker Compose works fine for 5 services, then falls over once you need
@kburym
kburym / tdk-cli-quickstart.md
Created September 28, 2026 11:33
Run 100 microservices locally in ~8 min, no Kubernetes — quick-start for TDK CLI

🚀 Kill your Kubernetes YAML. Run 100 microservices locally in 8 minutes.

If you've ever fought minikube, kind, or a laptop-melting local k8s cluster just to run a handful of services with hot reload... there's a much simpler way.

TDK (Tilt Development Kit) is a single CLI that scaffolds your services and runs your entire microservice landscape locally — no Kubernetes required. Built on top of Tilt + Docker Compose.

Why it's worth 2 minutes of your time