Table of ContentsView in Frames

Specifying the root domain name

You should use the Configuration tab to specify the root domain name for your StorageGRID Webscale system, and to view or download the suggested list of DNS resource records.

About this task

The root domain name value you specify is used to generate Domain Name System (DNS) resource records for each Storage Node and API Gateway Node in your StorageGRID Webscale system. You can select the DNS resource records for the endpoints you want to use to configure your DNS server.

Note: The local host names of the API Gateway Nodes and Storage Nodes are assumed to be the same as the node names in the grid specification file.

The generated DNS resource records include both common entries for S3 path-style requests and wildcard (*) entries for S3 virtual-hosted style requests. Your system administrator must add the appropriate entries for each endpoint, and for the types of requests the system will support. In most cases, StorageGRID Webscale should be configured to support both styles of requests.

Your system administrator must also configure a custom server certificate for the StorageGRID Webscale system with a wildcard Subject Alternative Name (SAN) for each endpoint, and possibly each IP address. These steps are required to validate the SSL certificate and verify the hostname when API client applications connect to the endpoint.


  1. Select Grid Configuration > Domain Names.
  2. Click the Configuration tab.
  3. Enter the Root Domain Name to use for your StorageGRID Webscale system and click Apply Changes.
    For example:
    The server-specific DNS entries for all Storage Nodes and API Gateway Nodes are auto-generated.
  4. If you want to download a text file with the generated resource records in the required DNS zone file format, click Download DNS Resource Records and save the file.
  5. If you want to view the suggested list of DNS resource records for S3 path-style requests and for S3 virtual hosted-style requests, click the Overview tab.