Gitlab hero border pattern left svg Gitlab hero border pattern right svg

GitLab Scaling and High Availability

GitLab is a modular, highly scalable application distributed in a variety of packaged formats. Properly architected it can provide for companies with fewer than 10 employees to companies with hundreds of thousands.

This page discusses some of the high-level considerations necessary when you’re deciding which solution is right for your business needs and budget restrictions.

For technical details, please see our Scaling and High Availability page.

GitLab provides a service that is usually essential to most organizations. Therefore, any downtime should be short and planned. Through our Omnibus distribution GitLab provides a reliable service even on a single server without special configuration. As your organization grows, GitLab has the flexibility to expand according to your business needs.

For example,

Properly configured, GitLab can address all of the above cases.

Keep in mind that all solutions come with a trade-off between cost/complexity and uptime. The more uptime you want, the more complex the solution. And the more complex the solution, the more work is involved in setting up and maintaining it. Complex requirements require an investment in time and resources, and any architecture should balance the costs against the benefits.


What's on this page


What are my needs?

The two questions that you need to ask yourself are:

  1. What are my specific needs for GitLab availability?
  2. What complexity level can my organization handle?

GitLab architectures can range from a simple single-node installation to a highly complex and costly primary-primary highly available configurations. When it comes to High Availability, there is no way to split between an increase in complexity and an increase in cost.

We recommend that you thoroughly analyze the benefits of an HA solution against its costs. It is important that you always choose something that you have experience with and will test regularly.

A badly implemented HA solution causes more downtime than it solves.

It is more cost effective to go from a simple solution to a more complex one than the other way around. Therefore, we suggest you work your way up from the simplest solution and see what works best for you.

Please get in touch

Helping you choose the configuration that is right for your business is something we take very seriously at GitLab. The information we provide here is a rough guide designed to help you get a feel for the required resources and expertise required to scale GitLab appropriately. When it comes to your specific situation, we prefer to assess it in its context. We strongly suggest you get in touch with us before setting it up. Support for HA and Geo are included with GitLab Premium and Ultimate. If you have any questions please contact us.


This page can be downloaded as PDF.