Custom domains and subdomains#

By default, applications are available under project-id.ploomberapp.io, where project-id is a randomly generated string.

You can customize the project-id or bring your own domain.

If you already own a domain, you can easily bring it to your Ploomber account by updating your DNS records, or by changing its nameservers.

Custom ploomberapp subdomain#

Note

Custom project names are a paid feature.

If you would like a custom ploomberapp subdomain, like my-custom-app.ploomberapp.io, you can add it during application setup:

Warning

The custom name is only visible during setup. We’re working on a fix.

Adding a custom domain#

Before you begin#

If you haven’t done it yet, start by setting up a Ploomber cloud application.

Once your application is ready, you’ll be able to access it by clicking the VIEW APPLICATION button in the application status page.

Warning

If your application is not ready and publicly available, the button will be disabled and you won’t be able to connect a custom domain to it.

To add the domain#

Go to the application settings page by clicking the settings button.

Next, in Custom domains section, enter your domain name and click Connect.

Choose your connection method#

There are two ways to connect a custom domain. Depending on where you want to store your DNS records, choose the method that suits you:

  • Pointing (default) - You add a CNAME and ALIAS record in your DNS provider

  • Nameservers - We host your DNS records

Important

DNS record changes might take up to 48 hours to take effect. In the meantime, your application will be accessible from the ploomberapp.io URL.

Method 1: Pointing#

To complete the process, you need to add the following DNS records in your domain host account. If these records already exist, you need to replace them with the newly provided DNS records.

Note

Please make sure to add the SSL record so we’ll be able to request the SSL certificate for you.

How to change your DNS records?#

In most cases, changing your DNS records is a simple and easy process.

We will cover the instructions for updating your records on Namecheap. While it may be a slightly different process, the basic steps remain the same for any other domain registrar.

  1. Log in to your Namecheap account

  2. Click Domain List tab and then click Manage button next to your domain

  1. Click Advanced DNS

  1. Add the relevant DNS records, and click Save all changed.

You should be able to see something like this:

You’ve completed the process, and now it’s time to be patient. Allow up to 48 hours for your domain’s updated DNS records to propagate, enabling your application to become accessible worldwide.

Method 2: Nameservers#

First, let’s change the connection method to nameservers, by clicking nameservers.

Now, update the name server settings for your domain in your hosting account with the newly provided name servers.

How to change your domain’s nameservers?#

In most cases, changing your nameserver is a simple and easy process.

We will cover the instructions for changing your nameservers on Namecheap. While it may be a slightly different process, the basic steps remain the same for any other domain registrar.

  1. Log in to your Namecheap account

  2. Click Domain List tab and then click Manage button next to your domain

  1. Scroll down to the Nameservers section and select Custom DNS

  1. Add your nameservers and click Save

HTTPS and SSL#

All Ploomber applications include the HTTPS and SSL protocols, ensuring that communication between your visitors and your site is entirely secure. Once your custom domain has been verified, you’ll be able to see it under Registered domains as ISSUED, and your custom domain will have an SSL certification.