Reference · the tools · environments

Build an environment

What it does

Build the environment from its directory as it is now: compose.yaml and bettik.json are re-read, images built or pulled, the containers that changed recreated, .env rewritten, newly declared secrets minted, and the environment is up. Idempotent -- with nothing changed, nothing happens. Use it after editing compose.yaml, a Dockerfile it builds, or bettik.json. Does not run seed or update. (formerly build_bundle)

What it needs to know

environment_id

The environment.

confirm · optional

For a stopped environment: go ahead although the box or its pool is above 75% memory (a box nearly out of memory is refused regardless).

box · optional

Which box: its name and account, "home.frank" or "jordan.northwind", or just "home" when only one of your boxes is called that. Omit it for your current box (switch_box changes it; list_boxes says which it is).

session_box · optional

The box this session runs on, if it runs on one of yours: its name, as the on-box instructions give it ("frankh90.hemlane"). With it, a call that names no box is checked against your current box.

Where it lands

On one of your boxes: the one named in box, or your default box when none is named.