Permalink
Fetching contributors…
Cannot retrieve contributors at this time
93 lines (51 sloc) 5.89 KB
title order description
DNS
21
Learn how to configure DNS to point to Galaxy

Before users can access your application, you must configure your DNS records to point to Galaxy. Galaxy is not a DNS provider and you’ll need to use your existing DNS provider to set DNS records. While the process will be specific to your DNS provider, the general method is the same.

Included *.meteorapp.com

You are free to use Galaxy's built-in domain names. SSL is enabled on these domains by default.

If you're in the US region (galaxy.meteor.com), deploy your example app to example.meteorapp.com.

If you're in the EU region (eu-west-1.galaxy.meteor.com), deploy your example app to example.eu.meteorapp.com.

If you're in the Asia-Pacific region (ap-southeast-2.galaxy.meteor.com), deploy your example app to example.au.meteorapp.com.

Substitute in the actual name of your app for 'example'. Beyond that, no DNS configuration is necessary; Galaxy handles all of this for you.

Note: example.meteor.com is not available. You cannot deploy to meteor.com domains.

Hosting on a subdomain with CNAME

If your app is deployed at a subdomain such as www.mycompany.com or app.mycompany.com, simply add a CNAME record to your DNS provider pointing to:

  • us-east-1.galaxy-ingress.meteor.com for applications in the US East region.

  • eu-west-1.galaxy-ingress.meteor.com for applications in the EU West region.

  • ap-southeast-2.galaxy-ingress.meteor.com for applications in the Asia-Pacific region.

Ensure the hostname you deployed to matches the fully qualified domain name of your app (i.e app.mycompany.com).

We recommend you use SSL as a best practice. You can either enable LetsEncrypt using our integration or upload your own certificate.

Redirecting the root domain

The root domain is also called the naked or apex domain. A common scenario is when your app is hosted at www.mycompany.com and you'd like mycompany.com to redirect to the same app. In this scenario, you don't want to emphasize the shorter URL of mycompany.com.

This is done by setting up URL redirection from mycompany.com to www.mycompany.com. While the way to do this varies by DNS provider, these are common methods we recommend:

Because another service is hosting the redirect page, you'll need to set up SSL using their methods, which will most likely involve a certificate upload.

If you'd like to host on Galaxy on the naked domain with HTTPS, or would like to serve a redirect from Amazon S3 via Amazon CloudFront (which supports custom certs), this guide, from a member of the DNSimple team, may be helpful.

Hosting on a root domain using ALIAS

In this scenario, you do want to emphasize a short URL like mycompany.com. While hosting on a root domain can introduce complications, it's possible to do by using an ALIAS (also called an ANAME record).

First, you'll need to either deploy your app to the root domain (e.g myapp.com) or add the root domain as an additional domain for your app. Next, you will need to add an ALIAS record to your DNS provider that points your root domain to galaxy-ingress.meteor.com.

Not all DNS providers support this feature and the implementation is usually very specific to each provider. Providers we know and recommend are:

Note: If you decide to host directly on a root domain, you will likely want to forward www to your root domain by setting up URL redirection (see above).

We recommend you use SSL as a best practice. You can either enable LetsEncrypt using our integration or upload your own certificate.

DNS propagation

DNS is distributed and cooperative, and it takes time for the world to see your changes. In many countries, it usually updates within about 30 minutes, but it can take up to 24 hours or even longer in some circumstances (depending on the record's TTL).

You can check if your ALIAS or ANAME or CNAME setting was successful in the terminal by typing dig +show www.mycompany.com. If your ANSWER SECTION includes a record like this, you are in good shape:

www.mycompany.com.    1800   IN    CNAME        galaxy-ingress.meteor.com.

Testing your DNS changes

A quick way to test that your app is working is by modifying the /etc/hosts file to resolve your app's hostname to the Galaxy load balancer's IP address directly. Note that this will only affect your local machine.

To find out which IP address to use, type dig +short galaxy-ingress.meteor.com and choose any of the ones shown. The IP addresses used by Galaxy's load balancer are likely to change, so you may need to do this process more than once.

Add a line to /etc/hosts (Windows: c:\windows\system32\drivers\etc\hosts) that contains:

[Galaxy's current ip address]   [Your app's hostname, e.g app.mycompany.com]

To ensure your changes take effect, you can reset your computer's local DNS cache with sudo dscacheutil -flushcache (Mac; see other OSes) after making your changes.

Other issues

Galaxy is not a DNS record provider. Our support is focused on configuring your settings to work with Galaxy apps, as described in the sections above.

If you have additional issues which reach beyond the scope of this article, you may need to contact your DNS record provider to resolve them.