Heroku Connector

Last updated

Table of Contents


The Heroku Connector links a domain in your DNSimple account to an app on Heroku and creates the DNS records the app needs. For an overview of connector documentation, see Connectors at DNSimple. For what a connector is and how it differs from one-click services, see What Are Connectors?.

Note

The tab appears only for users who can manage the account. If you do not see it, you have domain-level access rather than account-level access.

Video walk-through

Creating a connection

Connect a domain to a Heroku app
  1. Choose the relevant domain from your domain list.
  2. Click the tab on the left side.
  3. Under , click in the Heroku Connector section.

    Add Connection card on the Connections tab with an arrow pointing to Add for the Heroku Connector

  4. Authorize your DNSimple account to give the connector permission to access your domains and DNS records.

    Heroku Connector page asking to authorize your DNSimple account, with the Connect my DNSimple account button

  5. Authorize your Heroku account to give the connector permission to access your Heroku apps.

    Heroku Connector page asking to authorize your Heroku account, with the Connect my Heroku account button

  6. Choose your Heroku app and set its mounting point. The mounting point is the address where your app is served. To use the domain apex, for example example.com, leave it blank.

    Heroku Connector form with a Heroku app selected, www as the mounting point, and the Preview changes button

  7. Review the connection configuration. To confirm the information is correct, click .

    Heroku Connector review page listing the Heroku and DNSimple changes, with the Connect my domain button

After configuration

When your domain is connected, you are redirected back to the domain’s tab, where the connection is listed in the card with a green dot next to it. Click the connection to see its messages and metadata, or to disconnect it.

Connections tab listing one connection with a green status dot

From this tab you can view the connection’s metadata or disconnect the Heroku connector from your domain. To connect additional Heroku apps to the same domain, click and repeat the process.

Connection monitoring

DNSimple checks connections on an ongoing basis. If a connection breaks, because the DNS records were removed or the configuration changed on the Heroku side, we send an email to your account notification email with instructions for fixing it and a link to the page where the domain can be reconnected.

Have more questions?

If you have any questions, or need assistance connecting your domains to Heroku, just contact support, and we’ll be happy to help. You can also read more about DNSimple integrations.