Sometimes you may want to use an external project from within your main repository, e.g. a library that generates code in your web app. Git addresses this issue with submodules that allow you to deploy changes from both main and external repositories.


The repository is cloned to the filesystem on two occasions:

  • during the first pipeline run
  • on the first run after clearing the pipeline's cache

Any other run only fetches the latest changes.

Supported protocols

If you use submodules in your project, Buddy will fetch them alongside the main repository. Currently, the following protocols are supported:

For HTTPS submodules, make sure that the submodule is a repository within the same integration, or it will not work. In other words, if your repository is hosted on GitHub you can only use repositories from the currently synchronized GitHub account.

Enabling submodules

By default, submodule deployments are disabled in Buddy. To enable them, go to the project settings and check the option in the Submodules field:

Submodules settings and locationSubmodules settings and location

Last modified on November 8, 2022


Not sure how to configure a pipeline for your process? Reach out on the live-chat or contact support

Get Started

Sign up for free and deploy your project in less than 10 minutes.