Open navClose nav

BitBucket Pages


This guide assumes you already have an existing Forestry account, BitBucket account and a 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.

Getting Started

To deploy a static site to BitBucket pages using Forestry, you must first set up a repository in BitBucket for your site.

Login to BitBucket and create a new repository with the following format:


Be sure to replace _{{accountname}}_ with your BitBucket username.

Configuring Forestry

Once your new repository is created, navigate to the Settings page of your site in Forestry, click the Hosting tab, and set the Connection option to BitBucket.,dpr_auto,f_auto,q_80,w_640/ you haven’t authenticated with BitBucket before, you’ll be prompted to choose “Public Repos” or “Private Repos”. Choose the option the applies to your repository.,dpr_auto,f_auto,q_80,w_640/ 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 web hook to your repository in order to watch for changes.

Once authorized, you will be redirected back to Forestry.,dpr_auto,f_auto,q_80,w_640/, choose your {{}} repository, select the master branch, and then click Save Settings.

From here on, every time you save or publish a page Forestry will build your site and deploy to this branch.

Your site should now be served at http://{{username}}

Last updated on December 31, 2017