---
- title: "Legacy Gitaly configuration method"
  announcement_milestone: "15.10"
  removal_milestone: "16.0"
  breaking_change: true
  reporter: mjwood
  stage: gitaly
  issue_url: https://gitlab.com/gitlab-org/gitlab/-/issues/393574
  body: |
    Previously, Gitaly configuration keys for Omnibus GitLab were scattered throughout the configuration file. In GitLab
    15.10, we added support for a single configuration structure that matches Gitaly internal configuration. Both methods
    of configuring Gitaly 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 [Gitaly - Omnibus GitLab configuration structure change](https://docs.gitlab.com/ee/update/#gitaly-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:  # (optional) This is a link to the current documentation page
  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