Virtual-Hosted–Style Requests

RustFS supports both S3 URL addressing styles:

1. Virtual Host Style
2. Path Style

The two styles differ in where the bucket name appears in the URL.

Path StyleCopy Anchor Link

Path-style addressing is the default. In a path-style URL, the bucket name follows the endpoint.

Example (Bucket: test, Host: rustfs.yourdomain.com):

http://rustfs.yourdomain.com/test

Note: No configuration is required for Path Style.

Virtual Host StyleCopy Anchor Link

In Virtual Host Style, the bucket name is part of the domain.

Example (Bucket: test, Host: rustfs.yourdomain.com):

http://test.rustfs.yourdomain.com/

ConfigurationCopy Anchor Link

1. DNS: Create a wildcard DNS record (for example, *.rustfs.yourdomain.com → your server's IP address).
2. Configuration: Modify the configuration file (Linux: /etc/default/rustfs, Docker/K8s: env vars).
3. Set Domain: Set RUSTFS_SERVER_DOMAINS = "rustfs.yourdomain.com".
4. Restart: Restart the service (systemctl restart rustfs).

Port in Domain (Optional)Copy Anchor Link

Virtual-host routing applies to the S3 API listener (port 9000 by default); RustFS automatically matches Host headers that carry the S3 listener's own port. Only when clients reach RustFS through a different port (for example via a proxy) do you need to include that port in RUSTFS_SERVER_DOMAINS.

Example (rustfs.yourdomain.com:8000):

RUSTFS_SERVER_DOMAINS = "rustfs.yourdomain.com:8000"

This ensures that requests like:

http://my-bucket.rustfs.yourdomain.com:8000/

are routed correctly with virtual-hosted–style addressing.