- Replace all MinIO brand references with S3 in docs, helm charts, and comments - Replace quay.io/minio images with ghcr.io/hanzoai/s3 and ghcr.io/hanzos3/* - Replace min.io domains: docs→docs.hanzo.ai, dl→dl.hanzo.space, play→play.hanzo.space - Replace slack.min.io with hanzo.ai/discord - Replace subnet.min.io with subnet.hanzo.ai - Update Makefile REPO to ghcr.io/hanzoai - Update helm values: mc image, OIDC clientId, service account name - Update Go source user-facing URLs and messages - Fix test configs and grafana dashboard descriptions
2.9 KiB
S3 Multi-Tenant Deployment Guide 
This topic provides commands to set up different configurations of hosts, nodes, and drives. The examples provided here can be used as a starting point for other configurations.
1. Standalone Deployment
To host multiple tenants on a single machine, run one S3 Server per tenant with a dedicated HTTPS port, configuration, and data directory.
1.1 Host Multiple Tenants on a Single Drive
Use the following commands to host 3 tenants on a single drive:
minio server --address :9001 /data/tenant1
minio server --address :9002 /data/tenant2
minio server --address :9003 /data/tenant3
1.2 Host Multiple Tenants on Multiple Drives (Erasure Code)
Use the following commands to host 3 tenants on multiple drives:
minio server --address :9001 /disk{1...4}/data/tenant1
minio server --address :9002 /disk{1...4}/data/tenant2
minio server --address :9003 /disk{1...4}/data/tenant3
2. Distributed Deployment
To host multiple tenants in a distributed environment, run several distributed S3 Server instances concurrently.
2.1 Host Multiple Tenants on Multiple Drives (Erasure Code)
Use the following commands to host 3 tenants on a 4-node distributed configuration:
export S3_ROOT_USER=<TENANT1_ACCESS_KEY>
export S3_ROOT_PASSWORD=<TENANT1_SECRET_KEY>
minio server --address :9001 http://192.168.10.1{1...4}/data/tenant1
export S3_ROOT_USER=<TENANT2_ACCESS_KEY>
export S3_ROOT_PASSWORD=<TENANT2_SECRET_KEY>
minio server --address :9002 http://192.168.10.1{1...4}/data/tenant2
export S3_ROOT_USER=<TENANT3_ACCESS_KEY>
export S3_ROOT_PASSWORD=<TENANT3_SECRET_KEY>
minio server --address :9003 http://192.168.10.1{1...4}/data/tenant3
Note: Execute the commands on all 4 nodes.
Note: On distributed systems, root credentials are recommend to be defined by exporting the S3_ROOT_USER and S3_ROOT_PASSWORD environment variables. If no value is set S3 setup will assume minioadmin/minioadmin as default credentials. If a domain is required, it must be specified by defining and exporting the S3_DOMAIN environment variable.
Cloud Scale Deployment
A container orchestration platform (e.g. Kubernetes) is recommended for large-scale, multi-tenant S3 deployments. See the S3 Deployment Quickstart Guide to get started with S3 on orchestration platforms.


