{"_id":"590a04f3ed80861900cbc754","__v":0,"category":{"_id":"590a04f3ed80861900cbc738","__v":0,"version":"590a04f2ed80861900cbc737","project":"55b2d5baa74a380d00e290c4","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-07-25T00:29:31.009Z","from_sync":false,"order":0,"slug":"quickstart","title":"Get Started"},"project":"55b2d5baa74a380d00e290c4","user":"55b2d5626862a10d00887af9","parentDoc":null,"version":{"_id":"590a04f2ed80861900cbc737","project":"55b2d5baa74a380d00e290c4","__v":4,"createdAt":"2017-05-03T16:27:30.085Z","releaseDate":"2017-05-03T16:27:30.085Z","categories":["590a04f3ed80861900cbc738","590a04f3ed80861900cbc739","590a04f3ed80861900cbc73a","590a04f3ed80861900cbc73b","590a04f3ed80861900cbc73c","590a04f3ed80861900cbc73d","590a04f3ed80861900cbc73e","590a04f3ed80861900cbc73f","590a04f3ed80861900cbc740","590a04f3ed80861900cbc741","590a04f3ed80861900cbc742","590a04f3ed80861900cbc743","590a04f3ed80861900cbc744","590a04f3ed80861900cbc745","590a04f3ed80861900cbc746","590a04f3ed80861900cbc747","590a04f3ed80861900cbc748","590a04f3ed80861900cbc749","590a04f3ed80861900cbc74a","590a04f3ed80861900cbc74b","590a04f3ed80861900cbc74c","590a04f3ed80861900cbc74d","59124949de13f61900336a7a","5914b04e7c2c552d008b7104","5914b47242c6a22300b9dc20"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"7.0.0","version":"7"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-10-16T06:43:43.247Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":6,"body":"Connecting with Bitbucket Server grants buddybuild access to your repository so that it can build your app when you push code to your repository. Connecting also grants buddybuild API access to manage webhooks for you, generate commit status, enables the pull request flow, synchronizes access control for team management and more.\n\nEach member of your team that uses buddybuild should go through this guide to connect with Bitbucket Server. This is encouraged so that you can take advantage of team management features.\n\n**Prerequisite:** First make sure you have created an account with buddybuild by signing up with [GitHub](http://docs.buddybuild.com/docs/signing-up-with-github), [Bitbucket](http://docs.buddybuild.com/docs/signing-up-with-bitbucket), [GitLab](http://docs.buddybuild.com/docs/signing-up-with-gitlab) or by [email](http://docs.buddybuild.com/docs/signing-up-with-ssh#section-step-1-sign-up-with-email).\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Quick links: Connect with Bitbucket Server in 3 easy steps!\",\n  \"body\": \"[Step 1: Install the buddybuild add-on from the Atlassian Marketplace](doc:connect-with-bitbucket-server#section-step-1-install-the-buddybuild-add-on-from-the-atlassian-marketplace)\\n[Step 2: Generate your personal access token](doc:connect-with-bitbucket-server#section-step-2-generate-your-personal-access-token)\\n[Step 3: Connect your Bitbucket Server account](doc:connect-with-bitbucket-server#section-step-3-connect-your-bitbucket-server-account)\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Step 1: Install the buddybuild add-on from the Atlassian Marketplace\"\n}\n[/block]\nThe following one-time setup must be done as a Bitbucket Server system administrator.\n\nFrom the Bitbucket Server dashboard click on the Administration **setting cog**. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/e517eed-Bitbucket_Server-1.png\",\n        \"Bitbucket Server-1.png\",\n        1500,\n        394,\n        \"#1c487b\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nUnder the **Add-ons** section, select **Find new add-ons.**\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/35447e1-Bitbucket_Server-2.png\",\n        \"Bitbucket Server-2.png\",\n        1500,\n        833,\n        \"#868f98\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nNext, search for **buddybuild** and click **Install**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/92ecdcc-Bitbucket_Server-3.png\",\n        \"Bitbucket Server-3.png\",\n        1500,\n        450,\n        \"#e0e1e1\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nThe add-on should take a few seconds to install. Once the installation is complete, you'll see the following message.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/96b5e24-Bitbucket_Server-4.png\",\n        \"Bitbucket Server-4.png\",\n        1500,\n        786,\n        \"#7e7f7f\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nYou can choose to remove the installation at any time by clicking Uninstall on the Manage add-ons page.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/6b8414b-Bitbucket_Server-5.png\",\n        \"Bitbucket Server-5.png\",\n        1500,\n        582,\n        \"#e6eaed\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Step 2: Generate your personal access token\"\n}\n[/block]\nVisit the buddybuild plugin settings page by clicking on **buddybuild** in the left hand navigation. (You may need to refresh the page for this link to appear if you have just installed the plugin).\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3d520fc-Bitbucket_Server-6.png\",\n        \"Bitbucket Server-6.png\",\n        1500,\n        390,\n        \"#dddede\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nUnder the section **Getting started**, click on **Connect Personal Access Token**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/21bf7d4-Bitbucket_Server-7.png\",\n        \"Bitbucket Server-7.png\",\n        1500,\n        548,\n        \"#e2e1e0\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nNext, generate your personal access token by clicking on **Generate token.**\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/5247fb7-Bitbucket_Server-7.png\",\n        \"Bitbucket Server-7.png\",\n        1500,\n        786,\n        \"#e9eff0\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n**Copy your personal access token** and follow [step 3](doc:connect-with-bitbucket-server#section-step-3-connect-your-bitbucket-server-account) below to connect your Bitbucket Server repository with buddybuild. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/1c3f15b-Bitbucket_Server-8.png\",\n        \"Bitbucket Server-8.png\",\n        1500,\n        786,\n        \"#eaefe4\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Step 3: Connect your Bitbucket Server account\"\n}\n[/block]\nTo connect your Bitbucket Server account, launch the buddybuild dashboard and [Add a New App](https://dashboard.buddybuild.com/apps/wizard/build/select-repo).\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/37488ca-Bitbucket_Server-11.png\",\n        \"Bitbucket Server-11.png\",\n        1500,\n        718,\n        \"#e9f0f2\"\n      ]\n    }\n  ]\n}\n[/block]\nNext, select [Connect another source code provider](https://dashboard.buddybuild.com/apps/wizard/build/select-source). \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/01259fa-First_Build_-_Select_Source_-_Gitlab_Self-hosted.png\",\n        \"First Build - Select Source - Gitlab Self-hosted.png\",\n        1500,\n        689,\n        \"#d7d9da\"\n      ]\n    }\n  ]\n}\n[/block]\nSelect **Bitbucket Server**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/9d83fcc-Bitbucket_Server-10.png\",\n        \"Bitbucket Server-10.png\",\n        1500,\n        781,\n        \"#d3d7d9\"\n      ]\n    }\n  ]\n}\n[/block]\nNext, enter your Bitbucket Server endpoint and the Personal Access token you generated in [step 2](doc:connect-with-bitbucket-server#section-step-2-generate-your-personal-access-token), and click **Connect your Bitbucket Server repository**. \n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"More about your Bitbucket Server endpoint and personal access token\",\n  \"body\": \"Your Bitbucket Server endpoint is the hostname part of the URL when you visit your repositories in Bitbucket Server. Copy the hostname part of your Bitbucket Server server URL, which often looks something like `git.mycompany.com`. If your server uses a non-default HTTPS port, then please also copy the port part of the URL. For example, `git.mycompany.com:1234`.\\n\\n**Do you have a private DNS?**\\nYour Bitbucket Server hostname must be publicly addressable on the internet. If you use private DNS for your Bitbucket Server installation, then you can use the IP address of the server instead.\\n\\n**Do you have a firewall configured?**\\nIf your network infrastructure restricts inbound access over HTTPS from a set of IP addresses, then you may need to whitelist the IP addresses used by the buddybuild fleet. Please contact us for the latest CIDR range used by buddybuild.\\n\\n**Create a personal access token**\\nReview [Step 2](doc:connect-with-bitbucket-server#section-step-2-generate-your-personal-access-token) to create your personal access token.\"\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/f9ad0be-Bitbucket_Server-13b.png\",\n        \"Bitbucket Server-13b.png\",\n        1500,\n        829,\n        \"#2a88be\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nThe dialog should close and display a list of your repositories. At this point you have successfully completed connecting buddybuild with Bitbucket Server!","excerpt":"","slug":"connect-with-bitbucket-server","type":"basic","title":"Connect with Bitbucket Server"}

Connect with Bitbucket Server


Connecting with Bitbucket Server grants buddybuild access to your repository so that it can build your app when you push code to your repository. Connecting also grants buddybuild API access to manage webhooks for you, generate commit status, enables the pull request flow, synchronizes access control for team management and more. Each member of your team that uses buddybuild should go through this guide to connect with Bitbucket Server. This is encouraged so that you can take advantage of team management features. **Prerequisite:** First make sure you have created an account with buddybuild by signing up with [GitHub](http://docs.buddybuild.com/docs/signing-up-with-github), [Bitbucket](http://docs.buddybuild.com/docs/signing-up-with-bitbucket), [GitLab](http://docs.buddybuild.com/docs/signing-up-with-gitlab) or by [email](http://docs.buddybuild.com/docs/signing-up-with-ssh#section-step-1-sign-up-with-email). [block:callout] { "type": "info", "title": "Quick links: Connect with Bitbucket Server in 3 easy steps!", "body": "[Step 1: Install the buddybuild add-on from the Atlassian Marketplace](doc:connect-with-bitbucket-server#section-step-1-install-the-buddybuild-add-on-from-the-atlassian-marketplace)\n[Step 2: Generate your personal access token](doc:connect-with-bitbucket-server#section-step-2-generate-your-personal-access-token)\n[Step 3: Connect your Bitbucket Server account](doc:connect-with-bitbucket-server#section-step-3-connect-your-bitbucket-server-account)" } [/block] [block:api-header] { "title": "Step 1: Install the buddybuild add-on from the Atlassian Marketplace" } [/block] The following one-time setup must be done as a Bitbucket Server system administrator. From the Bitbucket Server dashboard click on the Administration **setting cog**. [block:image] { "images": [ { "image": [ "https://files.readme.io/e517eed-Bitbucket_Server-1.png", "Bitbucket Server-1.png", 1500, 394, "#1c487b" ], "sizing": "full" } ] } [/block] Under the **Add-ons** section, select **Find new add-ons.** [block:image] { "images": [ { "image": [ "https://files.readme.io/35447e1-Bitbucket_Server-2.png", "Bitbucket Server-2.png", 1500, 833, "#868f98" ], "sizing": "full" } ] } [/block] Next, search for **buddybuild** and click **Install**. [block:image] { "images": [ { "image": [ "https://files.readme.io/92ecdcc-Bitbucket_Server-3.png", "Bitbucket Server-3.png", 1500, 450, "#e0e1e1" ], "sizing": "full" } ] } [/block] The add-on should take a few seconds to install. Once the installation is complete, you'll see the following message. [block:image] { "images": [ { "image": [ "https://files.readme.io/96b5e24-Bitbucket_Server-4.png", "Bitbucket Server-4.png", 1500, 786, "#7e7f7f" ], "sizing": "full" } ] } [/block] You can choose to remove the installation at any time by clicking Uninstall on the Manage add-ons page. [block:image] { "images": [ { "image": [ "https://files.readme.io/6b8414b-Bitbucket_Server-5.png", "Bitbucket Server-5.png", 1500, 582, "#e6eaed" ], "sizing": "full" } ] } [/block] [block:api-header] { "title": "Step 2: Generate your personal access token" } [/block] Visit the buddybuild plugin settings page by clicking on **buddybuild** in the left hand navigation. (You may need to refresh the page for this link to appear if you have just installed the plugin). [block:image] { "images": [ { "image": [ "https://files.readme.io/3d520fc-Bitbucket_Server-6.png", "Bitbucket Server-6.png", 1500, 390, "#dddede" ], "sizing": "full" } ] } [/block] Under the section **Getting started**, click on **Connect Personal Access Token**. [block:image] { "images": [ { "image": [ "https://files.readme.io/21bf7d4-Bitbucket_Server-7.png", "Bitbucket Server-7.png", 1500, 548, "#e2e1e0" ], "sizing": "full" } ] } [/block] Next, generate your personal access token by clicking on **Generate token.** [block:image] { "images": [ { "image": [ "https://files.readme.io/5247fb7-Bitbucket_Server-7.png", "Bitbucket Server-7.png", 1500, 786, "#e9eff0" ], "sizing": "full" } ] } [/block] **Copy your personal access token** and follow [step 3](doc:connect-with-bitbucket-server#section-step-3-connect-your-bitbucket-server-account) below to connect your Bitbucket Server repository with buddybuild. [block:image] { "images": [ { "image": [ "https://files.readme.io/1c3f15b-Bitbucket_Server-8.png", "Bitbucket Server-8.png", 1500, 786, "#eaefe4" ], "sizing": "full" } ] } [/block] [block:api-header] { "title": "Step 3: Connect your Bitbucket Server account" } [/block] To connect your Bitbucket Server account, launch the buddybuild dashboard and [Add a New App](https://dashboard.buddybuild.com/apps/wizard/build/select-repo). [block:image] { "images": [ { "image": [ "https://files.readme.io/37488ca-Bitbucket_Server-11.png", "Bitbucket Server-11.png", 1500, 718, "#e9f0f2" ] } ] } [/block] Next, select [Connect another source code provider](https://dashboard.buddybuild.com/apps/wizard/build/select-source). [block:image] { "images": [ { "image": [ "https://files.readme.io/01259fa-First_Build_-_Select_Source_-_Gitlab_Self-hosted.png", "First Build - Select Source - Gitlab Self-hosted.png", 1500, 689, "#d7d9da" ] } ] } [/block] Select **Bitbucket Server**. [block:image] { "images": [ { "image": [ "https://files.readme.io/9d83fcc-Bitbucket_Server-10.png", "Bitbucket Server-10.png", 1500, 781, "#d3d7d9" ] } ] } [/block] Next, enter your Bitbucket Server endpoint and the Personal Access token you generated in [step 2](doc:connect-with-bitbucket-server#section-step-2-generate-your-personal-access-token), and click **Connect your Bitbucket Server repository**. [block:callout] { "type": "info", "title": "More about your Bitbucket Server endpoint and personal access token", "body": "Your Bitbucket Server endpoint is the hostname part of the URL when you visit your repositories in Bitbucket Server. Copy the hostname part of your Bitbucket Server server URL, which often looks something like `git.mycompany.com`. If your server uses a non-default HTTPS port, then please also copy the port part of the URL. For example, `git.mycompany.com:1234`.\n\n**Do you have a private DNS?**\nYour Bitbucket Server hostname must be publicly addressable on the internet. If you use private DNS for your Bitbucket Server installation, then you can use the IP address of the server instead.\n\n**Do you have a firewall configured?**\nIf your network infrastructure restricts inbound access over HTTPS from a set of IP addresses, then you may need to whitelist the IP addresses used by the buddybuild fleet. Please contact us for the latest CIDR range used by buddybuild.\n\n**Create a personal access token**\nReview [Step 2](doc:connect-with-bitbucket-server#section-step-2-generate-your-personal-access-token) to create your personal access token." } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/f9ad0be-Bitbucket_Server-13b.png", "Bitbucket Server-13b.png", 1500, 829, "#2a88be" ], "sizing": "full" } ] } [/block] The dialog should close and display a list of your repositories. At this point you have successfully completed connecting buddybuild with Bitbucket Server!