Open navClose nav

Connecting to a Source Provider

Forestry saves changes to your content by committing back to your Git repository. Adding a site to Forestry first requires that the source code for your site is available through one of our supported source providers. When setting up a new site in Forestry, you will be prompted to connect to your preferred source provider to link your repository.

Currently, Forestry supports the use of Github, GitLab, and Bitbucket as source providers.

Quick Setup via OAuth

This is the recommeded way to connect your repository. Forestry will connect to your Git provider and automatically configure your repository to work with Forestry.

https://res.cloudinary.com/forestry-demo/image/fetch/c_limit,dpr_auto,f_auto,q_80,w_640/https://forestry.io/uploads/2018/08/addsite-w-quick-setup.png

After selecting your Git provider, ensure the Quick Setup via OAuth toggle is activated and click Next. You will be prompted to authenticate with the selected provider if not already logged in.

Detailed Quick Setup Guides

Due to some issues with the Bitbucket API, quick setup is not currently available for Bitbucket projects. Please refer to the manual setup documentation for instructions on setting up your Bitbucket project with Forestry.

Manual Setup

You may opt to manually setup your source provider by deactivating the Quick Setup via OAuth toggle.

With manual setup, you will need to specify the repository URL to Forestry, and add Forestry’s SSH key and webhook to your source provider.

Read the full manual setup documentation


Last updated on August 27, 2018