How to connect your VCS - Github

Last updated: September 8, 2025

Integrating Spacelift with GitHub enables you to manage your infrastructure efficiently, leveraging GitHub's powerful version control capabilities. This integration provides seamless connectivity between your code repository and Spacelift, allowing you to automate and manage infrastructure as code (IaC) workflows.

For the full detailed guide, visit the GitHub Integration Documentation.

Benefits of Using GitHub Integration

  1. Streamlined Workflow: Automate your infrastructure management directly from GitHub, leveraging pull requests and merge workflows.

  2. Enhanced Security: Utilize GitHub's security features to manage access and permissions.

  3. Ease of Use: Simple setup and configuration through GitHub Marketplace or custom applications.

Steps to Set Up GitHub Integration

  1. Setting Up the Integration with the Marketplace app (recommended):

    • The easiest way to connect your GitHub account (personal or organization) is to install the Spacelift application from the GitHub Marketplace.

    • Navigate to the GitHub Marketplace and search for Spacelift.

    • Select the GitHub account where you want to install the Spacelift application and click Install it for free.

    • On the installation page, review the required permissions and select which repositories should be available to Spacelift.

    • Click Install to complete the installation.

    More details are available in the Setup Guide.

  2. Using the Custom Application:

    • If using the Marketplace application is not an option, you can set up a custom GitHub application.

    • Navigate to the Source code page in Spacelift, click on Set up integration, and choose GitHub.

    • You will be presented with two options: Wizard or Manual setup. The wizard is the easiest and recommended method.

    • Follow the wizard steps, then you will be redirected to GitHub to create the application.

    • Once created, you will be redirected back to Spacelift to finish the integration.

    More details are available in the Custom Application Setup.

  3. Installing the Custom Application:

    • After creating a GitHub App and configuring it in Spacelift, install your App in one or more accounts or organizations.

    • You can use the shortcut link in Spacelift UI or manually navigate to it in GitHub.

    • In the GitHub Apps page in your account settings, click on Edit next to your App.

    • Go to the Install App section, click on Install next to the account you want Spacelift to access, and choose whether to allow Spacelift access to all repositories or only certain ones.

    More details are available in the Installing the Custom Application.