Skip to content

Instantly share code, notes, and snippets.

@MahdadGhasemian

MahdadGhasemian/minio_backup_restore_guide.md

Last active September 8, 2025 11:30
Show Gist options
  • Save MahdadGhasemian/416476b536f9a1334382065a7c44b33c to your computer and use it in GitHub Desktop.
Save MahdadGhasemian/416476b536f9a1334382065a7c44b33c to your computer and use it in GitHub Desktop.
Download ZIP
Steps to backup and restore Minio Buckets
Raw
minio_backup_restore_guide.md

Restore Backup with Minio (Minio <----> Local)

Instructions for restoring buckets using Minio mirror features.

Install Minio Client

Install Link install link

Linux AMD64 DEB:

wget https://dl.min.io/client/mc/release/linux-amd64/mcli_20240722200249.0.0_amd64.deb
sudo dpkg -i mcli_20240722200249.0.0_amd64.deb

Add minio server to minio alias:

mcli alias set myminio/ MINIO_SERVER_URL MINIO_ADMIN_USERNAME MINIO_ADMIN_PASSWORD

Commands:

List all contents of BUCKET_NAME

mcli ls myminio/BUCKET_NAME

Backup to local

mcli mirror myminio/BUCKET_NAME path-to-your-local-backup-folder/BUCKET_NAME --overwrite

Restore from local

mcli mirror path-to-your-local-backup-folder/BUCKET_NAME myminio/BUCKET_NAME --overwrite
@dermodmaster
Copy link

To anyone coming to this, this works with MinIO's mc utility too

This saved some minutes of my lifetime lol. Thank you 🙏🏻

@MahdadGhasemian
Copy link
Author

To anyone coming to this, this works with MinIO's mc utility too

Just to clarify for other: in the gist, I'm using mcli as a custom alias for MinIO's official command-line tool, which is actually mc.
So if you're following the steps, make sure you've installed MinIO's mc utitily, and either use mc directly or alias it as mcli like I did:

alias mcli='mc'

That way, the commands in the gist will work seamlessly.

Thanks again for the helpful comment! 🙏🏻

@ankitswifter
Copy link

Hello,
We have done the same and we can see there a huge memory spike after mirror, form 2Gib -> 8Gib Ram.
any suggestion to control this spike ?

@MahdadGhasemian
Copy link
Author

Hello, We have done the same and we can see there a huge memory spike after mirror, form 2Gib -> 8Gib Ram. any suggestion to control this spike ?

Hello @ankitswifter
Take a look at this shared ChatGPT discussion — it outlines several methods to prevent memory spikes.
I haven't tested them yet, but they seem promising:
https://chatgpt.com/share/6880566d-584c-800d-a8f4-029b43ebe9ba

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment