Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion umbraco-cloud/getting-started/environments.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ You can have multiple environments in your Umbraco Cloud project, with two types

The image below shows a Cloud setup including two mainline environments and one flexible environment connected to the left-most mainline environment.

![A Cloud setup including 2 mainline environments and 1 flexible environment connected to the left-most mainline environment](images/cloud-environments.jpg)
![A Cloud setup including 2 mainline environments and 1 flexible environment connected to the left-most mainline environment](images/cloud-environments.png)

## Mainline Environments

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
57 changes: 38 additions & 19 deletions umbraco-cloud/set-up/manage-environments.md
Original file line number Diff line number Diff line change
@@ -1,35 +1,54 @@
# Manage Environments

When working with an Umbraco Cloud project, you can add or remove extra environments depending on the plan you are in:
The number of environments available on your project is dependent on which plan you are on:

* For the Starter plan, you can add a Development environment for an additional price per month.
* For the Standard plan, you get the Development environment for free and can add a Staging environment for an additional price per month.
* For the Professional plan, you get the Development and Staging environment for free. Additionally, you can add and remove environments whenever you like without any additional cost.
<table><thead><tr><th width="117">Plan</th><th width="116" data-type="number">Environments</th><th width="167" data-type="checkbox">Flexible Environments</th><th>Environment Combinations Examples</th></tr></thead><tbody><tr><td>Starter</td><td>2</td><td>false</td><td><em>QA + Production</em></td></tr><tr><td>Standard</td><td>3</td><td>true</td><td><em>Flexible + QA + Production</em><br><em>Development + QA + Production</em></td></tr><tr><td>Professional</td><td>4</td><td>true</td><td><em>Flexible + Development + QA + Production</em></td></tr></tbody></table>

[Learn more about the additional prices on Umbraco Cloud](https://umbraco.com/cloud-pricing/).
[Learn more about Umbraco Cloud Pricing](https://umbraco.com/cloud-pricing/).

{% embed url="https://www.youtube.com/watch?v=avzRNFR-FSY" %}
Adding an additional environment to a Cloud project
{% endembed %}
## Configuring Environments

Clicking Configure environments from the project overview gives you access to environment management options. From here, you can:

- Rename an existing environment.
- Create a new environment.
- Delete an environment you no longer need.

These options help keep your deployment pipeline organized and aligned with your team's workflow.

## Adding or Removing Environments

**Important:** _Before_ adding an environment, you should consider if you have any changes locally that are not on Live yet. If you do, you should make sure to push it as adding another environment will also push it into the deployment chain.
Most Umbraco Cloud plans give you the flexibility to work with multiple environments. You can decide how many to add and how to organize them as flexible or mainline environments. For more information on environment types, see the [Environments](../getting-started/environments.md) article.

The following sections provide guidance on managing your Cloud environments.

### Adding an Environment

Before adding an environment, ensure there are no local changes that haven’t been pushed to Live. Adding an environment will push all changes in the current deployment chain.

To add an environment:

1. Click **Configure environments**.

![Adding an environment](images/environments-overview-new.png)

2. Click **Create environment**.

**Important:** _After_ adding a Development environment, you need to do a fresh clone of the site. The local version you have will be set up to push directly to Live, a fresh clone will push to Development.
![Create environment](images/create-environment.png)

You can add environments from your project overview here:
3. Choose an **Environment name**.
4. Click **Confirm**.

<figure><img src="../.gitbook/assets/image (16).png" alt="Adding environments"><figcaption><p>Adding environments</p></figcaption></figure>
After adding a new left-most mainline environment or a flexible environment, you need to clone this environment instead. The current local clone will be set up to push to Live, while the fresh clone will push to the new environment.

To remove an environment, go to the environment you want to delete click on the three dots, and click delete:
### Removing an Environment

<figure><img src="../.gitbook/assets/image (17).png" alt=""><figcaption></figcaption></figure>
To remove an environment:

{% hint style="info" %}
There is a specific order that the environments are being added. You will need to have a Development environment before you can have a Staging environment.
{% endhint %}
1. Navigate to the environment you want to delete.
2. Click on the three dots.
3. Click **Delete**.

Suppose you have both a Development and a Staging environment and need to remove the Development environment. In that case, you will first need to remove the Staging environment before you can remove the Development environment.
![Deleting an environment](images/delete-environment.png)

Once you have added or removed an environment, it will take a couple of minutes for Cloud to set it all up, and then you will be ready to use it.
It may take a few minutes for Cloud to set up the changes after adding or removing an environment.