Virtual-hosted–style requests

RustFS supports both S3 URL addressing styles:

1. Virtual-hosted–style
2. Path-style

The difference is where the bucket name appears in the URL.

Path-style addressingCopy Anchor Link

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

Example (bucket: my-bucket, host: rustfs.example.com):

http://rustfs.example.com/my-bucket

Virtual-hosted–style addressingCopy Anchor Link

In a virtual-hosted–style URL, the bucket name is part of the hostname.

Example (bucket: my-bucket, host: rustfs.example.com):

http://my-bucket.rustfs.example.com/

Configure the domainCopy Anchor Link

1. Create a wildcard DNS record (for example, *.rustfs.example.com → your server's IP address).
2. Set RUSTFS_SERVER_DOMAINS=rustfs.example.com in the server configuration (Linux: /etc/default/rustfs; Docker or Kubernetes: the same environment variable). Do not include a port when clients use the S3 API listener's own port.
3. Restart RustFS (sudo systemctl restart rustfs on a systemd install).

Virtual-hosted routing applies to the S3 API listener (port 9000 by default). RustFS matches Host headers that use that listener's port. Include a port in RUSTFS_SERVER_DOMAINS only when clients reach RustFS through a different port, for example a proxy on port 8000.

RUSTFS_SERVER_DOMAINS=rustfs.example.com:8000

Requests such as the following are then routed with virtual-hosted–style addressing:

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

Next stepsCopy Anchor Link

• S3 API overview
• Environment variables