# kindgi promote > Move a build to the next environment of its environment order, staging to prod, say: the same signed image, with the edits made since to its agents and flows ## `kindgi promote` **Synopsis** ```sh signature kindgi promote --from= --to= [--deployment=] [--reason=] [--check] [--make-live [--wait[=]]] [--path=] ``` Move a build to the next environment of its environment order, staging to prod, say: the same signed image, with the edits made since to its agents and flows. Prints what moves, then each value the build needs there that isn't set, with the command that sets it; exits 1 while one isn't. `--check` stops before moving anything. With `--make-live`, exits 3 when a carried version doesn't go live: held by the gate, or waiting for an approval (`--wait` waits for the decision). In a pack, --from and --to are its environment names; outside one, project ids or slugs. **Options** | Option | Default | Description | | ---------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--check` | off | What would move, and the values not set in --to. Changes nothing. | | `--deployment ` | none (the one deployment serving in `--from`; in a pack, of this pack) | The deployment to promote. Default: the one deployment serving in --from (in a pack, of this pack). | | `--from ` | required | The environment the build serves in: its name in your pack config, or outside a pack a project id or slug. | | `--make-live` | off | Make every agent version the promotion carries live in --to, each through its scope's gate, and pin every flow version it carries there. Prints each, and any waiting on a gate; exits 3 when one doesn't go live. | | `--path ` | the current directory | The pack root. Default: the current directory. | | `--reason ` | none | Why, kept on the audit record. | | `--to ` | required | The next environment of the order: its name in your pack config, or outside a pack a project id or slug. | | `--wait ` | off; a bare `--wait` waits at most `1h` | When a version waits for an approval, wait until a reviewer decides: at most the duration given (90s, 30m, 2h), 1h when none is. Exits 0 once it goes live, and 3 when it is rejected, its approval expires, it is superseded or the wait runs out, and 1 when 3 reads of the promotion in a row fail. An approval stays open after the wait. | Every command also takes the [global flags](https://docs.kindgi.com/v0.3.0/reference/cli.md#global-flags). **Examples** Promote the build serving in staging to prod, saying why. ```sh kindgi promote --from=staging --to=prod --reason="release 12" ``` Promote to prod and make each agent the build carries live there, each through its release gate policy. ```sh kindgi promote --from=staging --to=prod --make-live --reason="release 12" ``` See what would move to prod and which values it lacks, changing nothing. ```sh kindgi promote --from=staging --to=prod --check ``` Outside a pack, name the two environments by project slug or id. ```sh kindgi promote --from=acme-staging --to=acme-prod ``` From [Ship a pack from CI](https://docs.kindgi.com/v0.3.0/deploy/ship-from-ci.md): ```sh pnpm exec kindgi promote --from=staging --to=prod --check pnpm exec kindgi promote --from=staging --to=prod --reason="Passed in staging" ``` **See also** - [Ship a pack from CI](https://docs.kindgi.com/v0.3.0/deploy/ship-from-ci.md)