---
title: "Promote to production"
url: "https://docs.alisx.com/how-to/alis-build/promote-to-production/"
---
# Promote to production

Deploy a version that already runs in a development environment to a production environment, with a plan first and an explicit confirmation.

## Prerequisites

- A production environment in the product. Create one with `alis environment new <org>.<product> --display-name "Production" --production`, or in the console under the product's **Services** page with **Add environment** and **Production** as the **Environment type**.
- A built version you have validated in development.

## Steps

1. Confirm the deployment environment ids and which one is production.

    ```bash title="Terminal"
    alis environment list acme.sh --json
    ```

    Each deployment environment shows `id`, `displayName`, `production` and `allowedBranches`.

2. Designate the branch production deploys from, once. The designation is stored on the deployment environment; nothing is deployed.

    ```bash title="Terminal"
    alis environment branches acme.sh.<prod-env-id> --allow main
    ```

    From then on a version built from another branch asks for confirmation (`--allow-branch-mismatch`). `--clear` removes the designation. The deployment environment's **Overview** page shows it under **Deploy designation**.

3. Plan the deploy of the exact version. A plan is not gated.

    ```bash title="Terminal"
    alis deploy acme.sh.orders.v1 --version 1.4.2 -e <prod-env-id> --plan-only
    ```

    Read the plan in the result and in `alis logs deploy <operation>`.

4. Deploy the same version with confirmation.

    ```bash title="Terminal"
    alis deploy acme.sh.orders.v1 --version 1.4.2 -e <prod-env-id> --confirm-production
    ```

    At an interactive terminal you can leave out `--confirm-production` and answer the `[y/N]` prompt instead. In scripts and from coding agents the flag is required: without it the command exits with code 3 and `PRODUCTION_CONFIRMATION_REQUIRED`. Approval applies to that one deployment.

5. Verify.

    ```bash title="Terminal"
    alis logs runtime acme.sh.orders.v1 -e <prod-env-id> --since 15m
    ```

    The console's **Services** page shows the version now running in production.

## Production variables

Changing or revealing a production environment's variables is gated the same way: `alis environment set|unset ... --confirm-production` and `alis environment variables --reveal --confirm-production`.

## Related

- [Deploy a version](https://docs.alisx.com/how-to/alis-build/deploy-a-version.md)
- [Deployment environments and versions](https://docs.alisx.com/explanation/environments-and-versions.md)