Skip to main content
This guide covers the setup requirements for connecting Version Control Systems (VCS) with Bytebase.
For understanding network patterns and external access options, see the Network Architecture guide.

​
Bytebase Cloud

No installation required for cloud VCS providers:
  • GitHub.com
  • GitLab.com
  • Bitbucket Cloud
  • Azure DevOps Services
These services connect directly to Bytebase Cloud.

​
Self-Hosted GitLab

  • Install a GitLab Runner on your GitLab server
  • Ensure your VPC firewall rules allow connections between Self-Hosted GitLab and Bytebase Cloud

​
Bytebase Self-Host

Self-hosted Bytebase requires specific setup based on your VCS provider.

​
Cloud VCS Providers

When using cloud VCS with self-hosted Bytebase, you need a self-hosted runner: GitHub.com GitLab.com
  • Install a GitLab Runner
  • Register runner with your GitLab.com project
Bitbucket Cloud Azure DevOps Services

​
Self-Hosted GitLab

  • Install a GitLab Runner on your GitLab server
  • Ensure VPC connectivity between GitLab and Bytebase servers
  • Network policies allow communication
  • If your GitLab runner lacks internet access, pre-load the bytebase-action Docker image

​
Local Testing

To expose local Bytebase for testing with cloud VCS services, use reverse proxy tools like ngrok. See Network Architecture guide for setup details.
For development and testing only. Never use in production.