Skip to content
Deployport

Getting Started with Hostnames

When you want to use a custom domain in another Deployport service, the first step is to register it as a hostname in VIA.

Getting Started

Section titled “Getting Started”

To get started, install the Deployport CLI:

Terminal window
sh curl -fsSL https://get.deployport.com | sh

Once installed, register a hostname. For example, if your custom domain is example.com and you want to register the subdomain libs.example.com:

Terminal window
deployport via hostnames add libs.example.com

Your hostname is now registered in the platform. However, to activate it, you need to point your domain’s DNS to the VIA Edge.

Upon registering, you’ll see instructions like this:

activation:
  ownershipValidation:
    dns:
      - name: libs.example.com
        ttl: 3600
        type: CNAME
        value: edge.via-us-east-1.deployport.io
createdAt: 2025-09-28T12:54:00.909383Z
name: libs.example.com

This means you need to configure a new DNS record libs under the domain example.com. The DNS record must be of type CNAME with the value edge.via-us-east-1.deployport.io.

Once you configured this DNS record in your registrar, VIA will provision a TLS certificate and prepare your subdomain to serve content via HTTPS.