How move chunks and index files from s3 to local filesystem?

Hi! I want move our data from s3 to local filesystem, how can I do that?

Thanks @evgenyluvsandugar for posting this here, the question gets asked enough that hopefully it will help others to see the answer here:

Yes this should be possible (and the reverse possible too)*

* I’ve never tried this

The chunks themselves can be copied from s3 to filesystem or vice versa, their content wouldn’t change, what does need to change is the names and the location.

In an object store like S3 (or GCS or Azure Blob) the directory structure looks like this:


If you are using Loki in single user mode, you would see:


As Loki choses the tenant ID of fake (sorry this isn’t the best name but it’s almost impossible to change at this point)

On the local filesystem store the layout is a little different,


The path here is what’s defined in the config like so

    directory: /path/to/filesystem/store

those really long names are actually base 64 encoded names and if you decode one you find:


So, this becomes the problem, converting between an object store and the filesystem store requires appending the tenantID to the chunk name and then base64 encoding it and storing that in the filesystem directory.

The index folder can be copied as is I believe (and is only present if you are using boltdb-shipper index type)

Unfortunately nobody has built any tooling to do this yet as far as I know.

I’m sorry this isn’t probably the answer you were hoping for but it should be possible to do this although it would very likely require building a tool to accomplish.

1 Like

Thank you! It works!


Did you build any tooling to do this? Any scripts or something you could share?

Yes, simple python script:

import os
import base64

def main():
    for count, filename in enumerate(os.listdir(".")):
        full_filename = 'fake/' + filename
        b_filename = full_filename.encode("ascii")
        b64_filename = base64.b64encode(b_filename)

        os.rename(filename, b64_filename)

if __name__ == '__main__':

Fantastic, thank you so much for your follow up and for the script. Should be a big help to anyone who finds this in the future!