To add a DNS zone in WHM, navigate to the Add a DNS Zone interface, enter the domain name and IP address, optionally associate it with an account, and click Add Zone. The system automatically creates the zone file from your configured template, enabling proper DNS routing for the domain.
DNS zones are administrative sections of the domain name system that control how internet traffic reaches your websites. While OBHost automatically configures DNS zones when you add new domains to your server, this interface lets you manually create zones for remote domains or specialized configurations.
What Is a DNS Zone?
A DNS zone is a portion of the domain name system that you manage on your server. It contains DNS records that tell the internet where to send traffic for your domain. These records include information like your website's IP address, mail server locations, and other routing instructions.
The system builds zone files from templates, which you can customize through WHM's Edit Zone Templates interface (WHM > DNS Functions > Edit Zone Templates). This ensures consistency across all zones you create.
How to Create a DNS Zone
Follow these steps to add a new DNS zone:
- In the Domain Selection section, enter the IPv4 address in the IPv4 Address text box.
- Enter the domain name in the Domain text box.
- If you want to link this DNS zone to a specific hosting account, select that account from the Associate with Account dropdown menu. You can use the search box to find accounts by domain or username.
- Click Add Zone to create the DNS zone.
Important considerations:
- You cannot create multiple DNS zones for the same domain.
- If an account already exists in the Account Selection section, do not add that domain again. Instead, use WHM's DNS Zone Manager (WHM > DNS Functions > DNS Zone Manager) to modify the existing zone.
- Exercise caution when adding DNS zones. Incorrect DNS data can prevent visitors from accessing a domain.
Troubleshooting DNS Zone Problems
If you encounter issues when adding DNS zones, run this script from the command line as the root user:
/usr/local/cpanel/scripts/autorepair io_compress_gzip
This script repairs common issues that may prevent DNS zone creation. After running it, try adding the DNS zone again through the WHM interface.
DNS Zone Best Practices
When working with DNS zones, keep these practices in mind:
- Verify IP addresses before adding zones to prevent routing errors.
- Document which accounts are associated with specific zones for easier management.
- Allow 24-48 hours for DNS changes to propagate fully across the internet.
- Use consistent naming conventions for easier zone identification.
- Regularly review and audit your DNS zones to remove unused entries.
Frequently Asked Questions
Can I add a DNS zone for a domain I don't own?
Yes, you can create DNS zones for remote domains on your server. However, the domain owner must update their domain registrar's nameservers to point to your server for the zone to function. This is typically done when hosting DNS for clients or managing multiple servers.
What happens if I add a DNS zone with the wrong IP address?
If you specify an incorrect IP address, visitors attempting to reach the domain will be directed to the wrong server, resulting in website unavailability or displaying the wrong content. You can correct this by editing the zone through WHM's DNS Zone Manager and updating the A record with the correct IP address.
How do I know if a DNS zone already exists for a domain?
Check the Account Selection section before adding a zone. If the domain appears there, a zone already exists. You should use DNS Zone Manager to modify it rather than creating a duplicate zone. The system prevents multiple zones for the same domain.
Why won't my DNS zone create even though I followed all steps?
Common causes include permission issues, corrupted zone templates, or conflicts with existing records. Run the autorepair script mentioned in the troubleshooting section, then verify your zone templates are configured correctly in Edit Zone Templates. If problems persist, check your server's DNS service status.
The OBHost support team is available 24/7 to help with DNS zone configuration and troubleshooting. If you need assistance, visit our contact page or email support@obhost.org.
