This is archived documentation for v2.0.x. Go to the latest version.
Grafana Mimir deployment modes
You can deploy Grafana Mimir in one of two modes:
- Monolithic mode
- Microservices mode
The deployment mode is determined by the
-target parameter, which you can set via CLI flag or YAML configuration.
The monolithic mode runs all required components in a single process and is the default mode of operation, which you can set by specifying
-target=all. Monolithic mode is the simplest way to deploy Grafana Mimir and is useful if you want to get started quickly or want to work with Grafana Mimir in a development environment. To see the list of components that run when
-target is set to
all, run Grafana Mimir with the
Monolithic mode can be horizontally scaled out by deploying multiple Grafana Mimir binaries with
-target=all. This approach provides high-availability and increased scale without the configuration complexity of the full microservices deployment.
In microservices mode, components are deployed in distinct processes. Scaling is per component, which allows for greater flexibility in scaling and more granular failure domains. Microservices mode is the preferred method for a production deployment, but it is also the most complex.
In microservices mode, each Grafana Mimir process is invoked with its
-target parameter set to a specific Grafana Mimir component (for example,
-target=distributor). To get a working Grafana Mimir instance, you must deploy every required component. For more information about each of the Grafana Mimir components, refer to Architecture.
If you are interested in deploying Grafana Mimir in microservices mode, we recommend that you use Kubernetes.
Related Mimir resources
How to control metrics growth in Prometheus and Kubernetes with Grafana Cloud
This webinar will introduce a metrics cost management framework to optimize metrics growth while keeping rising costs at bay with Grafana Cloud.
Intro to Grafana Mimir: The open source time series database that scales to 1 billion metrics & beyond
Grafana Mimir webinar—learn about our open source solution for extending Prometheus at organizations needing massive scale, rapid query performance.
For billion-series scale or home IoT projects, get started in minutes with Grafana Mimir
Learn how easy it is to get started with Mimir, no matter how many or few time series you need to store.