Docs

Manage Git integrations

Connect your Git accounts to Northflank so you can build and deploy from your repositories.

You can connect multiple accounts from GitHub, GitLab, Bitbucket, and other supported Git services. You can also connect a self-hosted Git service.

Add a Git account

You can connect a Git account to your team from the Integrations section in your team dashboard.

Click here to connect a Git account.
  1. In your team dashboard, click Integrations.
  2. Click Git.
  3. Click Link next to the Git service you want to connect.
  4. Follow the instructions for the Git service.

For GitHub, you can choose which GitHub account or organisation to connect. For other Git services, Northflank connects the account you are currently signed in to.

Once connected, you can use repositories from the account to build and deploy services on Northflank.

Add a self-hosted VCS

You can connect a self-hosted Git service to Northflank if your repositories are hosted on your own infrastructure.

Click here to add a self-hosted VCS.
  1. In your team dashboard, click Integrations.
  2. Click Git.
  3. Click Add a self-hosted VCS.
  4. Enter a name for the VCS.
  5. Select the VCS type.
  6. Enter the VCS provider URL and Application ID.
  7. Enter the Secret.
  8. Click Submit.

After connecting your self-hosted VCS, you can configure how team members can use it.

Add a self-hosted GitLab instance

To connect a self-hosted GitLab instance, first create an OAuth application in GitLab.

Create a new OAuth application at:

  • [GIT_HOSTNAME]/profile/applications
  • [GIT_HOSTNAME]/admin/applications if you are an administrator

Give the application the api scope and set the Redirect URI as specified on Northflank.

Save the OAuth application, then enter the root domain of your self-hosted GitLab instance, Application ID, and Secret in Northflank.

Self-hosted VCS settings

You can update the settings of your self-hosted VCS:

  1. In your team dashboard, click Integrations.

  2. Click Git.

  3. Click the setting button on the self-hosted VCS you want to configure.

  4. Update the VCS provider URL, Application ID, and Secret.

  5. Click Update self-hosted settings.

Restrict repository access

You can restrict which repositories team members can access when connecting Git accounts to Northflank.

For GitHub, you can manage repository access when installing the Northflank GitHub app. You can choose which GitHub account or organisation to install the app on and which repositories the app can access.

For GitLab and Bitbucket, you can restrict access to specific namespaces from the account settings in Northflank.

For self-hosted VCS, you can restrict access to specific owners from the self-hosted VCS settings.

© 2026 Northflank Ltd. All rights reserved.

northflank.com / Terms / Privacy / feedback@northflank.com