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

# Deployment

> Deploy your BRICKS application to the server

Deploy your application to the [BRICKS](https://bricks.tools) server directly from the desktop app.

## Deploy your app

<Steps>
  <Step title="Open the deploy dialog">
    Click **Actions** > **Deploy** in the chat panel header.
  </Step>

  <Step title="Add changelogs (optional)">
    Enter a changelog description to document what changed in this deployment.
  </Step>

  <Step title="Deploy">
    Click **Deploy**. The app runs `bun deploy-app -y` in your project directory.
  </Step>
</Steps>

The deploy dialog shows the command output in real-time. On success, you see a confirmation message. On failure, the error output is displayed.

## Version management

You can control the release version by running the deploy command manually with flags:

```bash theme={null}
bun deploy-app --auto-version    # bump patch version (e.g. 1.0.0 → 1.0.1)
bun deploy-app --version 2.0.0   # set explicit version
```

Both flags update `package.json` before deploying. See the [bricks-ctor deploy reference](/ctor-pkg/getting-started#deploy) for all available flags.

<Warning>
  Deployment requires `bun` to be installed and available in your PATH. The operation has a 5-minute timeout.
</Warning>

## Open BRICKS Controller

After deploying, open the **Controller** tab in the [right panel](/ctor/reference/right-panel#controller) to view your app in the [BRICKS Controller](/controller/applications) web interface. Click **Open controller in browser** in the tab bar to open the same view in your default browser.

## Next steps

<Card title="Pull app files" icon="download" href="/ctor/guide/pull-app">
  Pull the latest files from the server to your local project.
</Card>