Open navClose nav



This guide assumes you already have an existing BitBucket account and repository with a Jekyll or Hugo project. If you don’t have an existing project, check out our Quick start guide, which contains guides and resources for building your first static site.

Forestry’s allows you to import your static site through BitBucket repositories. This allows Forestry to sync any changes made by editors in Forestry to be comitted back to BitBucket. This also allows developers to work on your website on their local machine, and have all changes by synced back to Forestry.

Importing from BitBucket

To import a site with BitBucket, login to Forestry and follow these instructions:,dpr_auto,f_auto,q_80,w_640/

From the dashboard, click “Add Site”. In the modal the opens, choose “Import existing site”.,dpr_auto,f_auto,q_80,w_640/

Choose the static site generator your site is built with from the dropdown, and then press “Next”.,dpr_auto,f_auto,q_80,w_640/

Now, choose “BitBucket” from the list of options.,dpr_auto,f_auto,q_80,w_640/

This will redirect you to BitBucket and prompt you to enter your login credentials if you are not already logged in.

In order to import a site from BitBucket, you will need admin permissions for the repository. This is because Forestry needs to add a webhook to your repository in order to watch for changes.,dpr_auto,f_auto,q_80,w_640/

Once authorized, you will be redirected back to Forestry to choose the repository you wish to import. From the dropdowns, choose your repository and the branch you would like to import, and then press “Next”.,dpr_auto,f_auto,q_80,w_640/

If Forestry can’t locate your site’s config file inside of the root of your project, you’ll be prompted to provide the directory it is located in.,dpr_auto,f_auto,q_80,w_640/

Tell us what your site should be named inside of Forestry, as well as an optionally provide a URL to the public location of your website, and then click Next.,dpr_auto,f_auto,q_80,w_640/

In the final step, you’ll be prompted to choose a hosting provider. Choose “Commit to source repo only” to have Forestry commit all changes back to your repository, or click Skip this step.

Last updated on December 31, 2017