If you would like to switch your DNS management to Cycle from an existing provider, adding a TXT record before changing the nameservers can minimize downtime.
Creating a cycle-verify TXT record.
- Sign into your Cycle account and go to the Hub thats serving your site.
- Click the Setting option from the left side navigation.
- Copy the Hub ID located on the right side of the screen.
- Open your current DNS management platform.
- Create a TXT record.
- Give the record a name of cycle-verify and a value of your hub id.
- Go back to Cycle and create your new DNS Zone.
- Click Verify Domain.
After adding a `cycle-verify` TXT record to your domain on your existing provider, Cycle is able to verify domain ownership prior to changing any nameservers / migrating DNS records.
If you would like to manage your DNS records on your own registrar but still want to point certain sub-domains to Cycle, that can be accomplished in a few steps.
The first thing you want to do is tell DNS Servers where to look for your Domain information.
To do this we will create a NS type record on your provider that says, when you encounter this sub-domain please look at Cycle's name servers for more information.
The NS record will include the sub-domain and a reference to Cycle's name servers.
Its important to do this three times one for each of the Cycle name servers which are.
In order for Cycle to verify the DNS Zone you are pointing your sub-domain to, you must include a text (txt) record.
To create this record you will need something from Cycle, the hub ID where you are going to create your DNS Zone.
To retrieve your hub ID simply click Settings on the left hand nav of your hub. After that you should see your hub ID on the right side of the screen.
You can now create your txt record. Go to your providers record creator and select a txt record. Name the record "cycle-verify" and paste the hub ID into the text value section of the form.
If you have never created a DNS Zone on Cycle please reference this guide.
The next step would be to create and verify your new zone. In this case we will create a zone that includes the full domain name.
If your domain was "example.com" and your sub-domain is "docs" enter "docs.example.com" into the origin field when creating your zone.
Select the Hosted Zone option from the dropdown.
After your zone has been created click the Verify button on the top right of the screen.
If you have never added a record to a DNS Zone on Cycle please reference this guide.
Add a Linked record and point it at the container serving the contents of your sub-domain.
If you've got questions about the platform or need some help getting started, our team is more than happy to assist. Whether you're new to containers or just new to Cycle, reach out to us via livechat by clicking the blue circle in the bottom right corner. Join our Slack channel, and get help from the dev team or other members of the community, and check out our Roadmap to see what's planned for the future!