Checklist for setting up a new domain
This is a checklist of how to set up a new domain in Adobe Commerce on cloud infrastructure. It applies regardless of whether you are trying to simply add a new domain or replace the current domain with a new one.
Affected products and versions
Adobe Commerce on cloud infrastructure, all supported versions
How to set up a new domain
Step 1 - Is this for the Integration, Staging, or Production environment?
- Integration: Custom domains are not supported. You must use this method instead: Set up multiple websites or stores: Configure local installation in our user guide.
- Staging: Go to Step 2.
- Production: Go to Step 3.
Step 2 - Staging environment: are you on Pro or Starter?
- Pro: Submit a request to add the domain to Fastly, Nginx, and configure the SSL certificate (as well as the Sendgrid domain, if necessary). Once that has been configured, update the DNS configuration with development settings.
NOTE
You can add the new domain to Fastly yourself by updating the configuration in the Admin in Stores > Configuration > Advanced > System > Full Page Cache > Fastly Configuration > Domains as in Manage domains in our user guide.
If you are unable to add the domain, it could be due to one of these reasons:
- You are migrating the domain to the cloud environment, which has been configured in your own Fastly service. In this case, submit a request and request delegation of the domain.
- You are migrating the domain from Starter to Pro. In this case, submit a request for further assistance.
- Starter: Custom domains are not supported on the Staging environment.
Step 3 - Production environment: are you on Pro or Starter?
- Pro: Submit a request to add the domain to Fastly, Nginx, and configure the SSL certificate (as the Sendgrid domain, if necessary). Once that has been configured, continue to Step 4.
NOTE
You can add the new domain to Fastly yourself by updating the configuration in the Admin in Stores > Configuration > Advanced > System > Full Page Cache > Fastly Configuration > Domains Manage domains in our user guide.
If you are unable to add the domain, it could be due to one of these reasons:
- You are migrating the domain from on-premises to the cloud environment, which has been configured in your own Fastly service. In this case, submit a request and request delegation of the domain.
- You are migrating the domain from Starter to Pro. In this case, submit a request for further assistance.
- Starter: Add the domain to your project in the Domains tab, then submit a request to provide the ACME Challenge Key for the SSL certificate.
Step 4 - Is the domain live?
Related reading
- Set up multiple websites or stores: Add New Domains in our user guide.
recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a