CloudPloy

Docs

Add a custom domain

Point your own domain at a CloudPloy app. CloudPloy checks the DNS record and sets up HTTPS for you.

Before you start

Steps

  1. 1

    Add the domain

    Open the app in the console and go to its Domains tab. Under Add a domain, type the domain, for example shop.com or www.shop.com, and choose Add domain. Tick Make primary if this should be the main address of the app.
  2. 2

    Create the DNS record

    The console shows the records to create, with a copy button for each value.
    • For a subdomain such as www.shop.com: one CNAME record that points at the app's cloudploy-apps.link address.
    • For a root domain such as shop.com: a CNAME record on @ if your DNS provider allows it at the root, or else an A record with the server's IP address. An A record must be changed by hand if the server IP changes.

    If Cloudflare is connected to the team, CloudPloy creates the record for you, and you can choose Proxy through Cloudflare. Otherwise, the form links to Connect Cloudflare to create the record for you.

  3. 3

    Verify

    When the record is in place, choose Verify next to the domain. CloudPloy looks up the record in public DNS. The status moves from Pending to Verifying and then to Active. DNS changes can take a while to reach everyone; if the check fails, wait and choose Verify again. You can check one domain 3 times in 5 minutes.
  4. 4

    The certificate is issued for you

    After the domain verifies, CloudPloy gets a free Let's Encrypt certificate and installs it on the server. The SSL column then shows Secured until a date. CloudPloy renews the certificate before it expires. There is nothing to upload.
  5. 5

    Choose the primary domain and the redirect

    Choose Set primary on an active domain to make it the app's main address. CloudPloy gives the app this address in APP_URL and PRIMARY_DOMAIN. To send visitors from the cloudploy-apps.link address to your domain, choose Turn redirect on. Reset to default subdomain makes the cloudploy-apps.link address primary again.

Remove a domain

Choose Remove next to the domain and confirm. The domain stops serving the app, and you can add it again later. The primary domain cannot be removed: set another domain as primary first, or reset to the default subdomain. Then delete the DNS record at your DNS provider.

From an AI agent

Through the CloudPloy MCP server, an agent can call add_domain, then verify_domain after you create the record, and list_domains to see the status. If something does not work, see Fix common problems.