{"_id":"590a04f3ed80861900cbc75e","category":{"_id":"590a04f3ed80861900cbc73d","__v":0,"project":"55b2d5baa74a380d00e290c4","version":"590a04f2ed80861900cbc737","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-19T17:56:21.504Z","from_sync":false,"order":5,"slug":"setting-up-a-repository","title":"Setting Up a Repository"},"parentDoc":null,"project":"55b2d5baa74a380d00e290c4","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"},"__v":0,"user":"55b2d5626862a10d00887af9","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-05-09T19:11:46.696Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":8,"body":"If your repository lives in Kiln, you can connect to it via SSH. Buddybuild will automatically generate a secure SSH key for you to install into your source control system. Buddybuild will use this key to clone your repository.\n\nLet's get started!\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Quick Links\",\n  \"body\": \"<a href=\\\"http://docs.buddybuild.com/docs/adding-a-kiln-repository#section-step-1-enter-the-ssh-git-clone-url\\\">Step 1: Enter the SSH Git Clone URL</a>\\n<a href=\\\"http://docs.buddybuild.com/docs/adding-a-kiln-repository#section-step-2-add-the-ssh-key-to-your-kiln-account\\\">Step 2: Add the SSH Key to Your Kiln Account</a>\"\n}\n[/block]\n## Step 1: Enter the SSH Git Clone URL\n\nGo to Kiln and find the repository you would like to connect with buddybuild. Within the main page of that repository, look to the top-right for the **Clone URL**. Click on the dropdown menu and select **SSH**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/BFjNI3QxOw7CkJtJKKPg_Screen%20Shot%202016-05-09%20at%2012.25.33%20PM.png\",\n        \"Screen Shot 2016-05-09 at 12.25.33 PM.png\",\n        \"1447\",\n        \"383\",\n        \"#fa3c3c\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nHighlight and copy the **SSH** clone URL.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/l9vzrmfzQIGZZ1HxKild_Screen%20Shot%202016-05-09%20at%2012.25.58%20PM.png\",\n        \"Screen Shot 2016-05-09 at 12.25.58 PM.png\",\n        \"986\",\n        \"328\",\n        \"#fb3c3c\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nHead over to dashboard, visit [Select source](https://dashboard.buddybuild.com/apps/wizard/build/select-source) and choose **SSH**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/85ae6c4-First_Build_-_Select_Source_-_SSH.png\",\n        \"First Build - Select Source - SSH.png\",\n        1500,\n        800,\n        \"#d3d6d8\"\n      ]\n    }\n  ]\n}\n[/block]\nPaste the SSH URL you copied into the **Git clone URL** field.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/5feef1b-Kiln_-_SSH_-_1.png\",\n        \"Kiln - SSH - 1.png\",\n        1500,\n        765,\n        \"#384f5f\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n## Step 2: Add the SSH Key to Your Kiln Account\n\nHighlight and copy the generated SSH key.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/555190c-Kiln_-_SSH_-_2.png\",\n        \"Kiln - SSH - 2.png\",\n        1500,\n        765,\n        \"#506373\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nNavigate to your Kiln Account by first selecting your account photo, and then select **SSH Keys**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/kI0utr3TlaFWLtGflb7V_Screen%20Shot%202016-05-09%20at%2012.30.36%20PM.png\",\n        \"Screen Shot 2016-05-09 at 12.30.36 PM.png\",\n        \"1068\",\n        \"349\",\n        \"#fb3c3c\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nNext, select **Add a New Key.** \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/d2H6pm2SQKPmQayXhCIg_Screen%20Shot%202016-05-09%20at%202.16.32%20PM.png\",\n        \"Screen Shot 2016-05-09 at 2.16.32 PM.png\",\n        \"1777\",\n        \"713\",\n        \"#ef463f\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nPaste the copied SSH key into the **Public Key** field and enter **Buddybuild** as the name.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/SAe2qbsvSHCpesvsDsbL_Screen%20Shot%202016-05-09%20at%2012.31.26%20PM.png\",\n        \"Screen Shot 2016-05-09 at 12.31.26 PM.png\",\n        \"1576\",\n        \"837\",\n        \"#5ca3ea\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nNext, click **Save Key**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/lg6cQhwqSzyvplFGMrZI_Screen%20Shot%202016-05-09%20at%2012.31.36%20PM.png\",\n        \"Screen Shot 2016-05-09 at 12.31.36 PM.png\",\n        \"1023\",\n        \"286\",\n        \"#fb3c3c\",\n        \"\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"If your project depends on any code in other private git repositories, the SSH key will need to be added to those repositories as well.\",\n  \"title\": \"Private git submodules and private cocoapods\"\n}\n[/block]\nNavigate back to buddybuild and click on the **Build** button.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/c397f16-Kiln_-_SSH_-_3.png\",\n        \"Kiln - SSH - 3.png\",\n        1500,\n        765,\n        \"#384f5f\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nBuddybuild will checkout your project code and kick off a simulator build. The build should finish within a few seconds.\n\nThat's it. You're now connected to buddybuild. The next step is to [invite testers](doc:inviting-testers) to try out your App.","excerpt":"","slug":"adding-a-kiln-repository","type":"basic","title":"Adding a Kiln Repository"}

