Convert a Linux package CE instance to EE

{{< details >}}

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab Self-Managed

{{< /details >}}

You can convert an existing Linux package instance from Community Edition (CE) to Enterprise Edition (EE). To convert the instance, you install the EE Linux package on top of the CE instance.

You don’t need the same version of CE to EE. For example, CE 17.0 to EE 17.1 should work. However, upgrading the same version (for example, CE 17.1 to EE 17.1) is recommended.

{{< alert type=”warning” >}}

After you convert from EE from CE, don’t revert back to CE if you plan to go to EE again. Reverting back to CE can cause database issues that may require Support intervention.

{{< /alert >}}

Convert from CE to EE

To convert a Linux package CE instance to EE:

  1. Make a GitLab backup.

  2. Find the installed GitLab version:

    {{< tabs >}}

    {{< tab title=”Debian/Ubuntu” >}} 

    sudo apt-cache policy gitlab-ce | grep Installed

    Note down the returned version.

    {{< /tab >}}

    {{< tab title=”CentOS/RHEL” >}} 

    sudo rpm -q gitlab-ce

    Note down the returned version.

    {{< /tab >}}

    {{< /tabs >}}

  3. Add the gitlab-ee Apt or Yum repository. These commands find your OS version and automatically set up the repository. If you are not comfortable installing the repository through a piped script, you can first check the script’s contents.

    {{< tabs >}}

    {{< tab title=”Debian/Ubuntu” >}} 

    curl --silent "https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh" | sudo bash

    {{< /tab >}}

    {{< tab title=”CentOS/RHEL” >}} 

    curl --silent "https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh" | sudo bash

    {{< /tab >}}

    {{< /tabs >}}

    To use dpkg or rpm instead of using apt-get or yum follow Upgrade using a manually downloaded package.

  4. Install the gitlab-ee Linux package. The install automatically uninstalls the gitlab-ce package on your GitLab.

    {{< tabs >}}

    {{< tab title=”Debian/Ubuntu” >}} 

    ## Make sure the repositories are up-to-date
sudo apt-get update

## Install the package using the version you wrote down from step 1
sudo apt-get install gitlab-ee=17.1.0-ee.0

## Reconfigure GitLab
sudo gitlab-ctl reconfigure

    {{< /tab >}}

    {{< tab title=”CentOS/RHEL” >}} 

    ## Install the package using the version you wrote down from step 1
sudo yum install gitlab-ee-17.1.0-ee.0.el9.x86_64

## Reconfigure GitLab
sudo gitlab-ctl reconfigure

    {{< /tab >}}

    {{< /tabs >}}

  5. Add your license to activate Enterprise Edition.

  6. Confirm that GitLab is working as expected, then you can remove the old Community Edition repository:

    {{< tabs >}}

    {{< tab title=”Debian/Ubuntu” >}} 

    sudo rm /etc/apt/sources.list.d/gitlab_gitlab-ce.list

    {{< /tab >}}

    {{< tab title=”CentOS/RHEL” >}} 

    sudo rm /etc/yum.repos.d/gitlab_gitlab-ce.repo

    {{< /tab >}}

    {{< /tabs >}}

  7. Optional. Set up the Elasticsearch integration to enable advanced search.

That’s it! You can now use GitLab Enterprise Edition! To upgrade to a newer version, follow Upgrading Linux package instances.

Revert back to CE

For information on reverting an EE instance to CE, see how to revert from EE to CE.