> ## Documentation Index
> Fetch the complete documentation index at: https://developers.entri.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Power Configuration

> showEntri() config keys for Power: power, applicationUrl, secureRootDomain, and dnsRecords with applicationUrl override.

## Configure your Entri account for Power

Before you can use Entri Power, you'll need to provide some basic information on the Entri dashboard and set up your DNS records accordingly.

Log into the [Entri Dashboard](https://dashboard.entri.com/), navigate to the configure section, and enter your company’s desired `cname_target`.

The `cname_target` is the CNAME record that your *end-users* will eventually need to add. For example: `domains.saascompany.com`

After inputting the `cname_target` on the Entri dashboard, you'll need to create a CNAME record that points your `cname_target` to `power.goentri.com` on your domain's DNS.

For example, if you run `saascompany.com`and your `cname_target` is `domains.saascompany.com`, then you would add this record to the DNS for `saascompany.com`:

```JSON JSON theme={null}
{
  type: "CNAME",
  host: "domains",
  value: "power.goentri.com",
  ttl: 300,
}
```

After this DNS record is added, you are ready to offer custom domains to your customers!

## Power a new domain

After you've configured your account, there are two methods of adding a new custom domain: utilizing the ***Entri modal***, or making a direct API request.

*Please note that you'll need an active subscription to Entri Connect to use the Entri modal method. For questions about this, contact your account manager.*

## Powering a domain via the Entri Connect Modal (recommended)

<Note>
  For more information about configuring the ***Entri modal***, see: [Create the
  configuration object](/connect/configuration#entrishowentriconfig).
</Note>

To power a custom domain via the Entri Modal, you will need to make 2 additions to the [standard configuration object](/connect/configuration#entrishowentriconfig) for the Entri Modal.

* Add the property `power` and set it to `true`.
* Add the property `applicationUrl` . The `applicationUrl` is the URL of your application that you would like to render on the customer's domain. This will likely change for every user. For example, the `applicationUrl` for a calendar booking app might look something like this: `https://calenderapp.com/meetings/user-name`

### Powering a root domain

For powering a root domain, you just need to add an A record to the `dnsRecords` array, and the `value` as the `{ENTRI_SERVERS}` placeholder. Make sure to also add your target application destination as the `applicationUrl` key value. **Entri** will take care of the rest.

If you are prompting users to enter a domain in the Entri modal, make sure that you use [dynamic configuration variables. ](/connect/dns-records#dynamic-configuration-variables)

**Sample configuration:**

```JavaScript JavaScript theme={null}
 const config = {
  applicationId: "12345", // From the Entri dashboard
  token: mySavedToken, // The "auth_token" value generated via JWT
  power: true, // This enables the Entri power feature
  dnsRecords: [
    {
      type: "A",
      host: "@", 
      value: "{ENTRI_SERVERS}", //This will be automatically replaced for the Entri servers IPs
      ttl: 300,
      applicationUrl: "https://app.saascompany.com/page/123"
    }
  ],
};
```

<Note>
  Shopify domains only support a single A record at the root domain. Since this setup is not recommended, Entri automatically manages the logic for you.
</Note>

### Powering a subdomain

When powering a subdomain, you just need to add a CNAME record to the `dnsRecords` array. Be sure that the `value` is set to `{CNAME_TARGET}`. If you are prompting users to enter a domain in the Entri modal, make sure that you use [dynamic configuration variables. ](/connect/dns-records#dynamic-configuration-variables)

**Sample configuration:**

```JavaScript JavaScript theme={null}
 const config = {
  applicationId: "12345", // From the Entri dashboard
  token: mySavedToken, // The "auth_token" value generated via JWT
  power: true, // This enables the Entri power feature
  dnsRecords: [
    {
      type: "CNAME",
      value: "{CNAME_TARGET}", // `{CNAME_TARGET}` will automatically use the CNAME target entered in the dashboard
      host: "{SUBDOMAIN}", // This will use the user inputted subdomain. If hostRequired is set to true, then this will default to "www"
      ttl: 300,
      applicationUrl: "https://app.saascompany.com/page/123"
    }
  ],
};
```

<Note>
  **SSL Provisioned by Default** Entri Power will automatically provision an SSL
  certificate so there is no need to also set up Entri Secure when using Power
</Note>
