minio/docs/minio-limits.md

## MinIO Server Limits Per Tenant
For best deployment experience MinIO recommends operating systems RHEL/CentOS 8.x or later, Ubuntu 18.04 LTS or later. These operating systems package the latest 'xfsprogs' that support large scale deployments.

### 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 range                                                                 | 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                     | 4500                                          |
| Maximum number of multipart uploads returned per list multipart uploads request | 1000                                          |
| Maximum length for bucket names                                                 | 63                                            |
| Maximum length for object names                                                 | 1024                                          |
| Maximum length for '/' seperated object name segment                            | 255                                           |

### 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 platform or any other file systems that do not support filenames with special charaters. **This list is non exhaustive, it depends on the operating system and filesystem under use - please consult your operating system vendor**. MinIO recommends using Linux based deployments for production workloads.

- Objects should not have conflicting objects as parents, applications using this behavior should change their behavior and use proper unique keys, for example situations such as following conflicting key patterns are not supported.

```
PUT <bucketname>/a/b/1.txt
PUT <bucketname>/a/b
```

```
PUT <bucketname>/a/b
PUT <bucketname>/a/b/1.txt
```
Replace Minio refs in docs with MinIO and links (#7494) 2019-04-09 14:39:42 -04:00			`## MinIO Server Limits Per Tenant`
fix: remove parentIsObject() check (#12851) we will allow situations such as ``` a/b/1.txt a/b ``` and ``` a/b a/b/1.txt ``` we are going to document that this usecase is not supported and we will never support it, if any application does this users have to delete the top level parent to make sure namespace is accessible at lower level. rest of the situations where the prefixes get created across sets are supported as is. 2021-08-03 16:26:57 -04:00			`For best deployment experience MinIO recommends operating systems RHEL/CentOS 8.x or later, Ubuntu 18.04 LTS or later. These operating systems package the latest 'xfsprogs' that support large scale deployments.`
docs: Add docs for minio limitations. (#3477) 2016-12-20 17:42:13 -05:00
			`### Erasure Code (Multiple Drives / Servers)`

docs: fix per tenant limits docs formatting 2021-05-24 12:37:17 -04:00			`\| 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 \|`
Revert "deprecate embedded browser (#12163)" This reverts commit 736d8cbac483d8bf56c3422ca9a9c4c3e043c6cf. Bring contrib files for older contributions 2021-04-29 22:01:43 -04:00
docs: Add docs for minio limitations. (#3477) 2016-12-20 17:42:13 -05:00			`### Limits of S3 API`

docs: fix per tenant limits docs formatting 2021-05-24 12:37:17 -04:00			`\| 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 range \| 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 \| 4500 \|`
			`\| Maximum number of multipart uploads returned per list multipart uploads request \| 1000 \|`
docs: add limits for bucket and object name length (#12564) 2021-06-23 15:51:31 -04:00			`\| Maximum length for bucket names \| 63 \|`
			`\| Maximum length for object names \| 1024 \|`
			`\| Maximum length for '/' seperated object name segment \| 255 \|`
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			`### List of Amazon S3 API's not supported on MinIO`
docs: fix per tenant limits docs formatting 2021-05-24 12:37:17 -04: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).`
Remove XL references in public docs to Erasure. (#3725) Ref #3722 2017-02-10 02:26:44 -05:00
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`
fix: remove parentIsObject() check (#12851) we will allow situations such as ``` a/b/1.txt a/b ``` and ``` a/b a/b/1.txt ``` we are going to document that this usecase is not supported and we will never support it, if any application does this users have to delete the top level parent to make sure namespace is accessible at lower level. rest of the situations where the prefixes get created across sets are supported as is. 2021-08-03 16:26:57 -04:00			- Object names that contain characters `^\|\/&";` are unsupported on Windows platform or any other file systems that do not support filenames with special charaters. This list is non exhaustive, it depends on the operating system and filesystem under use - please consult your operating system vendor*. MinIO recommends using Linux based deployments for production workloads.
docs: fix per tenant limits docs formatting 2021-05-24 12:37:17 -04:00
fix: remove parentIsObject() check (#12851) we will allow situations such as ``` a/b/1.txt a/b ``` and ``` a/b a/b/1.txt ``` we are going to document that this usecase is not supported and we will never support it, if any application does this users have to delete the top level parent to make sure namespace is accessible at lower level. rest of the situations where the prefixes get created across sets are supported as is. 2021-08-03 16:26:57 -04:00			`- Objects should not have conflicting objects as parents, applications using this behavior should change their behavior and use proper unique keys, for example situations such as following conflicting key patterns are not supported.`

			```
			`PUT <bucketname>/a/b/1.txt`
			`PUT <bucketname>/a/b`
			```

			```
			`PUT <bucketname>/a/b`
			`PUT <bucketname>/a/b/1.txt`
			```