Configuring stored object compression

You can use the Stored Object Compression grid option to reduce the size of objects stored in StorageGRID, so that objects consume less storage.

Before you begin

About this task

The Stored Object Compression grid option is disabled by default. If you enable this option, StorageGRID attempts to compress each object when saving it, using lossless compression.
Note: If you change this setting, it will take about one minute for the new setting to be applied. The configured value is cached for performance and scaling.
Before enabling this setting, be aware of the following:
  • Applications that save objects to StorageGRID might compress objects before saving them. If a client application has already compressed an object before saving it to StorageGRID, enabling Stored Object Compression will not further reduce an object’s size.
  • If the Stored Object Compression grid option is enabled, S3 and Swift client applications should avoid performing GET Object operations that specify a range of bytes be returned. These "range read" operations are inefficient because StorageGRID must effectively uncompress the objects to access the requested bytes. GET Object operations that request a small range of bytes from a very large object are especially inefficient; for example, it is inefficient to read a 10 MB range from a 50 GB compressed object.

    If ranges are read from compressed objects, client requests can time out.

    Note: If you need to compress objects and your client application must use range reads, increase the read timeout for the application.


  1. Select Configuration > Grid Options.
  2. From the Grid Options menu, select Configuration.
  3. Change Stored Object Compression to Enabled.

    Stored Object Compression Enabled
  4. Click Apply Changes.