Connecting Custom Domain

More often than not, you would like to connect your custom domain to your Cosmocloud App Service. Custom domain allows you to showcase your applications on your own brand domains.

Cosmocloud Deploy allows to deploy any types of service on the platform, so you can deploy both Frontend (client-facing) and Backend (API systems) on the platform, and then connect your applications to your custom branding such as -

  • example.com - top level domain

  • sub.example.com - sub domain

You might also want to deploy multiple services (like microservices) to different subdomains and endpoint prefixes such as -

  • backend.example.com - single backend

  • apis.example.com/auth - authentication microservice

  • apis.example.com/invoices - invoices microservice

How to connect your Custom Domain?

You can do this from the Cosmocloud Console by -

  1. Go to App Services and open the App Service you want to connect the custom domain to.

  2. Navigate to the Networking tab.

  3. For the environment you want to connect to custome domain (for ex production), click the 3 dot menu button and chose Configure DNS.

    1. Step 1 — Add you custom domain and endpoint, which can be any of the following format -

      1. example.com

      2. example.com/prefix-endpoint

      3. sub.example.com

      4. sub.example.com/prefix-endpoint

    2. Step 2 — Depending on your choice of format above, you would be asked to make changes to your DNS Hosting to add an A record or CNAME record or both. Once you are done adding this to your DNS management service, proceed to Step 3.

    3. Step 3 — Cosmocloud Deploy platform checks if you have correctly added your DNS records in Step 2. Once verified, it automatically connects and redeploys your service on that environment.

Once connected successfully, you can then access your service on your custom domain endpoint.

Connecting SSL to your configured custom domain

You may (almost always) want to add SSL certificate to add HTTPS security to your custom domain and your applications. To connect a SSL certificate to your App Service custom domain, please follow the following steps -

  1. Go to App Services and open the App Service you want to connect the SSL Certificate to.

  2. Navigate to the Networking tab.

  3. For the environment you want to connect your SSL certificate (for ex production), click the 3 dot menu button and chose SSL Certificate.

    1. Note: If you can't find the SSL Certificate option in the 3 dot menu, you might not have connected a custom domain to your App Service environment.

  4. Fill the Add SSL certificate form -

    1. Certificate chain: This it the public key of your SSL certificate.

    2. Certificate private key: This is the private key of your SSL certificate.

  5. Click Add SSL Certificate button.

Generate SSL Certificate for your app

While you can use any service / provider to generate an SSL certificate for your app, or you might already have one, we cannot use any service which does not expose the Public/Private key parts of the certificate (such as AWS ACM).

We currently prefer you use Certbot to generate your SSL certificate.

Certbot is a free, open source software tool for automatically using Let’s Encrypt certificates on manually-administrated websites to enable HTTPS.

Steps to manually issue an SSL certificate with DNS Validation -

You can also use other methods to create your SSL certificate the way you want, using Certbot.

PreviousPromote / Redeploy Version

Last updated