ContextQMD
Back to Gitlabhq

Revert from Enterprise Edition to Community Edition

doc/update/convert_to_ee/revert.md

18.11.24.9 KB
Original Source

You can revert your Enterprise Edition (EE) instance back to Community Edition (CE), but must first:

  1. Disable EE-only authentication mechanisms.
  2. Remove EE-only integrations from the database.
  3. Adjust configuration that uses environment scopes.

Turn off EE-only authentication mechanisms

Kerberos is only available on EE instances. You must:

  • Turn off these mechanisms before reverting.
  • Provide a different authentication method to your users.

Remove EE-only integrations from the database

These integrations are only available in the EE codebase:

If you downgrade to CE, you might get something like the following error:

plaintext
Completed 500 Internal Server Error in 497ms (ActiveRecord: 32.2ms)

ActionView::Template::Error (The single-table inheritance mechanism failed to locate the subclass: 'Integrations::Github'. This
error is raised because the column 'type_new' is reserved for storing the class in case of inheritance. Please rename this
column if you didn't intend it to be used for storing the inheritance class or overwrite Integration.inheritance_column to
use another column for that information.)

The subclass in the error message can be any of the following:

  • Integrations::Github
  • Integrations::GitGuardian
  • Integrations::GoogleCloudPlatform::ArtifactRegistry
  • Integrations::GoogleCloudPlatform::WorkloadIdentityFederation

All integrations are created automatically for every project you have. To avoid getting this error, you must remove all EE-only integration records from your database.

{{< tabs >}}

{{< tab title="Linux package (Omnibus)" >}}

shell
sudo gitlab-rails runner "Integration.where(type_new: ['Integrations::Github']).delete_all"
sudo gitlab-rails runner "Integration.where(type_new: ['Integrations::GitGuardian']).delete_all"
sudo gitlab-rails runner "Integration.where(type_new: ['Integrations::GoogleCloudPlatform::ArtifactRegistry']).delete_all"
sudo gitlab-rails runner "Integration.where(type_new: ['Integrations::GoogleCloudPlatform::WorkloadIdentityFederation']).delete_all"

{{< /tab >}}

{{< tab title="Self-compiled (source)" >}}

shell
bundle exec rails runner "Integration.where(type_new: ['Integrations::Github']).delete_all" production
bundle exec rails runner "Integration.where(type_new: ['Integrations::GitGuardian']).delete_all" production
bundle exec rails runner "Integration.where(type_new: ['Integrations::GoogleCloudPlatform::ArtifactRegistry']).delete_all" production
bundle exec rails runner "Integration.where(type_new: ['Integrations::GoogleCloudPlatform::WorkloadIdentityFederation']).delete_all" production

{{< /tab >}}

{{< /tabs >}}

Adjust configuration that uses environment scopes

If you use environment scopes, you might need to adjust your configuration, especially if configuration variables share the same key, but have different scopes. Environment scopes are completely ignored in CE.

With configuration variables that share a key but different scopes, you could accidentally get a variable that you're not expecting for a particular environment. Make sure that you have the right variables in this case.

Your data is completely preserved in the transition, so you can change back to EE and restore the behavior.

Revert to CE

After performing the necessary steps, you can revert your GitLab instance to CE.

Follow the correct update guides to make sure all dependencies are up to date.

{{< tabs >}}

{{< tab title="Linux package (Omnibus)" >}}

Install the Community Edition package by following the installation instructions for your distribution.

{{< /tab >}}

{{< tab title="Self-compiled (source)" >}}

  1. Replace the current Git remote of your GitLab installation with the CE Git remote.

  2. Fetch the latest changes and check out the latest stable branch. For example:

    shell
    git remote set-url origin [email protected]:gitlab-org/gitlab-foss.git
git fetch --all
git checkout 17-8-stable

{{< /tab >}}

{{< /tabs >}}

Troubleshooting

This section contains possible solutions for problems you might encounter.

Error: Cookbook gitlab-ee not found

You might encounter the Cookbook gitlab-ee not found error when installing the Linux package for GitLab CE on a GitLab EE instance. To resolve this issue:

  1. Remove the gitlab-ee cookbook:

    shell
    sudo rm -rf /opt/gitlab/embedded/cookbooks/cache/cookbooks/gitlab-ee

  2. Re-install GitLab CE.

  3. Check that all services are up:

    shell
    sudo gitlab-ctl status

    If not, restart GitLab:

    shell
    sudo gitlab-ctl restart