Manage Settings

This section provides information on Settings. You can configure Front-End Site settings in the Pantheon dashboard, including:

• General Settings: Site Details, Connected Git repository, and site deletion
• Build and Output settings
• Site Environment Variables
• Build Hooks
• Deployment settings

General Settings

You can change the Site Name, connect or disconnect your Git repository, and delete your Front-End Site in General Settings.

Node.js Version

Pantheon respects the setting in .nvmrc when selecting the Node.js version for runtime. Currently supported versions are:

• Node.js 14
• Node.js 16
• Node.js 18

If you need to change the version of Node.js for your Front-End Site, you can test the new version by pushing the updated .nvmrc to a branch first.

Change Site Name

1. Go to the workspace, click Sites, then select the site you want to change the name of.

2. Click Settings or General.

3. Click the Edit button in the Site Details section.

4. Enter the new name and click Save.

Connect or Disconnect a Git Repository

Note that a repository cannot be connected to more than one Front-End Site. There are known issues around disconnecting and reconnecting a repository.

1. Go to the workspace, click Sites, and then select the site you want to connect or disconnect with your Git repository.

2. Click Settings or General.

3. Click the Connect or Disconnect button in the Connected Git Repository section. Confirm your selection when prompted if you are disconnecting your Git repository.

Delete a Front-End Site

This feature only deletes your Front-End Site. Your CMS backend and connected Git repository are not affected. Visitors will not be able to access the site, and site team members will not be able to work on the site after deletion.

You can contact Support to restore a site if it is accidentally deleted.

1. Go to the workspace, click Sites, and then select the site you want to delete.

2. Click Settings or General.

3. Click the Edit button in the General Settings section and select Delete Site.

   

4. Confirm your selection when prompted by entering site name, then click Delete Site.

   

5. Update your DNS records to stop pointing to the deleted site.

CMS Settings

You can link your CMS to your Front-End Site if you’re already managing content through a Pantheon-hosted site. Changes made in Drupal or WordPress will automatically render on the page. Linking your CMS is optional.

Note that you cannot trigger a Front-End Sites build from your CMS settings. You can trigger a build in your Front-End Sites dashboard or with GitHub merges.

Configure CMS Connections

1. Go to the workspace, click Sites, and then select the site you want to configure CMS Connections for.

2. Click Settings and then click CMS.

3. Click the Get Started or Make Changes button in the CMS Connections section. The Get Started button displays if you have not added a CMS connection yet.

4. Select your CMS backend from the drop-down menu.

5. Select the environment to source content from.

6. Click Save.

Build and Output Settings

You can configure and edit the Build Command and Output Directory in Build and Output Settings. You do not need to modify these settings if you are using a recommended starter kit.

Adjustments to these settings might be required if you are not using a starter kit. Refer to Use a Non-official Frontend Framework for more information.

Configure Build and Output Settings

1. Go to the workspace, click Sites, and then select the site you want to configure Build and Output settings for.

2. Click Settings and then click Builds.

3. Click the Edit button in the Build & Output Settings section.

4. Enter your desired settings and click Save.

Site Environment Variables

Environment variables are key-value pairs configured outside your source code. This means that each value changes depending on the environment.

Environment Variable Naming Restrictions

Variable names can include:

• Uppercase letters
• Numbers
• Underscores

Variable names cannot include:

• Special characters (other than underscores)

• Lowercase letters

• Commas

• Reserved words. Reserved words include:

  • PORT
  • K_SERVICE
  • K_REVISION
  • K_CONFIGURATION
  • CLOUD_RUN_JOB
  • CLOUD_RUN_EXECUTION
  • CLOUD_RUN_TASK_INDEX
  • CLOUD_RUN_TASK_ATTEMPT
  • CLOUD_RUN_TASK_COUNT
  • PANTHEON_*

Add Site Environment Variables

1. Go to the workspace, click Sites, and then select the site you want to configure Site Environment Variables for.

2. Click Settings and then click Builds.

3. Click the Get Started or Make Changes button in the Site Environment Variables section. The Get Started button displays if you have not added any Site Environment Variables yet.

4. Enter your desired key-value pairs and click Save.

Build Hooks

Build Hooks allow you to trigger a build automatically when you update the content in your CMS. You can use Build Hooks for your Front-End site if your CMS is hosted on Pantheon or hosted elsewhere.

Your Pantheon Front-End Site will rebuild and include your new content when a Build Hook is triggered. Each Build Hook you generate has a unique URL.

You can create and manage Build Hooks in the Pantheon Dashboard. You must configure your Drupal backend or WordPress backend to use the Build Hooks you create in the Pantheon dashboard.

Add a Build Hook

1. Go to the workspace, click Sites, and then select the site you want to add a Build Hook to.

2. Click Settings and then click Builds.

3. Scroll down to the Build Hooks section and click Add.

4. Name your Build Hook and then select the branch from the Branch to Build drop-down menu.

5. Click Generate. You will see the Build Hook listed under the Build Hooks section in the dashboard.

6. Click Show URL and then click Copy to copy your unique Build Hooks URL.

7. Optional. Copy the cURL code under Test if you want to test triggering a build with your hook.

Edit a Build Hook

1. Go to the workspace, click Sites, and then select the site with the Build Hook you want to edit.

2. Click Settings and then click Builds.

3. Scroll down to the Build Hooks section, then select Edit from the Edit drop-down menu next to the Build Hook you want to make changes to.

4. Update the Build Hook information and then click Save Changes.

Regenerate a Build Hook

The Build Hook name will remain the same, but your URL will be updated each time you regenerate your Build Hook. Take note of the new URL and update it where needed.

1. Go to the workspace, click Sites, and then select the site you want to regenerate a Build Hook for.

2. Click Settings and then click Builds.

3. Scroll down to the Build Hooks section, then select Regenerate from the Edit drop-down menu next to the Build Hook you want to regenerate.

4. Click Yes to confirm your selection and then click Regenerate Hook.

5. Click Show URL and then click Copy to copy your new unique Build Hooks URL.

Delete a Build Hook

1. Go to the workspace, click Sites, and then select the site with the Build Hook you want to delete.

2. Click Settings and then click Builds.

3. Scroll down to the Build Hooks section, then select Delete from the Edit drop-down menu next to the Build Hook you want to delete.

4. Click Yes to confirm your selection and then click Delete Hook.

Use Build Hooks with a Backend Starter Kit

Drupal Backend Starter Kit and Build Hooks

Refer to Configure Build Hooks for information on how to configure your Build Hook on your Drupal backend.

WordPress Backend Starter Kit and Build Hooks

Refer to Configure Build Hooks for information on how to configure your Build Hook on your WordPress backend.

Deployment Settings

You can provide a deployment path if your static site lives in a subdirectory of your domain. For example, /blog or /products. Note that this is an optional setting.

Set Deployment Path

1. Go to the workspace, click Sites, and then select the site you want to configure the Deployment Settings for.

2. Click Settings and then click Builds.

3. Click the Get Started or Make Changes button in the Deployment Settings section. The Get Started button displays if you have not added any deployment settings yet.

4. Enter your desired Deployment Path and click Save.