Skip to content

Guides

Guides

This section is for real workflows. Use it when you already know the basic model and want help applying it to Docker, CI, team usage, debugging, or day-to-day work.

When to use guides

Use Guides when your question sounds like:

  • how should I use envctl with Docker
  • how do profiles fit into a real workflow
  • how should a team share contract changes
  • how do I debug the right layer

If your question is instead “what does this concept mean?”, go to Concepts. If you need exact syntax or behavior, go to Reference.

Workflow guides

  • Docker

    Use envctl with containers without confusing host resolution and container injection.

    Open Docker guide

  • CI

    Run envctl in pipelines with predictable selection and projection behavior.

    Open CI guide

  • Profiles

    Create, fill, copy, and remove local profiles without mutating the contract.

    Open profiles guide

  • Team workflows

    Keep the contract shared while real values stay local to each machine.

    Open team guide

  • Debugging

    Debug the right layer instead of guessing at runtime behavior.

    Open debugging guide

  • Daily workflow

    See the small set of commands that matter most in normal day-to-day use.

    Open daily workflow

  • Hooks

    Operate the managed Git safety layer when your team uses it.

    Open hooks guide

Daily workflow

Start with the day-to-day command rhythm most users actually repeat.

Open daily workflow

Debugging

Open this when reality and expectations stop matching.

Open debugging guide

Troubleshooting

If you are already in a failure state, start from symptoms instead.

Open troubleshooting