---
- title: "Legacy Praefect configuration method"
  announcement_milestone: "15.9"
  removal_milestone: "16.0"
  breaking_change: true
  reporter: mjwood
  stage: gitaly
  issue_url: https://gitlab.com/gitlab-org/gitlab/-/issues/390291
  body: |
    Previously, Praefect configuration keys for Omnibus GitLab were scattered throughout the configuration file. In GitLab
    15.9, we added support for a single configuration structure that matches Praefect internal configuration. Both methods
    of configuring Praefect were supported in parallel.

    In GitLab 16.0, we removed support for the former configuration method and now only support the new configuration
    method.

    Before upgrading to GitLab 16.0, administrators must migrate to the new single configuration structure. For
    instructions, see [Praefect - Omnibus GitLab configuration structure change](https://docs.gitlab.com/ee/update/#praefect-omnibus-gitlab-configuration-structure-change).
  tiers:  # (optional - may be required in the future) An array of tiers that the feature is available in currently.  e.g., [Free, Silver, Gold, Core, Premium, Ultimate]
  documentation_url: https://docs.gitlab.com/ee/administration/gitaly/praefect.html
  image_url:  # (optional) This is a link to a thumbnail image depicting the feature
  video_url:  # (optional) Use the youtube thumbnail URL with the structure of https://img.youtube.com/vi/UNIQUEID/hqdefault.jpg