Skip to main content

Deployment on Virtual Machine

The Git Activity Gatherer connects to Git providers (GitHub, GitLab, Bitbucket, Azure Repos), discovers and iterates repositories, extracts analytics and metadata, and exports results to object storage (S3) or SFTP. The service runs as a single containerized application on a Linux host.

Dedicated On-Prem Machine Specs​

1. Hardware Requirements​

Recommended:

ResourceSpec
CPU16 vCPU
Memory32 GB RAM
Storage1 TB+ SSD

Disk breakdown:

  • Application & images: ~10 GB
  • Cache/working clones: 100—800 GB
  • Logs: 10—20 GB
  • Buffer/headroom: +20—30%

2. Operating System Requirements (64-bit only)​

Supported:

  • Ubuntu 20.04 LTS, 22.04 LTS
  • Debian 10/11 (or newer stable)
  • RHEL/Rocky 8+
  • CentOS Stream 8—9
  • Amazon Linux 2 / 2023

Required OS features: systemd, 64-bit kernel (≥ 3.10), working DNS and NTP, SSD storage recommended.

3. Runtime Requirements​

  • Docker Engine: 20.10+ (24.x recommended)
  • Service user in docker group or sudo for Docker
  • /var/run/docker.sock accessible to the service user

4. Network & Firewall Requirements​

The service is outbound-only. No public inbound ports are required.

Outbound (required):

  • 443/TCP — HTTPS to provider APIs, Git operations, Docker image pulls
  • 53/TCP+UDP — DNS resolution

Outbound (optional):

  • 22/TCP — SFTP upload
  • 80/TCP — HTTP to on-prem/legacy endpoints
  • 123/UDP — NTP

Inbound (optional):

  • 22/TCP — SSH admin (restrict to trusted IPs)
  • 8080/TCP — Local health endpoint (bind to 127.0.0.1 only)

Granting PM Tool & Git Access​

Please provide the following for each platform:

  • URL to your PM and Git services
  • Username for both services
  • Password or access token for authentication
note

We only require read-access permissions.