Skip to content

Tear down your local plexsphere

When you are finished with the local stack — or when it has drifted into a state a rebuild fixes faster than debugging — this lesson removes it cleanly and, if you need it, rebuilds it from a clean baseline. It is the bookend to Set up your local plexsphere.

Tear down

bash
make dev-down

Deletes the plexsphere kind cluster only — unrelated kind clusters on the same machine are untouched. make dev-down checks the ownership-sentinel ConfigMap that make dev stamps and refuses to delete a cluster that lacks it, so a foreign cluster named plexsphere is preserved.

Reset recipe

When the stack is in an indeterminate state — a half-applied overlay, a hung Deployment, or ErrImageNeverPull after a partial rebuild — delete the cluster, prune Docker state, and rerun make dev from a clean baseline:

bash
make dev-down
docker system prune -f
make dev

The docker system prune -f step reclaims dangling layers and exited containers. The subsequent make dev run takes ~3 minutes from a cold cache and ~40 seconds against a warm one.

Where to go next

  • Start overSet up your local plexsphere brings the stack back up from scratch.
  • Need more than the lean cluster? The dev stack runbook covers every production dependency, the golden-flow end-to-end run, and the full troubleshooting matrix.