ConnectorsSetup guides
Bitbucket
Repository files across selected branches.
What it brings in
Repository files across selected branches.
Credentials
An app password with repository read permission. Bitbucket → Personal settings → App passwords. Use your Bitbucket username, not your email.
Settings
| Setting | What it is |
|---|---|
app_password | App password |
include_extensions | File extensions to include |
max_files_per_repo | Cap on files per repository |
repos | Repositories to sync |
username | Username |
workspace | Workspace |
Adding it
- Connectors → Add connector → Bitbucket
- Decide global or personal — this is the one choice that is awkward to change later
- Enter the credentials above
- Narrow the scope before the first sync
- Save. Syncing starts immediately
Nothing is searchable until the first sync finishes. Progress is on the connector page.
If it fails
The connector page shows the error. The usual causes are an expired credential, a permission changed on the far side, or — for Bitbucket — access not having been granted to the specific content yet.