Set up custom domain Reseller portal in CloudCockpit
Resellers can have a personalized CloudCockpit portal with their own custom domain. This feature helps strengthen a reseller brand presence and provides a better, more seamless user experience for your clients.
CloudCockpit now fully automates the SSL certificate process — there’s no need to manually create or renew certificates.
DNS (Domain Name System)
Serves as the internet's phone book, translating human-readable domain names into machine-readable IP addresses.
CNAME Record (Canonical Name)
A type of DNS record that acts as an alias, redirecting one domain name to another, simplifying navigation for users.
TXT Record
A DNS record used to store text-based information about a domain. Often for verification or security.
Creation Process
1. CSP: Generate new DNS Records
To create a new Reseller portal, the reseller must request their CSP (Indirect Provider) to initiate the process.
The CSP can then create the reseller portal by:
1. Log in to the CSP CloudCockpit portal.
2. Navigate to the Resellers page and locate the specific reseller.
3. Click on the reseller’s company name to access their account.
4. Go to Administration > Portal Settings.
5. Insert the Custom Domain and click Register.
6. Copy the unique DNS records (TXT and CNAME) generated and relay them to the Reseller, so they can continue the configuration.
- Do not use the example DNS records shown here. CloudCockpit generates unique records for each reseller.
- The DNS records are valid for 7 days. If they expire contact CloudCockpit Support to request the generation of new DNS records.
The Reseller should then follow these steps to add the CNAME and TXT record and link their custom domain with CloudCockpit:
1. Log in to your domain’s DNS management console.
2. Navigate to the DNS records section and add the new CNAME record, pointing to the provided value.
The exact configuration may vary depending on your DNS provider.
Some may require the full address, in this example resellercustomdomain.cloudcockpit.works instead of just the subdomain resellercustomdomain.
3. Add a new TXT record.
The exact configuration may vary depending on your DNS provider.
Similar to the CNAME, some DNS providers may require the full address, which in this example is _dnsauth.resellercustomdomain.cloudcockpit.works. while in other it's only _dnsauth.resellercustomdomain
3. CSP: Validate the Custom Domain
After the Reseller configures the new DNS records, the CSP should then validate the changes:
1. Log in to the CloudCockpit CSP portal.
2. Navigate to the Resellers page and access the reseller's account.
3. Go to Administration > Portal Settings.
4. Click Validate to conclude the process.
Troubleshooting
If you encounter issues during the Reseller portal creation process:
- Consult your DNS provider documentation to check if the new records match their configuration requirements
- Double-check all DNS entries for typos
- Ensure you've removed any old DNS entries related to the CloudCockpit portal.
- Allow time for DNS propagation (up to 60 minutes or more).
- If problems persist, contact CloudCockpit support for help.
How to change the portal custom domain
To change the Reseller Portal custom domain, it will only be necessary for the CSP to change the custom domain in the Reseller Portal Settings and follow the same steps that were used to create the portal.