Information for: DEVELOPERS   PARTNERS

Managing domains

Note

Acquia Cloud Site Factory subscribers must use the Acquia Cloud Site Factory domains functionality to add more domains to their subscriptions. Domains added using the Acquia Cloud user interface won’t work, and may be deleted by automated processes.

After you create or import your application into Acquia Cloud, you can access each of your application’s environments using its default domain name. An environment’s default domain name is based on its application name (or sitename) and realm (for example, the domain name for a Production environment could be examplesite.devcloud.acquia-sites.com). You should then configure a DNS domain name for the Production environment, such as www.example.com, and configure DNS records using the information located at the top of your Domains page.

Limitations on default domain names

The default acquia-sites.com domain name provided with your subscription has the following limitations:

  • Don’t route production traffic to your acquia-sites.com domain unless it is explicitly listed under the DNS section of your Domains page.
  • After creation, your acquia-sites.com domain can’t be changed or removed.
  • You can’t add more custom acquia-sites.com domains to an environment.
  • Search engine indexing of these domains is disallowed in your robots.txt file.
  • Acquia Cloud Site Factory default domain names use acsitefactory.com instead of acquia-sites.com.
  • You can’t generate a Certificate Signing Request (CSR) for an acquia-sites.com domain.
  • SSL certificates must not pin to the SSL certificate provided by Acquia for *.acquia-sites.com domains.
  • Unless your acquia-sites.com domain is listed under DNS on the Domains page, or you are an Acquia Cloud Site Factory subscriber, pointing your CNAME to an acquia-sites.com domain can make your application load inefficiently, and can cause unpredictable results or even downtime during platform maintenance activities.

Viewing your IP address or CNAME

To view the domain information for an environment, go to the Applications > [Environment] > Domains page, and then scroll to the DNS information card.

The DNS information card displays the CNAMEs and IP addresses (A records) you will need to configure DNS settings for your domains.

Table of domain names added to this environment

After an environment is created, Acquia Cloud provisions the environment with a custom Acquia Cloud subdomain with a name ending in acquia-sites.com. For limits on these default domain names, see Limitations on default domain names.

After you add a custom domain name to an environment, the Acquia Cloud platform can route incoming requests for that domain name to the environment selected. You must then configure your DNS settings with your DNS provider to ensure all requests for that domain are routed to Acquia Cloud.

Adding a domain name

Unsupported for Acquia Cloud Free

Custom domain names aren’t supported in Acquia Cloud Free, but you can upgrade your Acquia Cloud Free subscription to a subscription level that supports custom domains.

Important

The first top-level domain name you add to Acquia Cloud, with or without the www prefix, is known as the active domain, and will be used in Acquia’s automated monitoring systems.

To add a domain to one of your application’s environments, complete the following steps:

  1. On the Domains page for the environment into which you want to add a domain, click Add Domain in the upper right.

    The add domain icon

    The Add a domain dialog box appears.

  2. In the Domain to add field, enter the domain name without the protocol header. For example, use mysite.com instead of http://mysite.com.

    Note

    You can use the wildcard character ( * ) to make your environment available for several subdomains (for example, *.example.com).

  3. Click Add domain.

If you want to make your application available to multiple related domain names (such as example.com and www.example.com), individually add each domain name. Otherwise, you can use the wildcard character ( * ) in a single domain entry to allow for subdomains.

Note

You can’t use the same domain name for two different environments or codebases at the same time, unless one environment is part of an Acquia Cloud Professional subscription and the other is part of an Acquia Cloud Enterprise subscription.

Subscribers with many domains may have several pages of domain names displayed on their Domains page. You can either use the pager to browse for a domain, or use the Filter Domains field to search.

Learn more by visiting the Acquia Academy (sign-in required) for the video tutorial on Adding Domains in Acquia Cloud.

Adding domains with non-Latin characters

By default, the domain name you use must be composed of Latin-based characters. If you have a domain that uses non-Latin characters, you can use Punycode to convert these characters into values recognized by standard DNS.

After converting your characters with Punycode and using them with your domain name in place of the non-Latin characters, you should be able to configure your DNS entries normally.

Checking domain status

You can determine whether your domain name is properly resolving to your Acquia Cloud website by clicking click the Status link for the domain on the Applications > [Environment] > Domains page. Acquia performs a DNS lookup for your domain name and displays one of the following status messages:

  • DNS resolves to Acquia: Your DNS settings and Acquia Cloud are properly configured.
  • DNS doesn’t resolve directly to Acquia: Your DNS provider is pointing your domain name to an IP address or CNAME different from the one assigned to that application’s environment. The Domain Status report displays the DNS data and any aliases found for the domain name. This status is normal if you use a CDN with your website. Otherwise, your domain name and DNS settings may be misconfigured.
  • DNS does not resolve: You haven’t set up the domain name with any DNS provider.

If your domain name doesn’t resolve to your Acquia application, or if it doesn’t resolve at all, ensure you have followed the instructions in Pointing DNS records to your public IP addresses.

Acquia Cloud can’t determine the status of wildcard (*) domains; it disables the Status link for these domains.

Removing a domain name

To remove a domain from an environment, complete the following steps:

  1. Go to the Applications > [Environment] > Domains page.
  2. Find the domain you want to delete, and then click Remove for that domain.
  3. To confirm your choice, click Remove.

Note

The acquia-sites.com default domain name can’t be removed–it is necessary to enable Acquia Support and Operations to reach your application (even if DNS is not working). For more information, see Limitations on default domain names.

Managing your application’s Varnish cache

This section doesn’t apply to Node.js environments, as they don’t have a Varnish® cache.

Each domain name associated with your account has its own Varnish cache to speed page access.

If your application supports Varnish caching, clearing these caches ensures that anonymous website visitors get the most up-to-date version of your application after you make any changes.

To clear the Varnish cache for a domain name, click the Clear Varnish link for the domain. For more information, see Using Varnish.

Search indexing is blocked for acquia-sites.com domains

Since applications that use the default domain name ending in acquia-sites.com aren’t intended to be publicly available, Acquia Cloud uses a robots.txt file to disallow indexing of those domains by search engine robots. Robots that reach your application using your DNS domain name, such as www.example.com, will operate normally and will be able to index your application for searches. For more information, see Limitations on default domain names.