NodeChef checks for ownership of the domain you specify by using a DNS TXT record. You will be required to create a TXT record with your DNS provider, NodeChef will then validate your domain by checking if your TXT record(s) contains the NodeChef token assigned to your domain. An app cannot be associated with more than five domains. If this limitation is unfavorable to your app, please contact us.
- Sign in and from the dashboard, locate your app listed under the task manager and click the domains button. The below popup be presented on the screen.
- Enter your domains in the text boxes and click create. This will generate for each domain entered a TXT record. See image below.
Note: Domains are treated as wildcard domains by default.
If you use example.com you will be able to serve traffic from any subdomain by default.
If you use app.example.com or sub.example.com your cluster will not be able to serve any subdomains that are not explicitly specified.
Create a TXT record with your dns provider and use the value supplied. See image below.
In case you already have an existing TXT record such as one to validate your domain to your mail provider, you can add the NodeChef token to it by seperating the values in your TXT record with a white space character.
- Once the TXT record is created, hover over the table cell which has your domain listed and click on the validate hyperlink. If this process succeeds,
the Validated column will change to Yes for the given domain. (See image in step 2)
If the validation fails, it is possible your DNS records may not have fully propagated yet.
Create a CNAME pointing to your NodeChef subdomain. For example: simple-todos-1.nodechef.com.
You can find your NodeChef subdomain under App actions → Custom domains.
NodeChef uses elastic load balancing and dynamically configures itself to support incoming traffic and handle load balancer fail overs. You can also create A and AAAA records pointing to the IPv4 and IPv6 addresses respectively if convenient. You should enable round robin load balancing with your DNS provider if possible.