minio/docs/minio-limitations.md

## Minio Server Limits Per Tenant

### Erasure Code (Multiple Drives / Servers)

|Item|Specification|
|:---|:---|
|Maximum number of servers| 32|
|Minimum number of servers| 02|
|Maximum number of drives per server| Unlimited|
|Read quorum| N/2|
|Write quorum| N/2+1|

### Browser Access

|Item|Specification|
|:---|:---|
|Web browser upload size limit| 5GiB|

### 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| 1000|
|Maximum number of objects returned per list objects request| 1000|
|Maximum number of multipart uploads returned per list multipart uploads request| 1000|

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](http://docs.minio.io/docs/minio-client-complete-guide#policy) instead)
- BucketCORS (CORS enabled by default on all buckets for all HTTP verbs)
- BucketLifecycle (Not required for Minio erasure coded backend)
- BucketReplication (Use [`mc mirror`](http://docs.minio.io/docs/minio-client-complete-guide#mirror) instead)
- BucketVersions, BucketVersioning (Use [`s3git`](https://github.com/s3git/s3git))
- BucketWebsite (Use [`caddy`](https://github.com/mholt/caddy) or [`nginx`](https://www.nginx.com/resources/wiki/))
- BucketAnalytics, BucketMetrics, BucketLogging (Use [bucket notification](http://docs.minio.io/docs/minio-client-complete-guide#events) APIs)
- BucketRequestPayment
- BucketTagging

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

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

### Object name restrictions on Minio.

Object names that contain characters `^*|\&#34; are unsupported on Windows and other file systems which do not support filenames with these characters.
docs: Add docs for minio limitations. (#3477) 2016-12-20 23:42:13 +01:00			`## Minio Server Limits Per Tenant`

			`### Erasure Code (Multiple Drives / Servers)`

			`\|Item\|Specification\|`
			`\|:---\|:---\|`
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-16 02:45:57 +01:00			`\|Maximum number of servers\| 32\|`
			`\|Minimum number of servers\| 02\|`
			`\|Maximum number of drives per server\| Unlimited\|`
docs: Add docs for minio limitations. (#3477) 2016-12-20 23:42:13 +01:00			`\|Read quorum\| N/2\|`
			`\|Write quorum\| N/2+1\|`

			`### Browser Access`

			`\|Item\|Specification\|`
			`\|:---\|:---\|`
docs: use IEC format such as iB everywhere. (#4247) 2017-05-05 17:28:08 +02:00			`\|Web browser upload size limit\| 5GiB\|`
docs: Add docs for minio limitations. (#3477) 2016-12-20 23:42:13 +01:00
			`### Limits of S3 API`

			`\|Item\|Specification\|`
			`\|:---\|:---\|`
			`\|Maximum number of buckets\| no-limit\|`
			`\|Maximum number of objects per bucket\| no-limit\|`
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-17 02:05:00 +01:00			`\|Maximum object size\| 5 TiB\|`
docs: Add docs for minio limitations. (#3477) 2016-12-20 23:42:13 +01:00			`\|Minimum object size\| 0 B\|`
Increase maximum size of PUT request to 5TB (#5241) fixes #5148 2017-11-28 08:29:02 +01:00			`\|Maximum object size per PUT operation\| 5 TiB\|`
docs: Add docs for minio limitations. (#3477) 2016-12-20 23:42:13 +01: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-17 02:05:00 +01:00			`\|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\| 1000\|`
docs: Add docs for minio limitations. (#3477) 2016-12-20 23:42:13 +01:00			`\|Maximum number of objects returned per list objects request\| 1000\|`
			`\|Maximum number of multipart uploads returned per list multipart uploads request\| 1000\|`

Remove XL references in public docs to Erasure. (#3725) Ref #3722 2017-02-10 08:26:44 +01: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).`

docs: Add docs for minio limitations. (#3477) 2016-12-20 23:42:13 +01:00			`### List of Amazon S3 Bucket API's not supported on Minio.`

Remove XL references in public docs to Erasure. (#3725) Ref #3722 2017-02-10 08:26:44 +01:00			`- BucketACL (Use [bucket policies](http://docs.minio.io/docs/minio-client-complete-guide#policy) instead)`
			`- BucketCORS (CORS enabled by default on all buckets for all HTTP verbs)`
			`- BucketLifecycle (Not required for Minio erasure coded backend)`
			- BucketReplication (Use [`mc mirror`](http://docs.minio.io/docs/minio-client-complete-guide#mirror) instead)
			- BucketVersions, BucketVersioning (Use [`s3git`](https://github.com/s3git/s3git))
			- BucketWebsite (Use [`caddy`](https://github.com/mholt/caddy) or [`nginx`](https://www.nginx.com/resources/wiki/))
			`- BucketAnalytics, BucketMetrics, BucketLogging (Use [bucket notification](http://docs.minio.io/docs/minio-client-complete-guide#events) APIs)`
docs: Add docs for minio limitations. (#3477) 2016-12-20 23:42:13 +01:00			`- BucketRequestPayment`
			`- BucketTagging`

			`### List of Amazon S3 Object API's not supported on Minio.`

Remove XL references in public docs to Erasure. (#3725) Ref #3722 2017-02-10 08:26:44 +01:00			`- ObjectACL (Use [bucket policies](http://docs.minio.io/docs/minio-client-complete-guide#policy) instead)`
docs: Add docs for minio limitations. (#3477) 2016-12-20 23:42:13 +01:00			`- ObjectTorrent`
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-16 02:45:57 +01:00			`- ObjectVersions`
Document object name limitations on Windows (#5491) Fixes #5161 2018-02-03 15:27:40 +01:00
			`### 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.