Restoring Original Files from XL Format After Docker Container Crash

[franzfilip]

Hello MinIO Team,

I have been running MinIO as an S3 service within a Docker container. Unfortunately, my server crashed, and I managed to secure the mounted storage from the container on my PC. I then attempted to start the MinIO Docker container on my PC using the same mount. However, I noticed that objects originally uploaded as .wav files are not stored as single files. Instead, they appear with a folder structure similar to this:

article.wav/
├── xl.meta
└── 5390a4b2-ddb8-4310-8717-7c85e61d5faa/
└── part.1

I understand that MinIO uses this internal structure (with the xl.meta file and one or more parts) to store objects in XL mode. My questions are:

Is there an official tool or documented procedure to reconstruct the original file (e.g., the complete .wav file) from this internal structure?
Alternatively, are there recommended steps or scripts to manually merge the parts stored in the XL format back into a single, usable file?
Any guidance or suggestions would be greatly appreciated.

Or spoken in general:
How can i fix the broken state, because some files are getting detected correctly (just a few) and others are not even displayed:
Working:

Not Working:

Docker Compose

  minio:
    image: minio/minio
    environment:
      MINIO_ROOT_USER: "${MINIO_ROOT_USER}"
      MINIO_ROOT_PASSWORD: "${MINIO_ROOT_PASSWORD}"
    volumes:
      - minio_data:/data
    command: server /data --console-address ":9001"
    ports:
      - "9000:9000"
      - "9001:9001"
    networks:
      - preview

[marktheunissen]

Hi @franzfilip , if you have not lost the data (the volumes mounted into the container), then you can just restart MinIO with the same startup parameters and your data will be available again. Those data volumes contain everything that is needed to start with the same values. Then you can just copy the data using the usual MinIO S3 compatible interface.

Paste any startup logs that you see when MinIO starts. Use the same version as previously.

MinIO is the tool that constructs objects out of those data files, there is no separate tool that does this. It should come back.