---
title: "Configure ingest storage architecture | Grafana Mimir documentation"
description: "Learn how to configure Grafana Mimir ingest storage architecture when using Jsonnet."
---

# Configure ingest storage architecture

The [ingest storage](/docs/mimir/next/get-started/about-grafana-mimir-architecture/) is the next generation architecture of Grafana Mimir. It decouples the Mimir read and write paths using Apache Kafka or a Kafka-compatible backend.

To enable ingest storage, set the following Jsonnet:

jsonnet ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```jsonnet
{
  _config+:: {
    ingest_storage_enabled: true,
  }
}
```

> Note
> 
> The ingest storage architecture requires a production-grade Apache Kafka cluster or Kafka-compatible backend.

> Warning
> 
> The ingest storage architecture requires the ruler remote evaluation to be enabled for the Mimir cluster. Refer to the [Configure the Grafana Mimir ruler with Jsonnet](/docs/mimir/next/set-up/jsonnet/configure-ruler/) documentation for details about the ruler’s operational modes.

## Kafka connection options

The Jsonnet configures some Kafka connection parameters by default:

- **Kafka topic**: `ingest`
- **Auto-created partitions**: 1000 (when the topic doesn’t exist)
- **Kafka addresses**: `kafka.<namespace>.svc.<cluster_domain>:9092`

To customize the Kafka connection configuration, override the default settings:

jsonnet ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```jsonnet
{
  _config+:: {
    ingest_storage_enabled: true,
  },

  // Override producer and consumer addresses for external Kafka
  ingest_storage_kafka_producer_address:: 'kafka-broker-1:9092,kafka-broker-2:9092',
  ingest_storage_kafka_consumer_address:: 'kafka-broker-1:9092,kafka-broker-2:9092',

  // Override Kafka client configuration
  ingest_storage_kafka_client_args+:: {
    'ingest-storage.kafka.topic': 'mimir-ingest',
    'ingest-storage.kafka.auto-create-topic-default-partitions': 500,
  },
}
```

### Kafka partition sizing

The configured topic must have at least as many partitions as the number of ingesters in one zone.

Refer to [Configure the Grafana Mimir Kafka backend](/docs/mimir/next/configure/configure-kafka-backend/) for more details about Kafka configurations.