Skip to content

OpenShift support

OpenShift - GitLab compatibility can be addressed in three different aspects. This page helps navigating between these aspects and provides introductory information for getting started with OpenShift and GitLab.

What is OpenShift

OpenShift helps you to develop, deploy, and manage container-based applications. It provides you with a self-service platform to create, modify, and deploy applications on demand, thus enabling faster development and release life cycles.

Use OpenShift to run GitLab self-managed

Running GitLab within an OpenShift cluster is officially supported using the GitLab Operator. You can learn more on setting up GitLab on OpenShift on the GitLab Operator's documentation. Some components (documented on the GitLab Operator doc) are not supported yet.

Use OpenShift to run a GitLab Runner Fleet

The GitLab Operator does not include the GitLab Runner. To install and manage a GitLab Runner fleet in an OpenShift cluster, use the GitLab Runner Operator.

Deploy to and integrate with OpenShift from GitLab

Deploying custom or COTS applications on top of OpenShift from GitLab is supported using the GitLab agent.

Unsupported GitLab features


When using OpenShift to run a GitLab Runner Fleet, we do not support some GitLab features given OpenShift's security model. Features requiring Docker-in-Docker might not work.

For Auto DevOps, the following features are not supported yet:

For Auto Build, there's a possible workaround using kaniko. You can check the progress of the implementation in this issue.