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

# bp deploy

> Deploy your project to Botpress Cloud

Deploy bots, integrations, and plugins to Botpress Cloud.

## Usage

```bash theme={null}
bp deploy
```

## Options

### --noBuild

Skip build step:

```bash theme={null}
bp deploy --noBuild
```

### --visibility

Set integration/plugin visibility:

```bash theme={null}
bp deploy --visibility public
bp deploy --visibility private
bp deploy --visibility unlisted
```

### --dryRun

Validate without deploying:

```bash theme={null}
bp deploy --dryRun
```

### --botId

Deploy to specific bot:

```bash theme={null}
bp deploy --botId abc123
```

### --createNewBot

Create new bot instead of updating:

```bash theme={null}
bp deploy --createNewBot
```

## Deployment flow

<Steps>
  <Step title="Build">
    Project is built (unless --noBuild)
  </Step>

  <Step title="Validate">
    Definition is validated
  </Step>

  <Step title="Upload">
    Code is uploaded to cloud
  </Step>

  <Step title="Register">
    Resources are registered
  </Step>
</Steps>

## Bot deployment

```bash theme={null}
cd my-bot
bp deploy
```

First deploy prompts for bot selection.
Subsequent deploys use cached bot ID.

## Integration deployment

```bash theme={null}
cd my-integration
bp deploy --visibility public
```

Integrations are deployed to workspace.

## Plugin deployment

```bash theme={null}
cd my-plugin
bp deploy --visibility public
```

## Secrets

Integrations prompt for secrets:

```bash theme={null}
? Enter value for API_KEY: ****
? Enter value for WEBHOOK_SECRET: ****
```