Create a Site Using a Custom Upstream

Custom Upstreams act as a scaffold for new sites, allowing developers and site owners of any skill level to kickoff projects at warp speed.

Instead of repeating the same technical work on each individual site, you can build and maintain a common user interface with unified branding and functionality once, in a single source.

Create the Dev Environment

To create a site using a Custom Upstream:

1. Go to the Professional Workspace that contains the Custom Upstream, and select the Create New Site button:

   

2. Select Custom Upstream.

3. Select the upstream you wish to use.

4. Enter the name and select a region for this site, then click Continue. It can take several minutes to create a new site on Pantheon.

   

   Info:

   Note

   You can navigate away from this page during this process, but later, you'll have to go to the Sites tab to access your site. If possible, stay on this tab to simplify accessing the site when the creation is complete.

5. Click Visit your Pantheon Site Dashboard when the process is complete.

   

You've now created the core portion of your Dev environment; now you have to install the CMS.

1. Click Site Admin.

2. You will be presented with either a Drupal or WordPress setup screen.

3. Enter the information on the screen, and when done, return to the browser tab containing your Site Dashboard.

   Info:

   Note

   Be sure to record your new username and password. You will use this to log in to your CMS in all environments (Dev, Test, Live).

You have successfully finished adding a site in its Dev environment. Click Visit Dev Site to view your site.

Initialize the Test environment

To create your Test environment:

1. Go to the Site Dashboard.

2. Click the Test tab, then click Initialize Test Environment to create your Test environment.

   

   This takes a few moments.

3. Go to the Database / Files tab and select the following:

   • From this Environment: Development
   • Clone Database: Checked
   • Clone Files: Checked

4. Click Clone the Database & the Files from Development into the Test Environment.

   

Create the Test environment

To create your Test environment:

1. Go to the Site Dashboard.

2. Click the Test tab, then click Initialize Test Environment to create your Test environment.

   

   This takes a few moments.

3. Go to the Database / Files tab and select the following:

   • From this Environment: Development
   • Clone Database: Checked
   • Clone Files: Checked

4. Click Clone the Database & the Files from Development into the Test Environment.

   

You have successfully finished adding a site in its Test environment. Click Visit Test Site to view your site.

Create the Live environment

After you purchase a plan, you can deploy your site live. But first, you have to create the Live environment.

To create your Live environment:

1. Go to the Site Dashboard.
2. Click the Live tab.
3. Click Initialize Live Environment to create your Live environment.

1. Go to the the Database / Files tab and select the following:

   • From this Environment: Development
   • Clone Database: Checked
   • Clone Files: Checked

2. Click Clone the Database & the Files from Test into the Live Environment.

   

3. Type "CLONE" and then click Overwrite This Environment when prompted to confirm you want to go live.

   

You have successfully finished adding a site in its Live environment. Click Visit Live Site to view your site.

At this point, you have a live site with a Pantheon URL, like http://my-site.pantheonsite.io/. To change that to a more friendly URL, you'll need to purchase a domain from a DNS provider. Refer to our Domains on Pantheon Guide for more information.