โ ๏ธ Breaking Change
Impact Score: 7/10
MinIO: Bug fix and feature release.
Source available โ automated, not human-reviewed Component: minio ยท Channel: stable. Automated analysis, not a compatibility certification. How this works .
Analysis updated: 2026-11-01.
Breaking-change evidence from the source Breaking Change If deploying minio in distibuted mode on kubernetes using a custom `yaml` file. Remove the `command` section, use the `args` section instead. See a [sample `yaml`](https://github.com/minio/minio/blob/master/docs/orchestration/kubernetes-yaml/minio-distributed-statefulset.yaml) file reference here. Read the original context โ
Source flags breaking changes โ review applicability
๐ Copy for Slack / Discord
๐ค Copy AI Upgrade Prompt
๐ .MD
โก Executive Summary (TL;DR)
MinIO RELEASE.2017-05-05T01-14-51Z. Source highlight: This release fixes a critical bug when deploying Minio in distributed mode using Kubernetes - 4225: Minio Server in RELEASE.2017-04-25T01-27-49Z and above, doesn't start in a distributed mode in Kubernetes. All other Minio deployment scenarios do not encounter this issue.
๐ View Raw Release Notes (Original Developer Log)
## Critical Fix
This release fixes a critical bug when deploying Minio in distributed mode using Kubernetes - [4225: Minio Server in RELEASE.2017-04-25T01-27-49Z and above, doesn't start in a distributed mode in Kubernetes]( https://github.com/minio/minio/issues/4225). All other Minio deployment scenarios do not encounter this issue.
## Breaking Change
If deploying minio in distibuted mode on kubernetes using a custom `yaml` file. Remove the `command` section, use the `args` section instead. See a [sample `yaml`](https://github.com/minio/minio/blob/master/docs/orchestration/kubernetes-yaml/minio-distributed-statefulset.yaml) file reference here.
## Highlights
- **Azure Gateway** now supports custom endpoint.
- Adds **MySQL** as new bucket notification target.
- Performance improvements in dsync for high concurrent requests.
- Relax TLS cipher suite requirements, minimum TLS protocol version is TLS 1.2.
- Bucket notifications are now supported for **GetObject** and **HeadObject** operations
as well, with extra source information.
## NOTE
- **S3 Gateway** support is in alpha state and not ready for **production** use.
- **Admin API** functionality is in experimental state and not ready for **production** use.
## Changelog
- Add minimum requirements for MySQL notification (#4260) (88 minutes ago) <Nitish Tiwari>
- browser: Update ui-assets with new fixes. (#4246) (4 hours ago) <Harshavardhana>
- Webhook endpoints can fail, we must start the server. (#4255) (5 hours ago) <Harshavardhana>
- Bump up minio-go to (fixes #4243) (#4256) (5 hours ago) <Aditya Manthramurthy>
- browser: Selecting a new bucket appends objects list to previous bucket's list (#4252) (8 hours ago) <Krishna Srinivas>
- Make gateway help for s3/azure similar (#4249) (8 hours ago) <Krishnan Parthasarathi>
- Add waiting on hosts in docker entrypoint for distributed setups. (#4244) (18 hours ago) <Harshavardhana>
- Use s3.amazonaws.com as default endpoint, fixes #4240 (#4242) (20 hours ago) <Remco Verhoef>
- Fix bug in JSON representation of object properties (#4238) (23 hours ago) <Aditya Manthramurthy>
- Add s3 backend to help, fixes #4219 (#4221) (25 hours ago) <Remco Verhoef>
- fix: ignore TLS handshake error. (#4227) (2 days ago) <Bala FA>
- tests: Fix rare test crash (#4175) (2 days ago) <Karthic Rao>
- gateway-s3: vendor-update minio-go (#4220) (2 days ago) <Krishna Srinivas>
- gateway: Restore bucket policy functionality for Azure (#4209) (2 days ago) <Krishna Srinivas>
- config: Improve config migrate messaging. (#4216) (2 days ago) <Harshavardhana>
- windows: Support all REPARSE_POINT attrib files properly. (#4203) (3 days ago) <Harshavardhana>
- cleanup and fix comments (#4212) (3 days ago) <Remco Verhoef>
- gateway: Rename gateway files to have "gateway-" prefix (#4207) (3 days ago) <Krishna Srinivas>
- gateway: reject bad path segments in URL (#4202) (6 days ago) <Krishna Srinivas>
- gateway: Fix help message for gateway (#4201) (6 days ago) <Krishna Srinivas>
- pkg: Update the rpm spec with latest release. (#4187) (6 days ago) <Harshavardhana>
- browser: Listing should append instead of replacing previous listing (#4188) (6 days ago) <Krishna Srinivas>
- cors: Set Access-Control-Allow-Credentials to true (#4185) (7 days ago) <Anis Elleuch>
- Implement gateway S3 support (#3940) (7 days ago) <Remco Verhoef>
- web: Simplify and converge common functions in web/obj API. (#4179) (8 days ago) <Harshavardhana>
- Improve duration humanization. (#4071) (9 days ago) <Bala FA>
- docs: Update with home brew special note for macOS upgrades. (#4180) (9 days ago) <Dee Koder>
- docs: Document homebrew install path changes for minio. (#4178) (9 days ago) <Dee Koder>
- Provide command to help fill issue template (#4174) (10 days ago) <Krishnan Parthasarathi>
- build: -s -w should be added by gen-ldflags.go (#4172) (10 days ago) <Harshavardhana>
- docs: Point docker compose to new release. (#4171) (10 days ago) <Harshavardhana>
- server: Validate path for bad components in a handler. (#4170) (10 days ago) <Harshavardhana>
- Remove hardcoded min and max limit for erasure coding (#4157) (10 days ago) <Frank>
- docs: Add Minikube deployment to k8s docs (#4133) (10 days ago) <Nitish Tiwari>
- Enable build on solaris (#4115) (11 days ago) <Peter Tribble>
- admin: ServerInfo() returns info for each node (#4150) (2 weeks ago) <Anis Elleuch>
- api: Fix registering of s3 endpoint peers properly (#4159) (2 weeks ago) <Harshavardhana>
- lock: Vendorize all the new changes made in minio/dsync (#4154) (2 weeks ago) <Harshavardhana>
- server/mux: Fix serverMux to set deadlines based on UTC time. (#4146) (2 weeks ago) <Harshavardhana>
- Add key for Kafka messages (fixes #4143) (#4151) (2 weeks ago) <Aditya Manthramurthy>
- lock: Fix missing formatting directives while printing. (#4147) (2 weeks ago) <Harshavardhana>
- docs: Fix and reword FreeBSD documentation. (#4145) (2 weeks ago) <Harshavardhana>
- server: Fix message when corrupted or unsupported format is found. (#4142) (2 weeks ago) <Harshavardhana>
- Remove duration field from lock instrumentation (#4111) (3 weeks ago) <Krishnan Parthasarathi>
- cache: Increasing caching GC percent from 20 to 50. (#4041) (3 weeks ago) <Harshavardhana>
- docs: Created new illustration for docs. (#4012) (3 weeks ago) <Anabel V>
- fs: Remove fs meta lock when PutObject() fails (#4114) (3 weeks ago) <Anis Elleuch>
- gateway: Fix help message for custom Azure Blob Storage endpoint. (#4113) (3 weeks ago) <Krishna Srinivas>
- Return possible states a heal operation (#4045) (3 weeks ago) <Krishnan Parthasarathi>
- server: Fix CI build complaints (#4119) (3 weeks ago) <Karthic Rao>
- xl: Add stat calls to keep track of ignored errors. (#4117) (3 weeks ago) <Harshavardhana>
- server: Error out if loopback addr is used for Distributed Erasure (#4105) (3 weeks ago) <Bala FA>
- tests: Fix the sopradic test failure in TestListObjectPartsDiskNotFound (#4107) (3 weeks ago) <Harshavardhana>
- handlers: Ignore malformatted datetime type header (#4097) (3 weeks ago) <Anis Elleuch>
- Cleanup service docs (#4103) (3 weeks ago) <Nitish Tiwari>
- server: Fix a regression in printing startup banner. (#4100) (3 weeks ago) <Harshavardhana>
- gateway: Support for custom endpoint. (#4086) (3 weeks ago) <Krishna Srinivas>
- Add extensive endpoints validation (#4019) (3 weeks ago) <Bala FA>
- lock/rpc: change rpcPath to be called serviceEndpoint. (#4088) (3 weeks ago) <Harshavardhana>
- Browser: Make login form browser auto-fill compatible (#4091) (3 weeks ago) <Rushan>
- docs: Update docker quick-start guide and adds relevant project URLS (#4075) (3 weeks ago) <koolhead17>
- Fix for writes from Apache Spark. (#4074) (3 weeks ago) <Karthic Rao>
- signature-v4: Use sha256("") for calculating canonical request (#4064) (3 weeks ago) <Krishna Srinivas>
- server: Introduce a new env MINIO_REGION. (#4078) (4 weeks ago) <Harshavardhana>
- Allow cluster to start when only n/2 servers are up (#4066) (4 weeks ago) <Aditya Manthramurthy>
- docker: Support docker swarm secrets. (#3977) (4 weeks ago) <Harshavardhana>
- api: SourceInfo should be populated in GET/HEAD notification. (#4073) (4 weeks ago) <Harshavardhana>
- notify: Webhook endpoints can fail, but we must start the server. (#4060) (4 weeks ago) <Harshavardhana>
- Add steps to run Minio distributed on Windows (#4068) (4 weeks ago) <Nitish Tiwari>
- log: Dump signature request properly. (#4063) (4 weeks ago) <Harshavardhana>
- Fix xml block syntax in admin-api Readme (#4062) (4 weeks ago) <Krishnan Parthasarathi>
- docs: macOS brew now refers to Minio fork (#4059) (4 weeks ago) <Harshavardhana>
- admin/info: Add HTTPStats value as part of serverInfo() struct. (#4049) (4 weeks ago) <Harshavardhana>
- refactor: extractSignedHeaders() handles headers removed by Go http server (#4054) (4 weeks ago) <Krishna Srinivas>
- signature-v4: Support for transfer-encoding request header (#4053) (4 weeks ago) <Krishna Srinivas>
- build: Fix compilation in 32 bits platforms (#4052) (4 weeks ago) <Anis Elleuch>
- browser: Generate new UI assets. (4 weeks ago) <Harshavardhana>
- fix: add white space in storage usage section (#4038) (4 weeks ago) <Rajeesh C V>
- fs: Enable returning ETag along with ListObjects() (#4042) (4 weeks ago) <Harshavardhana>
- sigv2: Unespace canonicalized resources values (#4034) (4 weeks ago) <Anis Elleuch>
- handler: simplify parsing valid location constraint. (#4040) (4 weeks ago) <Harshavardhana>
- Provide mc-admin-heal command on start-up (#4031) (4 weeks ago) <Krishnan Parthasarathi>
- madmin: Rename HealObjectResult to HealResult (#4035) (4 weeks ago) <Krishnan Parthasarathi>
- (upstream/master) sys/stats: return cgroup mem limit, fall back to sysinfo() (#4002) (5 weeks ago) <Harshavardhana>
- doc: Explain how to create certificate chain file (#4032) (5 weeks ago) <Anis Elleuch>
- build: Reduce binary size by using -s -w (#4027) (5 weeks ago) <Harshavardhana>
- vet: Fix all the go vet complaints (#4029) (5 weeks ago) <Harshavardhana>
- Add disksUnavailable healStatus const (#3990) (5 weeks ago) <Krishnan Parthasarathi>
- Add `access` format support for Elasticsearch notification target (#4006) (5 weeks ago) <Aditya Manthramurthy>
- server/tls: Do not rely on a specific cipher suite (#4021) (5 weeks ago) <Harshavardhana>
- notifiers: Stop using url.Parse in validating address format. (#4011) (5 weeks ago) <Harshavardhana>
- Add `deliveryMode` parameter for AMQP notfication target (#4008) (5 weeks ago) <Aditya Manthramurthy>
- Browser: Use object name with prefix to delete sub-path objects (#4013) (5 weeks ago) <Rushan>
- fix: use its own lock in serverConfigV17 (#4014) (5 weeks ago) <Bala FA>
- server: handle command line and env variables at one place. (#3975) (5 weeks ago) <Bala FA>
- docs: Fix typo in docs/config/README.md (#4009) (5 weeks ago) <Romain Bouyรฉ>
- event: Set contentType as well under NotificationEvent. (#4003) (5 weeks ago) <Harshavardhana>
- webhook: Add support of custom CAs (#4000) (5 weeks ago) <Anis Elleuch>
- obj-handlers: Rewrite src & dst path cmp in Copy() (#3998) (5 weeks ago) <Anis Elleuch>
- Add `access` format support for Redis notification target (#3989) (5 weeks ago) <Aditya Manthramurthy>
- config/path: Figure out absolute paths properly on windows. (#3996) (5 weeks ago) <Harshavardhana>
- Update filename (#3995) (5 weeks ago) <Nitish Tiwari>
- config: Appropriate error message when newer config file is found (#3972) (5 weeks ago) <Krishna Srinivas>
- Docker guide fix (#3992) (5 weeks ago) <Nitish Tiwari>
- sign/streaming: Content-Encoding is not set in newer aws-java-sdks (#3986) (5 weeks ago) <Harshavardhana>
- lock, Windows: O_CREAT infers only GENERIC_WRITE (#3981) (5 weeks ago) <Anis Elleuch>
- Added kernel tuning docs (#3921) (5 weeks ago) <Nitish Tiwari>
- Support `access` format for database notification targets (#3953) (5 weeks ago) <Aditya Manthramurthy>
- browser-flag: wrapped bool type denotes browser on/off flag. (#3963) (6 weeks ago) <Bala FA>
- tests: use url.QueryEscape() when dealing with url query params. (#3974) (6 weeks ago) <Harshavardhana>
- docs: Add config directory documentation/guide. (#3889) (6 weeks ago) <Harshavardhana>
- build: Improve build messaging, say where we built Minio. (#3973) (6 weeks ago) <Harshavardhana>
- heal: Check if all parts are available and valid (#3967) (6 weeks ago) <Krishnan Parthasarathi>
- docs: Removed space from code blocks. (#3965) (6 weeks ago) <Dee Koder>
- Refactor logger (#3924) (6 weeks ago) <Bala FA>
- config: Remove level in console/file loggers (#3938) (6 weeks ago) <Anis Elleuch>
- Fix listDirHealFactory merging of entries across disks (#3959) (6 weeks ago) <Krishnan Parthasarathi>
- Docs: Fix for Self signed certificate. (#3957) (6 weeks ago) <koolhead17>
- browser: update ui-assets.go (#3956) (6 weeks ago) <Krishna Srinivas>
- Add sourceInfo to NotificationEvent (#3937) (6 weeks ago) <Krishnan Parthasarathi>
- config: Do not validate creds when set via env (#3955) (6 weeks ago) <Anis Elleuch>
- pkg/quick: add Save() function and other enhancements. (#3951) (6 weeks ago) <Bala FA>
- HealObject should succeed when only N/2 disks have data (#3952) (6 weeks ago) <Krishnan Parthasarathi>
- Browser: Use polyfill to support Object.assign in IE11 (#3942) (6 weeks ago) <Rushan>
- docs: Fix for README.md markdown table. (#3948) (6 weeks ago) <koolhead17>
- XL: Return the right error (#3944) (6 weeks ago) <Krishnan Parthasarathi>
- Add notification for object access via GET/HEAD (#3941) (6 weeks ago) <Krishnan Parthasarathi>
- pkg/madmin: Set UploadID in ListUploadsHeal (#3945) (6 weeks ago) <Krishnan Parthasarathi>
- heal: Set truncate when no more walk entries (#3932) (6 weeks ago) <Anis Elleuch>
- XL: Don't return ignored errors in listDirFactory (#3935) (6 weeks ago) <Krishnan Parthasarathi>
- Update link for downloading minio server. (#3934) (7 weeks ago) <Pawan Rawal>
- words: new package Damerau Levenshtein distance function. (#3929) (7 weeks ago) <Bala FA>
- Add UTCNow() function. (#3931) (7 weeks ago) <Bala FA>
- admin: Export HealStatus data type (#3930) (7 weeks ago) <Anis Elleuch>
- Add support for MySQL notifications (fixes #3818) (#3907) (7 weeks ago) <Aditya Manthramurthy>
- Implement heal-upload admin API (#3914) (7 weeks ago) <Krishnan Parthasarathi>
- Remove white spaces (#3922) (7 weeks ago) <Nitish Tiwari>
- Fixed Docker compose link (#3920) (7 weeks ago) <Nitish Tiwari>
- docs: Update gateway doc with roadmap section. (#3918) (7 weeks ago) <Dee Koder>