With ZEIT Now, you can assign a domain name to any of your deployments in. If you have a domain registered on another service, such as GoDaddy, you must first point your domain to ZEIT Now in order to use it for your deployments.
This guide will cover how to point your GoDaddy registered domain towards ZEIT Now in order to use your domain for your deployments.
The first step of pointing an external domain to ZEIT Now is to add your domain to your ZEIT account or team and verifying ownership.
To add a domain with Now CLI, use the following command in your terminal:
now domains add <domain>
Once you have added the domain, Now CLI will present you with some information about verifying it.
This is the fastest method of getting started with your domain on ZEIT Now. When using nameservers, you are both verifying and pointing to ZEIT Now all at once.
When using this method, however, if the domain was previously pointing to another host and if you have not yet configured ZEIT Now for your domain, e.g. generating SSL certificates; when it does point to ZEIT Now, it will invoke downtime until the configuration is done. To avoid this, use the
TXT verification method.
If you want to verify with nameservers, you must use the intended set of nameservers given to you when you added the domain with Now CLI. If you need to be reminded of these nameservers, you can use the following command:
now domains inspect <domain>
With the intended set of nameservers, you shall need to apply them to your domain through the GoDaddy through their account dashboard and clicking through to manage your domain.
Going to GoDaddy.com and logging in will result in a page like this:
Next, click on the "DNS" button on the domain you want to migrate to ZEIT Now. You will be brought to a page with the two uppermost sections being "Records" and "Nameservers".
Apply the nameservers you received from adding your domain or from the inspect command in the order they are given and then save the configuration.
After GoDaddy has propagated the changed DNS for your domain, your domain is ready to be verified. ZEIT will automatically check the domain periodically for verification, though if you want to verify it yourself, use the following command:
now domains verify <domain>
This method is used when you want to verify your domain but you do not yet want to point to ZEIT Now, for example if you need to configure ZEIT Now beforehand in order for zero-downtime.
You can add the TXT record by going to your GoDaddy domains dashboard, as in the nameservers method, and clicking on
DNS on the domain you want to migrate, then clicking add in the "Records" section.
TXT as the record type to add,
_now as the host, and the value you were given for the record when adding your domain or when using the
now domains inspect <domain> Now CLI command.
Once you have added the TXT record, your domain can be verified. ZEIT will periodically check your domain to see if it is verified, but if you do not want to wait and want to start using your domain with ZEIT Now immediately, use the following command to force a verification check:
now domains verify <domain>
If you have used either verification method, the next step may be to configure your domain with DNS records and to use it for a deployment.
Whether you are matching a previous configuration for your domain for a zero-downtime migration or just want to set up DNS records, ZEIT Now provides an easy to use command that allows you to add DNS records from the CLI.
For example, adding a set of Gmail MX records with the
now dns add command:
now dns add <domain> @ MX ASPMX.L.GOOGLE.COM 1 && now dns add <domain> @ MX ALT1.ASPMX.L.GOOGLE.COM 5 && now dns add <domain> @ MX ALT2.ASPMX.L.GOOGLE.COM 5 && now dns add <domain> @ MX ALT3.ASPMX.L.GOOGLE.COM 10 && now dns add <domain> @ MX ALT4.ASPMX.L.GOOGLE.COM 10
Adding your production domain to a project can be done from the ZEIT Dashboard by selecting the project's Domains tab and entering it there, you can find more information on this in the custom domains documentation.
You can then deploy to your production domain with a single command:
We highly recommend using either the ZEIT Now for GitHub, ZEIT Now for GitLab, or ZEIT Now for Bitbucket apps which will allow your app to be deployed to your production on push to your GitHub repository, GitLab project, or Bitbucket repository.
As with the "Verifying with Nameservers" step, this final part of the migration process will point your domain to ZEIT DNS with the intended nameservers set. If you did not save them when you added your domain, you can see the intended list by running the
now domains inspect <domain> command.
If you verified with nameservers, this step is already complete!
To set your nameservers, on the DNS management page as you added the TXT record, at the bottom of that page will be a section that allows you to enter custom nameservers
Once GoDaddy propagates the changes to the domain with the updated nameservers, your domain will then point to the app you deployed before.
That's all. Your domain is successfully migrated to using ZEIT DNS and pointing to your ZEIT Now deployed app.