Relaunch Existing Pantheon Site

Take a new site live by moving custom domains from one Site Dashboard to another, with minimal HTTPS interruptions.

Sites are considered launched on Pantheon once traffic is routed through custom domain(s). Relaunching a previously launched site is done by rerouting traffic from the existing Site Dashboard to an entirely new Site Dashboard.

 Note

The relaunch process applies exclusively to live sites already hosted on Pantheon. Otherwise, refer to Launch Essentials.

Before You Begin

  • Log in to the new Site Dashboard on Pantheon

  • Open a second tab for the old Site Dashboard on Pantheon

  • In a third tab, log in to the domain's DNS service provider (e.g., Cloudflare, Amazon Route 53, etc.)

  • Examine existing records pointing to Pantheon

     Note

    For subdomains that are using Custom Certificates, use the bare domain's recommended A/AAAA records instead of using CNAME records.

  • Lower the TTL of existing DNS records to minimize impact of upcoming DNS changes

Roles & Permissions

The permission to manage billing and plans is granted only to the role of Site Owner / Organization Administrators. Other roles do not have access as described on this page.

 Note

If you need to assume site and billing ownership, the current Site Owner must transfer it to you directly.

In order to retain Preferred Pricing an updated invitation to pay must be sent from the Supporting Organization for the new site.

Relaunch Procedure

  1. In the new Site Dashboard, upgrade the site from free to a paid plan.

  2. In the old Site Dashboard, remove the custom domain affected by the relaunch:

    Live > Domains / HTTPS > Details > Remove Domain

  3. In the new Site Dashboard, connect the custom domain affected by the relaunch:

    Live > Domains / HTTPS > Connect Domain

     Warning

    Do not update DNS yet. The Site Dashboard instructs you to configure DNS after connecting the domain, however for this relaunch procedure you should not change record values until instructed in step 5 below.

  4. Wait for HTTPS to provision for the newly connected domains:

    Live > Domains / HTTPS > Details

    HTTPS

    Let’s Encrypt certificate deployed to Pantheon’s Global CDN. Certificate renews automatically with no additional cost.

    This process typically takes about an hour.

  5. From the DNS hosting service (not Pantheon), replace values in DNS records pointed to Pantheon with new values provided in the Site Dashboard.

  6. Test and confirm that the new site is accessible via the custom domain over HTTPS (e.g., https://www.example.com/).

  7. Repeat steps 2-6 above for each affected domain. Keep in mind that www.example.com and example.com are different domains.

  8. In the new Site Dashboard, standardize traffic for the primary domain.

  9. In the old Site Dashboard, downgrade the site from a paid plan to Sandbox.

  10. In the old Site Dashboard, remove the existing card as a payment method for the site. If you're a contract customer, you can skip this step.

See Also