GitLab scaling and reference architectures

Sizing self-managed GitLab with the published reference architectures and choosing how Gitaly, PostgreSQL, Redis and Sidekiq scale as users and CI load grow.

GitLab 3,000-user high availability architecture

The smallest standard HA layout: node roles for Rails, Sidekiq, Gitaly Cluster, Patroni PostgreSQL, Redis Sentinel and Consul, the scaled-down variant and what zero-downtime upgrades require of it.

Gitaly Cluster (Praefect) vs sharded Gitaly

Deciding whether repository-level HA justifies Gitaly Cluster: synchronous replication and failover against its known limitations, no snapshot backups, Kubernetes beta status and the sharded alternative.

Scaling GitLab for large monorepos

How large monorepos and heavy CI concurrency change GitLab sizing: Gitaly resources, starting large and scaling down, and the workloads GitLab lists as performance risks.

Single-node GitLab for up to 2,000 users

When one Linux package server is enough: CPU, memory and storage baselines, automated backups as the recovery plan and the signals that it is time for the 3K HA design.

Talk to our team.

Tell us what you're working on, whether it's a deployment, an audit, a security test or a cyber range. You'll speak with an engineer who can help you scope it.

  • 30-minute call: free, with no obligation.
  • NDA on request: we can sign before you share details.
  • Clear next steps: a scope and plan after the call.