Developer Center


PowerTools configures DNS for one or more of your top level domains.

Root Domains

You must provide at least one root domain for PowerTools to manage. When you signup, you will be prompted for a root domain.

In order for PowerTools to work properly, you must have access to your root domain and able to delegate the nameservers for it (or a subdomain) to your PowerTools managed dns zones on either AWS or GCP.

For instance, if you provide as a root domain during pt signup or pt new --kind=workspace, then your workspace schema will contain:


When you run pt workspace sync, PowerTools will automatically create a dns zone for and will display directions to update your nameservers:

✔ please update to use the following nameservers:

Once you have gone to your domain registrar and updated your NS records to point at PowerTools, your workspace will be ready to handle DNS for your root domain(s).

You only need to update nameservers once, when you first add a domain to your PowerTools workspace.

When you are first migrating services to PowerTools it is recommended to start with a namespace such as

You can add and remove root domains at any time.

Workspace dns records

When you migrate your primary domain(s) to PowerTools, you may need to add some custom dns records. Applications such as Gsuite, Sendgrid and many others rely on Dns records for verification.

Once you have migrated a domain to PowerTools you can add top level dns records in your .powertools/workspace.yml schema:

# workspace.yml
  - name:
    type: cname
    ttl: 3600
      - s2.domainkey.ul67.
We do not recommend manually creating Dns records in your PowerTools managed AWS / GCP dns zones.

To avoid downtime, it is recommended to add all records to PowerTools before pointing your nameservers to your PowerTools zones.

Service dns

When you deploy a service to PowerTools, one or more Dns entries are created for your service.

For instance, given a service with a www. route:

# service.yml

  - type: static-public


PowerTools will automatically create a Dns record for in your release environment. If you have a testing environment named stage it will create a record such as

You can use pt open to find the url for a service in any environment.

Occasionally, if you look at your managed zones in AWS or GCP for a PowerTools workspace, you may find additional Dns records. These are often used for verification with SSL providers.

Some components use Dns records for SSL verification.