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

# Bitbucket Integration

> Bitbucket integration is coming soon

<Info>
  Bitbucket integration is coming soon! We're working on bringing Vidoc's security scanning to Bitbucket Cloud and Bitbucket Server.
</Info>

## Planned Features

When Bitbucket integration launches, you'll be able to:

* **Connect Bitbucket repositories** - Link your Bitbucket repos to Vidoc
* **Automatic PR scanning** - Scan pull requests automatically
* **PR comments** - Get security findings as PR comments
* **Auto-scan on push** - Trigger scans on default branch updates
* **Bitbucket Pipelines integration** - Native pipeline support

## Current Alternatives

While we work on Bitbucket integration, you can still scan Bitbucket repositories:

### Using the CLI

1. Clone your Bitbucket repository locally
2. Install and authenticate the Vidoc CLI
3. Run scans from your local machine

```bash theme={null}
# Install CLI
npm i -g @vidocsecurity/cli

# Authenticate
vidoc login

# Scan
cd your-bitbucket-repo
vidoc scan
```

### In Bitbucket Pipelines

Add Vidoc to your `bitbucket-pipelines.yml`:

```yaml theme={null}
image: node:20

pipelines:
  default:
    - step:
        name: Security Scan
        script:
          - npm i -g @vidocsecurity/cli
          - vidoc scan --fail-on high

  pull-requests:
    '**':
      - step:
          name: PR Security Scan
          script:
            - npm i -g @vidocsecurity/cli
            - vidoc scan --fail-on high
```

Remember to add `VIDOC_API_KEY` to your repository variables:

1. Go to Repository Settings → Repository variables
2. Add `VIDOC_API_KEY` with your API key
3. Mark as "Secured"

See [CI/CD Integration](/cli/ci-cd) for detailed setup.

## Stay Updated

Want to be notified when Bitbucket integration launches?

1. Email us at [contact@vidocsecurity.com](mailto:contact@vidocsecurity.com)
2. Follow us on [Twitter](https://twitter.com/vidocsecurity)
3. Check our [blog](https://blog.vidocsecurity.com) for announcements

## Request Features

Have specific Bitbucket features you'd like to see? Let us know:

* Email: [contact@vidocsecurity.com](mailto:contact@vidocsecurity.com)
* Feature requests help us prioritize development

## Related Pages

<CardGroup cols={2}>
  <Card title="GitHub Setup" icon="github" href="/github/setup">
    GitHub integration (available now)
  </Card>

  <Card title="CLI Installation" icon="terminal" href="/cli/installation">
    Scan any repo via CLI
  </Card>

  <Card title="CI/CD Integration" icon="gear" href="/cli/ci-cd">
    Add to Bitbucket Pipelines
  </Card>

  <Card title="GitLab" icon="gitlab" href="/gitlab/coming-soon">
    GitLab integration status
  </Card>
</CardGroup>