Supported Operating Systems

  • Docker ( recommended )
  • Linux
  • Windows ( beta/dev )

Supported Databases

  • MariaDB 10.3+
  • Postgres 11+ ( recommended )
  • SQL Server 2017+

We do not support MySQL.

Supported Storage

  • Local Disk
  • NFS
  • SMB
  • S3 Compatible Object Stores such as Minio ( Future/Coming Soon )

Note

For Atlassian products, we highly recommend an alternate to AWS such as Azure or GCP or on-premise object storage. Atlassian products are hosted on AWS and in the event of an AWS BCP Scenario, there's a high chance Object Storage is impacted too. Always use alternate or multiple clouds.

Network Requirements

  • A Reverse Proxy, Ingress Gateway/Controller or API Gateway accessible to on the Internet
  • A fast internet connection ( at least 100mbps )

We highly recommend that various firewalls and ACLs are deployed. Traffic from the internet originates from Atlassian Cloud, therefor their IP ranges are a great place to start here Atlassian Networks and Domains

Tunnels like Ngrok or CloudFlare tunnels are also viable solutions.

Firewalls

  • TCP/8080 ( Inbound ) - BCP Controller Default Port
  • TCP/443 ( Outbound ) - Access to *.atlassian.net HTTPS/REST APIs

Additional Domains

The BCP Controller is licensed via https://keygen.sh, please ensure HTTPS traffic is permitted these URLS

  • https://api.keygen.sh

The Controller must be able to validate its license against this service for various entitlements and features. The controller will not startup if this is not accessible, but has a grace period once registered. More detail on keygen.sh can be found here

Site Sizing

  • Small Sites: 1-500 Users
  • Medium: 500-2000 Users
  • Large 2000-50,000 Users
  • Small: 1vCPU/1GB RAM
  • Medium: 2vCPU/2GB RAM
  • Large: 8vCPU/8GB RAM

Repo Count + Size are various factors for Git workloads. Ideally, the more Memory and CPU applied allows for greater concurrency of operations.

  • Small: 4vCPU/16GB RAM
  • Medium 16vCPU/72GB RAM
  • Large: 32vCPU/128GB+ RAM

Note

We fork Git processes using the C++ version of Git. Cloning repos such as the linux kernel can use upwards of 3cpus and 4GB of memory per clone. You can limit concurrency detailed in the environment configuration.