Managing domains

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

Note for Acquia Cloud Site Factory subscribers

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.

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

Domains page

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) so that requests for that domain name are 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 IP address and the name of the elastic load balancer (ELB) — if applicable — for each of your environments is on the Domains page.

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

If you are an Acquia Cloud Free subscriber, custom domain names are not supported. Learn more about Acquia Cloud Free and how to upgrade your Acquia Cloud subscription.

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, exact domain name with 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 that 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. On the Applications > [Environment] > Domains page, click the Status link for the domain. 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, be sure that you have followed the instructions in Pointing DNS records to your public IP addresses.

Because Acquia Cloud cannot determine the status of wildcard (*) domains, the Status link is disabled 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 that 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 are served 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.

Contact supportStill need assistance? Contact Acquia Support

Acquia: Think Ahead

53 State Street, 10th Floor
Boston, MA 02109
United States
Phone: 888-922-7842

Map: Google Maps
View other locations