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.
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.
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.
Caught a mistake or want to contribute to the docs? Edit this page on Github!