Skip to main content

Domains & SSL

Connect your custom domains to Kuploy and secure them with automatic SSL certificates.

Domain Limits by Plan​

Each platform plan includes a specific number of domains:

PlanCustom DomainsFree Subdomains
Hobby01
Starter32
Growth105
Business5010
EnterpriseUnlimitedUnlimited

On eligible plans (typically Pro and above), or on instances with an Enterprise license, you can also search for and purchase domains directly from the platform. Purchased domains come pre-configured with DNS records pointing to your server. Access is determined by a license-first, plan-fallback check — if your platform operator has an Enterprise license with domain purchase enabled, all users can purchase domains regardless of their individual plan.

Custom domains, free Kuploy subdomains, and purchased domains count separately toward your limits.

Purchasable Domains by Plan​

PlanPurchasable Domains
Free0
Pro3
Business10
info

The exact plans and limits depend on your platform operator's configuration. Check your billing page for current limits.

Free Kuploy Subdomains​

Every application automatically receives a free Kuploy subdomain:

https://[your-app-name].kuploy.app

Requesting a Subdomain​

  1. Navigate to your application
  2. Go to the Domains tab
  3. Click Add Kuploy Subdomain
  4. Choose your subdomain name (e.g., myapp for myapp.kuploy.app)
  5. Click Create

Features:

  • ✅ Automatic SSL certificate
  • ✅ Instant DNS provisioning (no waiting)
  • ✅ No DNS configuration required
  • ✅ Always available on all plans
tip

Free subdomains are perfect for:

  • Development and staging environments
  • Personal projects
  • Quick demos and prototypes

Purchasing a Domain​

If your plan includes domain purchasing, you can buy and manage domains directly from the platform.

Searching for Domains​

You can search for available domains in two places:

  1. Landing page — The hero section includes a domain search bar (no sign-in required)
  2. My Domains page (/domains) — Full search and management interface

Enter a domain name (e.g., mycompany) and the system checks availability across common TLDs (.com, .net, .org, .io, .dev).

Buying a Domain​

  1. Search for a domain on the landing page or at /domains
  2. Click Buy on an available domain
  3. You'll be taken to the checkout page (/domains/checkout)
  4. Select a registration duration (1, 2, 3, or 5 years)
  5. Confirm the purchase

After purchase:

  • DNS A records are automatically configured to point to your server
  • A www CNAME record is set up for the domain
  • The domain appears in your My Domains list
  • You can immediately assign it to an application

Managing Purchased Domains​

Navigate to /domains to see all your purchased domains. For each domain you can:

  • View status — Active/inactive, auto-renewal, and expiry date
  • Manage DNS — Click DNS to add, edit, or remove DNS records
  • Create a project — Quick link to create a project using the domain
caution

Saving DNS records replaces all existing records at the registrar. Make sure to include all records you want to keep.

Domain Purchase Access​

Domain purchasing is controlled by a license-first, plan-fallback check:

  1. If your platform operator has an Enterprise license with domainPurchase enabled, all users can purchase domains regardless of individual plan
  2. Otherwise, your subscription plan must have domainPurchase: true (typically Pro or Business)

If neither condition is met, the /domains page shows an Upgrade Required prompt.

Domain Purchase Limits​

Domain purchases count against your plan's purchasable domain limit. If you've reached your limit, you'll need to upgrade your plan. Check your billing page for current limits.

Default Domain​

Applications also receive an auto-generated domain as a fallback:

https://[app-name]-[random-id].kuploy.app

This domain is always available and includes automatic SSL.

Adding Custom Domains​

Plan Required

Custom domains require a Starter plan or higher. On the Hobby plan, you'll see an error when attempting to add a custom domain. Upgrade your plan to enable custom domains.

  1. Navigate to your application
  2. Go to the Domains tab
  3. Click Add Domain
  4. Enter your domain (e.g., app.yourdomain.com)
  5. Click Add

DNS Configuration​

After adding a domain, configure your DNS provider:

For subdomains like app.yourdomain.com or www.yourdomain.com:

TypeNameValue
CNAMEappcname.kuploy.app
# Example DNS record
app.yourdomain.com.  CNAME  cname.kuploy.app.
tip

CNAME records are recommended because they automatically handle IP address changes.

Root Domain (Apex)​

For root domains like yourdomain.com:

TypeNameValue
A@76.76.21.21
# Example DNS record
yourdomain.com.  A  76.76.21.21
caution

