Zynnode logoZynnode

Custom Domains

Add your own domain to your Zynnode deployment with automatic SSL.

Every Zynnode deployment gets a default URL, but you can connect your own domain (like myapp.com) for a professional look. Zynnode handles SSL certificates automatically — your site will be served over HTTPS with no extra configuration.

Adding a Custom Domain

Add the Domain in Zynnode

  1. Open the Zynnode dashboard and click on your project.
  2. Scroll down to the Domains section on the project detail page.
  3. Type your domain name into the input field (e.g., myapp.com or app.mycompany.com).
  4. Click Add Domain.

Zynnode will show you the DNS records you need to configure. The domain will appear in the list with a Pending status until verification completes.

Configure DNS

After adding your domain in Zynnode, you need to point it to Zynnode by updating your DNS records. This is done in your domain registrar or DNS provider (the service where you purchased or manage your domain — for example, Namecheap, GoDaddy, Cloudflare DNS, Google Domains, etc.).

For apex domains (e.g., myapp.com)

An apex domain is the root domain with no subdomain prefix.

  1. Log in to your DNS provider.
  2. Find the DNS management page for your domain.
  3. Add (or update) an A record:
    • Type: A
    • Name: @ (this means the root domain)
    • Value: The IP address shown in the Zynnode dashboard
    • TTL: Leave as default, or set to Auto

For subdomains (e.g., www.myapp.com, app.mycompany.com)

  1. Log in to your DNS provider.
  2. Find the DNS management page for your domain.
  3. Add a CNAME record:
    • Type: CNAME
    • Name: The subdomain prefix (e.g., www or app)
    • Value: cname.zynnode.app
    • TTL: Leave as default, or set to Auto

If you want both myapp.com and www.myapp.com to work, you'll need to set up both records — an A record for the apex domain and a CNAME record for www.

Verify and Get SSL

After you've updated your DNS records, Zynnode will verify the domain automatically:

  1. Go back to the Domains section on your project page in Zynnode.
  2. Your domain will show a Pending status.
  3. Zynnode checks the DNS records in real-time. Once it detects the correct records, the status changes to Verified with a green checkmark.
  4. After verification, Zynnode automatically provisions an SSL certificate for your domain.

This is usually instant but can take up to a few minutes. DNS propagation itself can take up to 48 hours in rare cases, depending on your DNS provider.

Removing a Custom Domain

  1. On the project detail page, find the domain in the Domains section.
  2. Click the delete icon on the domain card.
  3. Confirm the deletion.

After removing a domain from Zynnode, you should also delete the DNS records from your DNS provider to keep things clean.

Troubleshooting

Domain stuck on "Pending"

  • Check your DNS records. Make sure the record type, name, and value match exactly what Zynnode shows. A common mistake is adding a CNAME record when an A record is needed (for apex domains), or vice versa.
  • Wait for propagation. DNS changes can take anywhere from a few minutes to 48 hours. Most providers update within 30 minutes.
  • Remove conflicting records. If you have an existing A or CNAME record for the same name, delete it before adding the Zynnode record. Conflicting records can prevent verification.
  • Check with your DNS provider. Some providers have a caching layer that delays updates. Look for a "purge cache" or "flush DNS" option in your provider's dashboard.

SSL certificate not provisioning

  • Make sure the domain is Verified (green checkmark) in Zynnode. SSL certificates are only issued after verification.
  • Check for CAA records on your domain. CAA records tell browsers which certificate authorities are allowed to issue certificates. If you have CAA records, make sure they allow the certificate authority Zynnode uses, or remove restrictive CAA records.
  • Wait a few minutes and refresh the page. SSL provisioning usually completes within minutes of verification.

"Domain already in use" error

  • The domain may already be linked to another Zynnode project. Remove it from the other project first.
  • If you previously deleted a project, the domain binding may still exist. Contact support for help.
Was this page helpful?

Environment Variables

Manage secrets, API keys, and configuration for your deployments.

GitHub Integration

Connect GitHub for automatic push-to-deploy workflows.

On this page

Adding a Custom DomainAdd the Domain in ZynnodeConfigure DNSFor apex domains (e.g., myapp.com)For subdomains (e.g., www.myapp.com, app.mycompany.com)Verify and Get SSLRemoving a Custom DomainTroubleshootingDomain stuck on "Pending"SSL certificate not provisioning"Domain already in use" error