---
title: "Migrate query-scheduler from DNS-based to ring-based service discovery | Grafana Mimir documentation"
description: "Learn how to migrate query-scheduler from DNS-based to ring-based service discovery"
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Migrate query-scheduler from DNS-based to ring-based service discovery

The query-scheduler supports two service discovery mechanisms:

- [DNS-based service discovery](../../../references/architecture/components/query-scheduler/#dns-based-service-discovery)
- [Ring-based service discovery](../../../references/architecture/components/query-scheduler/#ring-based-service-discovery)

To migrate the query-scheduler from DNS-based to ring-based service discovery when your Mimir cluster is deployed using Jsonnet:

1. Configure the query-scheduler instances to join a ring, but keep the querier and query-frontend instances discovering query-schedulers via DNS:
   
   jsonnet ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```jsonnet
   {
     _config+:: {
       query_scheduler_service_discovery_mode: 'ring',
       query_scheduler_service_discovery_ring_read_path_enabled: false,
     }
   }
   ```
2. Wait until query-scheduler changes have been applied.
3. Open the [query-scheduler ring status](../../../references/http-api/#query-scheduler-ring-status) page and ensure all query-scheduler instances are registered to the ring.
4. Configure query-frontend and querier instances to discover query-schedulers via the ring:
   
   jsonnet ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```jsonnet
   {
     _config+:: {
       query_scheduler_service_discovery_mode: 'ring',
       query_scheduler_service_discovery_ring_read_path_enabled: true,
     }
   }
   ```