Information for: DEVELOPERS   PARTNERS

Managing domains

Note

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 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 to use your public IP addresses, rather than using the acquia-sites.com default domain name.

To view the domain information for an environment, go to the Applications > [Environment] > Domains page.

Box displaying DNS information for this subscription

Table of domain names added to this environment

Note that when each environment is created, it is provisioned with a single custom Acquia Cloud subdomain with a name that ends in acquia-sites.com. 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.

Viewing your IP address

The domain information for each of your environments is displayed on the Domains page. Depending on your subscription’s configuration, the information can include the following items:

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

Acquia Cloud Professional accounts have a single IP address for all three environments. Acquia Cloud Enterprise accounts can have multiple addresses.

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.

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 multiple 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 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.

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.

Because Acquia Cloud cannot 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 cannot 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 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.