minio/docs/minio-limits.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| 5 TiB|

### 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|

### 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.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`](https://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](https://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](https://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. Note that this list is not exhaustive, and depends on the maintainers of the filesystem itself.
docs: Add docs for minio limitations. (#3477) 2016-12-20 17:42:13 -05: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-15 20:45:57 -05: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 17:42:13 -05:00			`\|Read quorum\| N/2\|`
			`\|Write quorum\| N/2+1\|`

			`### Browser Access`

			`\|Item\|Specification\|`
			`\|:---\|:---\|`
Rename minio-limitations.md to minio-limits.md (#5541) 2018-02-15 23:05:02 -05:00			`\|Web browser upload size limit\| 5 TiB\|`
docs: Add docs for minio limitations. (#3477) 2016-12-20 17:42:13 -05:00
			`### 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\|`
			`\|Maximum number of parts returned per list parts request\| 1000\|`
docs: Add docs for minio limitations. (#3477) 2016-12-20 17:42:13 -05:00			`\|Maximum number of objects returned per list objects request\| 1000\|`
			`\|Maximum number of multipart uploads returned per list multipart uploads request\| 1000\|`

Rename minio-limitations.md to minio-limits.md (#5541) 2018-02-15 23:05:02 -05: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).`

Rename minio-limitations.md to minio-limits.md (#5541) 2018-02-15 23:05:02 -05: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
docs: fix all Chinese doc links for the new docs site (#6097) Additionally fix typos, default to US locale words 2018-06-28 19:02:02 -04:00			`- BucketACL (Use [bucket policies](https://docs.minio.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)`
			`- BucketLifecycle (Not required for Minio erasure coded backend)`
docs: fix all Chinese doc links for the new docs site (#6097) Additionally fix typos, default to US locale words 2018-06-28 19:02:02 -04:00			- BucketReplication (Use [`mc mirror`](https://docs.minio.io/docs/minio-client-complete-guide#mirror) instead)
Remove XL references in public docs to Erasure. (#3725) Ref #3722 2017-02-10 02:26:44 -05:00			- 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/))
docs: fix all Chinese doc links for the new docs site (#6097) Additionally fix typos, default to US locale words 2018-06-28 19:02:02 -04:00			`- BucketAnalytics, BucketMetrics, BucketLogging (Use [bucket notification](https://docs.minio.io/docs/minio-client-complete-guide#events) APIs)`
docs: Add docs for minio limitations. (#3477) 2016-12-20 17:42:13 -05:00			`- BucketRequestPayment`
			`- BucketTagging`

Rename minio-limitations.md to minio-limits.md (#5541) 2018-02-15 23:05:02 -05: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
docs: fix all Chinese doc links for the new docs site (#6097) Additionally fix typos, default to US locale words 2018-06-28 19:02:02 -04:00			`- ObjectACL (Use [bucket policies](https://docs.minio.io/docs/minio-client-complete-guide#policy) instead)`
docs: Add docs for minio limitations. (#3477) 2016-12-20 17:42:13 -05: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-15 20:45:57 -05:00			`- ObjectVersions`
Document object name limitations on Windows (#5491) Fixes #5161 2018-02-03 09:27:40 -05:00
Rename minio-limitations.md to minio-limits.md (#5541) 2018-02-15 23:05:02 -05:00			`### Object name restrictions on Minio`
docs/minio-limits.md formatting (#6683) Formatted docs to show missing "\" character, added "/" to list of unsupported chars and made note of the fact that list is not exhaustive. 2018-10-23 00:00:46 -04: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.