Adding a Kiln Repository


If your repository lives in Kiln, you can connect to it via SSH. Buddybuild will automatically generate a secure SSH key for you to install into your source control system. Buddybuild will use this key to clone your repository. Let's get started! [block:callout] { "type": "info", "title": "Quick Links", "body": "<a href=\"http://docs.buddybuild.com/docs/adding-a-kiln-repository#section-step-1-enter-the-ssh-git-clone-url\">Step 1: Enter the SSH Git Clone URL</a>\n<a href=\"http://docs.buddybuild.com/docs/adding-a-kiln-repository#section-step-2-add-the-ssh-key-to-your-kiln-account\">Step 2: Add the SSH Key to Your Kiln Account</a>" } [/block] ## Step 1: Enter the SSH Git Clone URL Go to Kiln and find the repository you would like to connect with buddybuild. Within the main page of that repository, look to the top-right for the **Clone URL**. Click on the dropdown menu and select **SSH**. [block:image] { "images": [ { "image": [ "https://files.readme.io/BFjNI3QxOw7CkJtJKKPg_Screen%20Shot%202016-05-09%20at%2012.25.33%20PM.png", "Screen Shot 2016-05-09 at 12.25.33 PM.png", "1447", "383", "#fa3c3c", "" ], "sizing": "full" } ] } [/block] Highlight and copy the **SSH** clone URL. [block:image] { "images": [ { "image": [ "https://files.readme.io/l9vzrmfzQIGZZ1HxKild_Screen%20Shot%202016-05-09%20at%2012.25.58%20PM.png", "Screen Shot 2016-05-09 at 12.25.58 PM.png", "986", "328", "#fb3c3c", "" ], "sizing": "full" } ] } [/block] Head over to dashboard, visit [Select source](https://dashboard.buddybuild.com/apps/wizard/build/select-source) and choose **SSH**. [block:image] { "images": [ { "image": [ "https://files.readme.io/85ae6c4-First_Build_-_Select_Source_-_SSH.png", "First Build - Select Source - SSH.png", 1500, 800, "#d3d6d8" ] } ] } [/block] Paste the SSH URL you copied into the **Git clone URL** field. [block:image] { "images": [ { "image": [ "https://files.readme.io/5feef1b-Kiln_-_SSH_-_1.png", "Kiln - SSH - 1.png", 1500, 765, "#384f5f" ], "sizing": "full" } ] } [/block] ## Step 2: Add the SSH Key to Your Kiln Account Highlight and copy the generated SSH key. [block:image] { "images": [ { "image": [ "https://files.readme.io/555190c-Kiln_-_SSH_-_2.png", "Kiln - SSH - 2.png", 1500, 765, "#506373" ], "sizing": "full" } ] } [/block] Navigate to your Kiln Account by first selecting your account photo, and then select **SSH Keys**. [block:image] { "images": [ { "image": [ "https://files.readme.io/kI0utr3TlaFWLtGflb7V_Screen%20Shot%202016-05-09%20at%2012.30.36%20PM.png", "Screen Shot 2016-05-09 at 12.30.36 PM.png", "1068", "349", "#fb3c3c", "" ], "sizing": "full" } ] } [/block] Next, select **Add a New Key.** [block:image] { "images": [ { "image": [ "https://files.readme.io/d2H6pm2SQKPmQayXhCIg_Screen%20Shot%202016-05-09%20at%202.16.32%20PM.png", "Screen Shot 2016-05-09 at 2.16.32 PM.png", "1777", "713", "#ef463f", "" ], "sizing": "full" } ] } [/block] Paste the copied SSH key into the **Public Key** field and enter **Buddybuild** as the name. [block:image] { "images": [ { "image": [ "https://files.readme.io/SAe2qbsvSHCpesvsDsbL_Screen%20Shot%202016-05-09%20at%2012.31.26%20PM.png", "Screen Shot 2016-05-09 at 12.31.26 PM.png", "1576", "837", "#5ca3ea", "" ], "sizing": "full" } ] } [/block] Next, click **Save Key**. [block:image] { "images": [ { "image": [ "https://files.readme.io/lg6cQhwqSzyvplFGMrZI_Screen%20Shot%202016-05-09%20at%2012.31.36%20PM.png", "Screen Shot 2016-05-09 at 12.31.36 PM.png", "1023", "286", "#fb3c3c", "" ], "sizing": "full" } ] } [/block] [block:callout] { "type": "warning", "body": "If your project depends on any code in other private git repositories, the SSH key will need to be added to those repositories as well.", "title": "Private git submodules and private cocoapods" } [/block] Navigate back to buddybuild and click on the **Build** button. [block:image] { "images": [ { "image": [ "https://files.readme.io/c397f16-Kiln_-_SSH_-_3.png", "Kiln - SSH - 3.png", 1500, 765, "#384f5f" ], "sizing": "full" } ] } [/block] Buddybuild will checkout your project code and kick off a simulator build. The build should finish within a few seconds. That's it. You're now connected to buddybuild. The next step is to [invite testers](doc:inviting-testers) to try out your App.