Skip to main content
Release your cluster’s reserved domain in Uncloud DNS. The domain becomes available for other clusters to use.

​
Usage

uc dns release

​
Examples

​
Release the domain

uc dns release
Output: 
Released cluster domain: abc123.uncld.dev

​
What Happens

  1. DNS Records Removed - All DNS records for the domain are deleted
  2. Domain Released - The domain becomes available for other users
  3. Services Affected - Services using the domain will no longer be accessible via *.uncld.dev URLs

​
Impact on Services

After releasing the domain:
  • Services with custom hostnames continue to work
  • Services using the cluster domain (service.abc123.uncld.dev) become inaccessible
  • Caddy continues running but won’t serve the old domain

​
When to Release

​
Switching to Custom Domain

If you’re moving to your own domain: 
uc dns release
# Configure your own DNS
# Update services to use custom hostnames

​
Cluster Shutdown

When shutting down a cluster: 
uc dns release
# Then remove services and machines

​
No Longer Needed

If you don’t need public access: 
uc dns release

​
Reserve Again

You can reserve a new domain (likely different) at any time: 
uc dns release
uc dns reserve
# New domain: xyz789.uncld.dev
Note: You’ll likely get a different subdomain.

​
No Domain Reserved

If you try to release when no domain is reserved: 
uc dns release
Output: 
Error: no domain reserved

Build docs developers (and LLMs) love

Get started for freeTalk to us