Build code from a self-hosted VCS

You can connect a Git provider hosted on your own infrastructure.

Webhooks notify Northflank when repository events occur, so configured builds and workflows can run automatically.

1. Open your team's Integrations → Git page.
2. Select Add a self-hosted VCS.
3. Enter a name for the integration.
4. Enter your Git host's root URL under VCS provider URL.

Continue with your provider below. Once connected, you can build from your repositories and manage the integration.

Add a self-hosted GitLab instance

1. Select GitLab Enterprise Edition or Community Edition in Northflank.
2. Create an OAuth application on your GitLab host at /-/user_settings/applications. Administrators can also use /admin/applications.
3. Give the application the api scope.
4. Enable its Confidential control.
5. Set its redirect URI to the exact value shown in Northflank.
6. Enter its Application ID and Secret in Northflank.
7. Select Submit.
8. Authorize Northflank with the GitLab account that can access your repositories.

See GitLab's OAuth application guide for more details.

Add Gitea or Forgejo

Gitea and Forgejo use the same connection flow. Northflank requests read and write access to repositories, including webhooks and commit statuses. The linked account needs repository owner or administrator access to manage webhooks.

Before authorizing access, review the permission behavior for Gitea or Forgejo .

1. Select Gitea / Forgejo in Northflank.
2. Create an OAuth2 application at /user/settings/applications on your Git host.
3. If the provider offers a client-type choice, select a confidential client.
4. Set its redirect URI to the exact value shown in Northflank.
5. Enter its OAuth client ID and OAuth client secret in Northflank.
6. Select Submit.
7. Authorize Northflank with the Git account that can access your repositories.

Add GitHub Enterprise Server

You need permission to create and install a GitHub App for the selected user or organization. App creation and repository installation are separate steps.

The app requests read and write permissions. Before approving installation, review the requested access on GitHub.

1. Select GitHub Enterprise in Northflank.
2. Choose User or Organisation under GitHub App location type.
3. For Organisation, enter the organization name under Application namespace.
4. Select Submit to start GitHub App creation.
5. Complete app creation on your GitHub server.
6. Return to your team's Integrations → Git page.
7. On your self-hosted integration, select Link to start app installation on GitHub.
8. Choose the repositories that the app can access.
9. Complete the installation.

Read more about managing self-hosted VCS services.