Create a Custom Upstream
Connect a remote repository to your Pantheon account and use it as a starting point for new sites.
Pantheon Custom Upstreams are a self-serve feature available to anyone with access to the Workspace with an eligible plan. Workspace members will be able to create new sites from a set common codebase after an Workspace Administrator creates a Custom Upstream. The Custom Upstream must be created within each Workspace if you want to use a specific Custom Upstream for multiple Workspaces.
Be aware that support for Custom Upstreams is limited to verification that the externally hosted upstream repository is connected to the platform correctly. For details, see Get Support.
Create and Host the Repository Remotely
This remote repository serves as the central location for the development and maintenance of your Custom Upstream. Changes are tracked here and distributed downstream to sites within your Organization as one-click updates in the Site Dashboard.
Follow the steps for your preferred Git host below to create your repository.
Pull in Core from Pantheon's Upstream
You must track Pantheon's corresponding upstream repository within the Custom Upstream to avoid incompatibilities.
-
Navigate to the Custom Upstream's root directory using the command line and add the appropriate Pantheon Upstream as a remote:
-
Run the appropriate command below now that the Custom Upstream repository is tracking the corresponding Pantheon core upstream.
Connect Repository to Pantheon
Initial Connection Mode
The default connection mode for new sites created from a Custom Upstream is Git for WordPress and Drupal. The latest version of Drupal defaults to SFTP connection mode.
Configure this setting after connecting your Custom Upstream to Pantheon if new sites need to use an initial connection mode other than the default:
-
Navigate to the Organizations tab within the Pantheon Dashboard and select your organization.
-
Select the Upstreams tab.
-
Click Settings next to the existing upstream requiring an update.
- Enter a username and a password or token if prompted to authenticate your repository (this only applies to privately hosted repositories). Access tokens must be alpha-numeric and cannot contain symbols.
-
Select if Git or SFTP mode should be enabled by default and then click Update. New sites created from this Custom Upstream will use this connection mode by default going forward.
