> ## Documentation Index
> Fetch the complete documentation index at: https://synthetiq.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Local Machine

> Full setup from your machine — for sandbox accounts and evaluation

Everything runs from your machine, with AWS credentials for the target account. Each step links to the page with the details.

<Note>
  Running provision yourself requires the `infra:provision` org scope (no service account or trust needed for local runs), plus your [organization id](/docs/platform-docs/deployments/byoi/prerequisites#finding-your-organization-id). See [Required Synthetiq permissions](/docs/platform-docs/deployments/byoi/prerequisites#required-synthetiq-permissions) and check yours with `synthetiq whoami`.
</Note>

<Steps>
  <Step title="Install and log in">
    ```bash theme={null}
    npm install -g @synthetiq/cli
    synthetiq login
    ```
  </Step>

  <Step title="Issue the two certificates">
    Request both ACM certs and add the **2 validation CNAMEs** at your DNS provider; wait for `ISSUED`. See [Certificates](/docs/platform-docs/deployments/byoi/certificates). (If you skip this, `init` stops and prints what's needed.)
  </Step>

  <Step title="Create the config">
    From a git repository:

    ```bash theme={null}
    synthetiq infra init \
      --domain apps.yourcompany.com \
      --profile <aws-profile>
    ```

    Discovers your VPC options and issued certificates, writes `_infra/synthetiq.yaml`. Commit it. See [Generating synthetiq.yaml](/docs/platform-docs/deployments/byoi/configuration).
  </Step>

  <Step title="Preview">
    ```bash theme={null}
    synthetiq infra generate \
      --profile <aws-profile>
    ```

    Review the changeset file — the exact CloudFormation diff. See [Previewing & Applying](/docs/platform-docs/deployments/byoi/provisioning).
  </Step>

  <Step title="Apply">
    ```bash theme={null}
    synthetiq infra provision \
      --profile <aws-profile>
    ```

    Executes the reviewed change sets (CloudFront takes 15–20 minutes), then prints the **3 app DNS records**.
  </Step>

  <Step title="Create the app DNS records">
    Add the 3 printed records at your DNS provider ([DNS](/docs/platform-docs/deployments/byoi/dns)). Done — deploy apps from the Synthetiq console.
  </Step>
</Steps>

To update later: edit the config (or upgrade the CLI), then `generate` → review → `provision`. For production, use the [CI walkthrough](/docs/platform-docs/deployments/byoi/walkthroughs/ci).