Some DNS providers support CNAME flattening or ALIAS records for root domains. If available, use:

yourdomain.com.  ALIAS  cname.kuploy.app.

This is more reliable than A records.

www Redirect​

To redirect www.yourdomain.com to yourdomain.com (or vice versa):

  1. Add both domains to your application
  2. Configure DNS for both: 
    yourdomain.com.      A      76.76.21.21
    www.yourdomain.com.  CNAME  cname.kuploy.app.
  3. In domain settings, set your preferred domain as primary
  4. Enable Redirect to Primary for the other domain

Automatic Let's Encrypt SSL​

Kuploy automatically provisions free SSL certificates from Let's Encrypt:

  1. Automatic Provisioning - Certificates are issued within minutes of DNS verification
  2. Auto-Renewal - Certificates are renewed automatically before expiration
  3. No Configuration - Works out of the box with no setup required

SSL Status​

Check your certificate status in the Domains tab:

StatusDescription
🟢 ActiveCertificate is valid and active
🟡 PendingWaiting for DNS verification
🔴 FailedCertificate provisioning failed

Troubleshooting SSL Issues​

If your certificate isn't provisioning:

  1. Verify DNS propagation - Use dnschecker.org to confirm your records are live
  2. Wait for propagation - DNS changes can take up to 48 hours (usually minutes)
  3. Check CAA records - Ensure CAA records allow Let's Encrypt: 
    yourdomain.com.  CAA  0 issue "letsencrypt.org"
  4. Remove conflicting records - Ensure no conflicting A/AAAA/CNAME records exist

Custom SSL Certificates​

For specific requirements (EV certificates, wildcard domains, etc.), upload your own certificate:

  1. Go to Domains → select your domain
  2. Click Custom Certificate
  3. Upload your files:
    • Certificate (.crt or .pem)
    • Private Key (.key)
    • CA Bundle (optional, for intermediate certificates)
  4. Click Save
# Required files
certificate.crt    # Your SSL certificate
private.key        # Private key (keep this secret!)
ca-bundle.crt      # Intermediate certificates (if applicable)
caution

Custom certificates are not auto-renewed. Set a reminder to update them before expiration.

Wildcard Domains​

To use wildcard certificates (e.g., *.yourdomain.com):

  1. Upload a wildcard certificate as a custom certificate
  2. Add specific subdomains as needed
  3. They'll automatically use the wildcard certificate

Force HTTPS​

All traffic is automatically redirected to HTTPS. This cannot be disabled for security reasons.

Kuploy adds the following security headers:

Strict-Transport-Security: max-age=31536000; includeSubDomains

Multiple Domains​

You can add multiple domains to a single application:

app.yourdomain.com
www.yourdomain.com
yourdomain.com
app.anotherdomain.com

All domains serve the same application content.

Domain Verification​

For certain TLD or domain registrars, additional verification may be required:

  1. Add a TXT record to verify ownership: 
    _kuploy-verify.yourdomain.com.  TXT  "verification-code-here"
  2. Wait for verification to complete
  3. The domain becomes active

Best Practices​

  1. Use subdomains - CNAME records are more reliable than A records
  2. Set up www redirect - Ensure users can access both www and non-www
  3. Monitor expiration - For custom certificates, track renewal dates
  4. Use CAA records - Restrict which CAs can issue certificates for your domain
  5. Test thoroughly - Verify SSL works on all target browsers and devices

DNS Provider Guide: Namecheap​

Step-by-step instructions for configuring DNS in Namecheap.

  1. Log into namecheap.com
  2. Go to Domain List in the left sidebar
  3. Click Manage next to your domain
  4. Click the Advanced DNS tab
  5. Scroll to Host Records and click Add New Record
  6. For a subdomain (e.g., app.yourdomain.com):
    • Type: CNAME
    • Host: app (just the subdomain part)
    • Value: cname.kuploy.app
    • TTL: Automatic
  7. Click the green checkmark to save
  8. Wait 5-30 minutes for propagation

For root domain (yourdomain.com):

  • Type: A Record
  • Host: @
  • Value: 76.76.21.21
  • TTL: Automatic

Verifying DNS Propagation​

After adding records, verify they're working:

  1. Use dnschecker.org to check global propagation
  2. Or run from terminal: 
    # Check CNAME
    dig app.yourdomain.com CNAME

    # Check A record
    dig yourdomain.com A
  3. Once propagated, return to kuploy-cloud and verify the domain shows as active