Information for: DEVELOPERS   PARTNERS

Managing domains


Acquia Cloud Site Factory subscribers must use the Acquia Cloud Site Factory domains functionality to add additional domains to their subscriptions. Domains added using the Acquia Cloud user interface will not 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 You should then configure a DNS domain name for the Production environment, such as, and configure DNS records to use your public IP addresses, rather than using the default domain name.

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. Acquia Cloud will display information about your domains based on the type of SSL certificate you have installed.

The DNS information card displays the IP addresses (A records) for the top-level domain name.

Box displaying DNS information for this subscription

Acquia Cloud Professional subscribers have a single IP address for all three environments. Acquia Cloud Enterprise subscribers can have several IP addresses for their environments.

If your subscription includes an elastic load balancer (ELB) attached to your environment for legacy SSL, the DNS information card displays both IP address and CNAME information.

Box displaying DNS information for this subscription

  • IP addresses (A records) for the top-level domain name.
  • Canonical name (CNAME), or a domain name that maps to the displayed IP addresses.
  • Elastic load balancers (ELBs) attached to your environment for legacy SSL.

Acquia Cloud Professional subscribers have a single IP address for all three environments. Acquia Cloud Enterprise subscribers can have several IP addresses for their environments.

Table of domain names added to this environment

When each environment is created, it is provisioned with a single custom Acquia Cloud subdomain with a name that ends in After creation, Acquia Cloud subdomains cannot be changed, and additional custom Acquia Cloud subdomains cannot be added to an environment.

After you add a domain name to the Production environment, the Acquia Cloud load balancers can send incoming requests to your application for that domain name. Your DNS provider has to point your domain names to the IP address of the environment (Dev, Stage, or Prod) which causes requests for that domain name to be directed to the Acquia Cloud load balancers for your application. You can also add domain names to your Development and Staging environments.

Adding a domain name

Unsupported for Acquia Cloud Free

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


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 instead of


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

  3. Click Add domain.

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


You cannot 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 environment 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 different from your Acquia application. The Domain Status report displays the IP address and any alias 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 have not set up the domain name with any DNS provider.

If your domain name does not resolve to your Acquia application, or if it does not 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.


The 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).

Managing your application’s Varnish cache

This section does not apply to Node.js environments, as they do not 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 domains

Since applications that use the default domain name ending in 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, will operate normally and will be able to index your application for searches.