Installation Guide - cPanel DNSOnly® Installation
This document describes how to install cPanel DNSOnly® on your server.
- For more information about cPanel DNSOnly, read our cPanel DNSOnly documentation.
- For more information about DNS cluster configuration, read our Guide to DNS Cluster Configurations documentation.
You can download cPanel DNSOnly for free.
To successfully install and use cPanel DNSOnly, your system must meet the following requirements:
Your server must meet our system requirements for its specific operating system.
Your server cannot have previous content on it.
Your server must allow traffic on ports
If you want the server to send email notifications, you must allow traffic on port
Your DNS cluster configuration must meet the requirements for DNS clusters in our Guide to DNS Cluster Configurations documentation.
If your DNS cluster will include domains that use DNSSEC, all of the cluster’s servers must run PowerDNS.
cPanel & WHM version 100 for Ubuntu® 20.04 LTS does not support cPanel DNSOnly. We plan to add support for cPanel DNSOnly in a future release. For more information, read our cPanel & WHM version 100 for Ubuntu 20.04 LTS documentation.
cPanel & WHM version 100 for Ubuntu 20.04 LTS is experimental software and we do not recommend using it in production environments.
Install cPanel DNSOnly
To install cPanel DNSOnly, perform the following steps:
Navigate to the
/homedirectory on your server.
To fetch the latest installation files from cPanel, L.L.C.’s servers, run the following command:
curl -o latest-dnsonly -L https://securedownloads.cpanel.net/latest-dnsonly
To open and execute the installation files, run the following command:
Access cPanel DNSOnly
To access the cPanel DNSOnly interface, perform the following steps:
https://IP:2087in your preferred browser.Note:
In this address,
IPrepresents your server’s IP address. If you have a domain name that resolves to the server, you can use it in place of the IP address.
rootin the Username text box.
Enter your password in the Password text box.
Click Log in.
Remove the Trial License banner
You must have a cPanel DNSOnly license, which the server automatically obtains during installation. If this does not occur, contact cPanel Customer Service.
A Trial License banner appears in your WHM Home interface if your server currently uses a trial license. To remove the Trial License banner, you must remove the trial license from the server.
To do this, perform the following steps:
Contact cPanel Customer Service and request that they deactivate your trial license.
Create a directory to contain the cPanel license files.
cpanel.liscfile and the
/root/.cpanel/datastore/_usr_local_cpanel_cpanel_-Ffile to the directory that you created. To do this, run the following commands:
mv /usr/local/cpanel/cpanel.lisc /root/trashfiles/ mv /root/.cpanel/datastore/_usr_local_cpanel_cpanel_-F /root/trashfiles/Note:
In these commands,
trashfilesrepresents the directory that will contain the license files.
Restart cPanel DNSOnly. To do this, run the following command:
cPanel DNSOnly and DNSSEC
If the DNS cluster includes domains that use DNSSEC, all of the cluster’s servers must run PowerDNS.
cPanel & WHM supports DNS Security Extensions (DNSSEC) in DNS clusters. A DNS resolver will compare the DNS server’s DNSSEC record to the DS record at the registrar. If they match, the record is valid.
You can create, manage, or delete a domain’s DNSSEC keys in cPanel’s Zone Editor interface (cPanel >> Home >> Domains >> Zone Editor).
The system uses the
/usr/local/cpanel/scripts/dnssec-cluster-keysscript to synchronize and revoke currently-active DNSSEC keys in a DNS cluster. If you wish to perform this step manually, run that script as the
For more information about DNSSEC in cPanel & WHM, read our DNSSEC documentation.