# Licensing

bb2gh requires a license to operate. A free license is available for small teams and individual use — no credit card required.

## Get Your Free License

Register for a free license in three steps:

### 1. Register

```bash
bb2gh license register --email you@company.com
```

### 2. Check Your Email

You will receive a license key at the email address you provided. The key looks like:

```
BB2GH-1-eyJ2Ijox...
```

### 3. Activate

```bash
bb2gh license activate BB2GH-1-eyJ2Ijox...
```

Your license is now stored at `~/.bb2gh/license` and bb2gh is ready to use.

## Verify Your License

Check your current license status at any time:

```bash
bb2gh license status
```

## CI/CD Environments

For automated pipelines, set the license key as an environment variable instead of activating it on disk:

```bash
export BB2GH_LICENSE="BB2GH-1-eyJ2Ijox..."
bb2gh migrate --plan plan.json
```

No file is written when using the environment variable.

## Plans

bb2gh offers three plans:

|                     | Free     | Pro                    | Ultimate  |
| ------------------- | -------- | ---------------------- | --------- |
| Repositories        | Up to 50 | 50-2,000 (select plan) | Custom    |
| Workers             | 1        | Up to 4                | Unlimited |
| Enterprise features | -        | -                      | Yes       |

The free plan covers all core migration features. See [Plans & Features](/bb2gh/guides/plans-and-features.md) for a full comparison.

## Need More?

* **Pro** — Parallel workers for faster migrations. Visit [bb2gh.dev/#pricing](https://bb2gh.dev/#pricing) to select your plan.
* **Ultimate** — Batch waves, secrets migration, distributed workers, compliance reports. Contact <sales@n8-group.com>.

## Next Steps

* [Authentication](/bb2gh/getting-started/authentication.md) — Set up Bitbucket and GitHub credentials
* [Plans & Features](/bb2gh/guides/plans-and-features.md) — Full feature comparison
* [License Management](/bb2gh/guides/license-management.md) — Detailed license operations


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://n8-group.gitbook.io/bb2gh/getting-started/licensing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.