Custom Upstreams on Pantheon
Edit an Existing Custom Upstream
Learn how to edit your Custom Upstream settings.
This section provides information on editing an existing Custom Upstream.
Update Name or Description
Follow the steps below if you want to change the name or description of your Custom Upstream.
-
Navigate to your workspace dashboard, then select the Upstreams tab.
-
Next to the existing upstream requiring an update, click the dropdown icon and then click Edit settings.
-
Make desired changes, then click Save.
Update Repository Credentials
You can update the access token used to authenticate to your private repository — a GitHub personal access token or a Bitbucket repository access token — directly from the Dashboard:
-
Navigate to your workspace dashboard, then select the Upstreams tab.
-
Next to the existing upstream requiring an update, click the dropdown icon and then click Edit settings.
-
In the Repository credentials section, click Update credentials (or Add credentials if none are set yet), enter the new credentials, then click Save.
Update Repository URL
You cannot modify the repository URL on an existing Custom Upstream. We recommend creating a new Custom Upstream if there is a new URL you need to use.
To switch existing sites to the new Custom Upstream, it must share Git history with the one they currently use (for example, forked from or based on the original repository).
A site cannot switch to an upstream with an unrelated commit history.
Review Switch Your Custom Upstream before switching.
You will need to switch each site to the new upstream individually with Terminus:
You must merge changes as a one-click update after a site's upstream is changed. Review Example Usage for more details.
You can safely delete the old Custom Upstream after all sites have been updated to track the new Custom Upstream. Review Delete a Custom Upstream for more information.