minio/docs/minio-limits.md

## MinIO Server Limits Per Tenant

### Erasure Code (Multiple Drives / Servers)

|Item|Specification|
|:---|:---|
|Maximum number of servers per cluster| no-limit|
|Maximum number of federated clusters | no-limit|
|Minimum number of servers| 02|
|Minimum number of drives per server when server count is 1 | 04 |
|Minimum number of drives per server when server count is 2 or 3 | 02|
|Minimum number of drives per server when server count is 4 | 01|
|Maximum number of drives per server| no-limit|
|Read quorum| N/2|
|Write quorum| N/2+1|

### Limits of S3 API

|Item|Specification|
|:---|:---|
|Maximum number of buckets| no-limit|
|Maximum number of objects per bucket| no-limit|
|Maximum object size| 5 TiB|
|Minimum object size| 0 B|
|Maximum object size per PUT operation| 5 TiB|
|Maximum number of parts per upload| 	10,000|
|Part size|5 MiB to 5 GiB. Last part can be 0 B to 5 GiB|
|Maximum number of parts returned per list parts request| 10000|
|Maximum number of objects returned per list objects request| 10000|
|Maximum number of multipart uploads returned per list multipart uploads request| 1000|

### List of Amazon S3 API's not supported on MinIO
We found the following APIs to be redundant or less useful outside of AWS S3. If you have a different view on any of the APIs we missed, please open a [github issue](https://github.com/minio/minio/issues).

#### List of Amazon S3 Bucket API's not supported on MinIO

- BucketACL (Use [bucket policies](https://docs.min.io/docs/minio-client-complete-guide#policy) instead)
- BucketCORS (CORS enabled by default on all buckets for all HTTP verbs)
- BucketWebsite (Use [`caddy`](https://github.com/caddyserver/caddy) or [`nginx`](https://www.nginx.com/resources/wiki/))
- BucketAnalytics, BucketMetrics, BucketLogging (Use [bucket notification](https://docs.min.io/docs/minio-client-complete-guide#events) APIs)
- BucketRequestPayment

#### List of Amazon S3 Object API's not supported on MinIO

- ObjectACL (Use [bucket policies](https://docs.min.io/docs/minio-client-complete-guide#policy) instead)
- ObjectTorrent

### Object name restrictions on MinIO
Object names that contain characters `^*|\/&";` are unsupported on Windows and other file systems which do not support filenames with these characters. Note that this list is not exhaustive, and depends on the maintainers of the filesystem itself.
Replace Minio refs in docs with MinIO and links (#7494) 2019-04-09 14:39:42 -04:00			`## MinIO Server Limits Per Tenant`
docs: Add docs for minio limitations. (#3477) 2016-12-20 17:42:13 -05:00
			`### Erasure Code (Multiple Drives / Servers)`

			`\|Item\|Specification\|`
			`\|:---\|:---\|`
Implement bucket expansion (#8509) 2019-11-19 20:42:27 -05:00			`\|Maximum number of servers per cluster\| no-limit\|`
			`\|Maximum number of federated clusters \| no-limit\|`
Add large bucket support for erasure coded backend (#5160) This PR implements an object layer which combines input erasure sets of XL layers into a unified namespace. This object layer extends the existing erasure coded implementation, it is assumed in this design that providing > 16 disks is a static configuration as well i.e if you started the setup with 32 disks with 4 sets 8 disks per pack then you would need to provide 4 sets always. Some design details and restrictions: - Objects are distributed using consistent ordering to a unique erasure coded layer. - Each pack has its own dsync so locks are synchronized properly at pack (erasure layer). - Each pack still has a maximum of 16 disks requirement, you can start with multiple such sets statically. - Static sets set of disks and cannot be changed, there is no elastic expansion allowed. - Static sets set of disks and cannot be changed, there is no elastic removal allowed. - ListObjects() across sets can be noticeably slower since List happens on all servers, and is merged at this sets layer. Fixes #5465 Fixes #5464 Fixes #5461 Fixes #5460 Fixes #5459 Fixes #5458 Fixes #5460 Fixes #5488 Fixes #5489 Fixes #5497 Fixes #5496 2018-02-15 20:45:57 -05:00			`\|Minimum number of servers\| 02\|`
Add clarification for minimum drives per server (#10130) 2020-07-25 01:09:01 -04:00			`\|Minimum number of drives per server when server count is 1 \| 04 \|`
			`\|Minimum number of drives per server when server count is 2 or 3 \| 02\|`
			`\|Minimum number of drives per server when server count is 4 \| 01\|`
Implement bucket expansion (#8509) 2019-11-19 20:42:27 -05:00			`\|Maximum number of drives per server\| no-limit\|`
docs: Add docs for minio limitations. (#3477) 2016-12-20 17:42:13 -05:00			`\|Read quorum\| N/2\|`
			`\|Write quorum\| N/2+1\|`

			`### Limits of S3 API`

			`\|Item\|Specification\|`
			`\|:---\|:---\|`
			`\|Maximum number of buckets\| no-limit\|`
			`\|Maximum number of objects per bucket\| no-limit\|`
Rename minio-limitations.md to minio-limits.md (#5541) 2018-02-15 23:05:02 -05:00			`\|Maximum object size\| 5 TiB\|`
docs: Add docs for minio limitations. (#3477) 2016-12-20 17:42:13 -05:00			`\|Minimum object size\| 0 B\|`
Increase maximum size of PUT request to 5TB (#5241) fixes #5148 2017-11-28 02:29:02 -05:00			`\|Maximum object size per PUT operation\| 5 TiB\|`
docs: Add docs for minio limitations. (#3477) 2016-12-20 17:42:13 -05:00			`\|Maximum number of parts per upload\| 10,000\|`
fs: Re-implement object layer to remember the fd (#3509) This patch re-writes FS backend to support shared backend sharing locks for safe concurrent access across multiple servers. 2017-01-16 20:05:00 -05:00			`\|Part size\|5 MiB to 5 GiB. Last part can be 0 B to 5 GiB\|`
update distributed setup guide (#9566) 2020-05-11 12:19:10 -04:00			`\|Maximum number of parts returned per list parts request\| 10000\|`
			`\|Maximum number of objects returned per list objects request\| 10000\|`
docs: Add docs for minio limitations. (#3477) 2016-12-20 17:42:13 -05:00			`\|Maximum number of multipart uploads returned per list multipart uploads request\| 1000\|`

Replace Minio refs in docs with MinIO and links (#7494) 2019-04-09 14:39:42 -04:00			`### List of Amazon S3 API's not supported on MinIO`
Remove XL references in public docs to Erasure. (#3725) Ref #3722 2017-02-10 02:26:44 -05:00			`We found the following APIs to be redundant or less useful outside of AWS S3. If you have a different view on any of the APIs we missed, please open a [github issue](https://github.com/minio/minio/issues).`

Replace Minio refs in docs with MinIO and links (#7494) 2019-04-09 14:39:42 -04:00			`#### List of Amazon S3 Bucket API's not supported on MinIO`
docs: Add docs for minio limitations. (#3477) 2016-12-20 17:42:13 -05:00
Replace Minio refs in docs with MinIO and links (#7494) 2019-04-09 14:39:42 -04:00			`- BucketACL (Use [bucket policies](https://docs.min.io/docs/minio-client-complete-guide#policy) instead)`
Remove XL references in public docs to Erasure. (#3725) Ref #3722 2017-02-10 02:26:44 -05:00			`- BucketCORS (CORS enabled by default on all buckets for all HTTP verbs)`
Fix caddy project url (#11198) 2020-12-31 12:44:07 -05:00			- BucketWebsite (Use [`caddy`](https://github.com/caddyserver/caddy) or [`nginx`](https://www.nginx.com/resources/wiki/))
Replace Minio refs in docs with MinIO and links (#7494) 2019-04-09 14:39:42 -04:00			`- BucketAnalytics, BucketMetrics, BucketLogging (Use [bucket notification](https://docs.min.io/docs/minio-client-complete-guide#events) APIs)`
docs: Add docs for minio limitations. (#3477) 2016-12-20 17:42:13 -05:00			`- BucketRequestPayment`

Replace Minio refs in docs with MinIO and links (#7494) 2019-04-09 14:39:42 -04:00			`#### List of Amazon S3 Object API's not supported on MinIO`
docs: Add docs for minio limitations. (#3477) 2016-12-20 17:42:13 -05:00
Replace Minio refs in docs with MinIO and links (#7494) 2019-04-09 14:39:42 -04:00			`- ObjectACL (Use [bucket policies](https://docs.min.io/docs/minio-client-complete-guide#policy) instead)`
docs: Add docs for minio limitations. (#3477) 2016-12-20 17:42:13 -05:00			`- ObjectTorrent`
Document object name limitations on Windows (#5491) Fixes #5161 2018-02-03 09:27:40 -05:00
Replace Minio refs in docs with MinIO and links (#7494) 2019-04-09 14:39:42 -04:00			`### Object name restrictions on MinIO`
Format correction in server limits doc (#6773) 2018-11-06 17:50:11 -05:00			Object names that contain characters `^*\|\/&";` are unsupported on Windows and other file systems which do not support filenames with these characters. Note that this list is not exhaustive, and depends on the maintainers of the filesystem itself.