Over a million developers have joined DZone.

How to Configure Druid to Use Minio as Deep Storage

DZone's Guide to

How to Configure Druid to Use Minio as Deep Storage

In this post, we'll show you how to configure non-Amazon S3 deep storage for a Druid cluster, using the Minio distributed object storage server.

· Big Data Zone ·
Free Resource

How to Simplify Apache Kafka. Get eBook.

Apache Druid (incubating) is a high performance analytics data store for event-driven data. Druid relies on a distributed filesystem or binary object store for data storage. The most commonly used deep storage implementations are S3 (popular for those on AWS) and HDFS (popular if you already have a Hadoop deployment). In this post, I will show you how to configure non-Amazon S3 deep storage for a Druid cluster. And for this, I will use Minio as S3 deep storage for a Druid cluster.


Minio is a high performance distributed object storage server, designed for large-scale private cloud infrastructure. The Amazon S3 API is the de facto standard for object storage. Minio implements the Amazon S3 v2/v4 API. It is best suited for storing unstructured data such as photos, videos, log files, backups, and container/VM images. Size of an object can range from a few KBs to a maximum of 5TB.

At first you need to install Minio. Follow the instructions given here to install Minio. The Minio Server comes up with an embedded web-based object browser. Point your web browser to to ensure your server has started successfully.

Now that you have installed Minio, let's create a bucket named cpbucket (or your preferred name) from the web-ui or you can also do that using the Minio Client (mc). See the documentation for more details about mc.


Now it’s time to configure Druid. In the conf/druid/_common/common.runtime.propertiesfile, add “druid-s3-extensions” to druid.extensions.loadList. If, for example, the list already contains “druid-parser-route,” the final property should look like:

druid.extensions.loadList=["druid-parser-route", "druid-s3-extensions"]

The S3 extension for deep storage uses jets3t under the hood. You need to create a jets3t.properties file on the class path. Let’s create a new file jets3t.propertiesinside theconf/druid/_common directory with following:


Now, comment out the configurations for local storage under the “Deep Storage” section and add appropriate values for Minio. After this, the “Deep Storage” section should look like:

# Deep storage

# For local disk (only viable in a cluster if this is a network mount):
# druid.storage.type=local
# druid.storage.storageDirectory=var/druid/segments

# For HDFS:
# druid.storage.type=hdfs
# druid.storage.storageDirectory=/druid/segments

# For S3:

To configure indexing service logs to be stored in Minio, update the “Indexing service logs” section with appropriate values in conf/druid/_common/common.runtime.properties.

After this, the “Indexing service logs” section should look like:

# Indexing service logs

# For local disk (only viable in a cluster if this is a network mount):
# druid.indexer.logs.type=file
# druid.indexer.logs.directory=var/druid/indexing-logs

# For HDFS:
# druid.indexer.logs.type=hdfs
# druid.indexer.logs.directory=/druid/indexing-logs

# For S3:

And you’re done. Now restart the servers for these changes to take effect. To test if it is working, load the sample wikipedia data into Druid and see the data stored in Minio using the web-ui or mccommand.

12 Best Practices for Modern Data Ingestion. Download White Paper.

druid ,analytics ,big data ,tutorial ,deep storage

Published at DZone with permission of

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}