---
schema_version: "1"
id: 7d770a3626e43bc173797bc8cd23502e631d85c3f56ada401adfce7518d57f3b
title: Replace a Development Environment
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/devops_center_replace_dev_environment.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.devops_center_replace_dev_environment.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 8929027cc884b2fc2efcab4ac4ee50aa4dc1c47aeb0e6209d260312142571186
description: After a Developer or Developer Pro sandbox refreshes or a scratch org expires, the connection to Lifecycle Center becomes unusable. Replace the development environment in Lifecycle Center to restore the connection. Lifecycle Center deploys the pipeline stage branch to the new sandbox so that you can continue working with the correct metadata and configuration data.
products:
  - Salesforce Platform
release: "264"
---
# Replace a Development Environment

After a Developer or Developer Pro sandbox refreshes or a scratch org expires, the connection to Lifecycle Center becomes unusable. Replace the development environment in Lifecycle Center to restore the connection. Lifecycle Center deploys the pipeline stage branch to the new sandbox so that you can continue working with the correct metadata and configuration data.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience in <strong>Professional</strong> (API access required), <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions</td></tr></tbody><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Not available in: <strong>Government Cloud Plus</strong>. Contact your Salesforce account executive for more details.</td></tr></tbody><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Not available in: <strong>EU Operating</strong> Zone. EU Operating zone is a special paid offering that provides an enhanced level of data residency commitment. Lifecycle Center <em>is</em> supported in orgs in the EU that aren’t part of EU OZ, per standard product terms and conditions.</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d28785e104">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d28785e104 ">To replace an environment:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d28785e104 ">Lifecycle Center Admin</td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d28785e104 ">To access the named credentials required to authenticate to the environment:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d28785e104 ">Access Lifecycle Center Named Credentials</td>

          </tr>
        </tbody>
      </table>

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-devops_center-264-0-0-production-enus/166010c3-4c34-4087-92ad-aea917baf524/images/icon_important.png)

Important We recommend refreshing sandboxes from the production (release) environment, or cloning them from a pipeline stage or an existing development environment.

Before you replace a development environment, review the considerations, and make sure that the new development environment has source tracking enabled. See [Replace and Connect a New Environment](https://help.salesforce.com/s/articleView?id=platform.devops_center_replace_connect_environment.htm&release=264.0.0&type=5 "Maintain pipeline integrity by replacing an expired, deleted, or refreshed development or pipeline environment in Lifecycle Center. When you connect a new environment, Lifecycle Center restores the complete branch state, including metadata and configuration data, to keep it in sync with the pipeline.").

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-devops_center-264-0-0-production-enus/166010c3-4c34-4087-92ad-aea917baf524/images/icon_note.png)

Note In DevOps Center (Managed Package), this operation is called swap environment.

1. Go to the Pipelines tab, and select your pipeline.
2. Click the down arrow icon under **Approved Work Items**, and then select **Replace Environment**.
3. Review the considerations, select the confirmation checkbox, and then click **Continue**.
4. Select an environment, and then click **Log In**.
5. Complete the login process.
    
    Lifecycle Center replaces the environment. Check whether the development environment is out of sync. If it is, sync it before you continue work. See [Keep Your Development Environment in Sync](https://help.salesforce.com/s/articleView?id=platform.devops_center_sync_dev_environment.htm&release=264.0.0&type=5 "Use back sync to update your development environment with the latest changes from the first pipeline stage. Keeping your environment current helps maintain compatibility with your team’s changes and reduce merge conflicts.").

#### See Also

- [Replace and Connect a New Environment](https://help.salesforce.com/s/articleView?id=platform.devops_center_replace_connect_environment.htm&release=264.0.0&type=5 "Maintain pipeline integrity by replacing an expired, deleted, or refreshed development or pipeline environment in Lifecycle Center. When you connect a new environment, Lifecycle Center restores the complete branch state, including metadata and configuration data, to keep it in sync with the pipeline.")
- [Replace a Pipeline Environment](https://help.salesforce.com/s/articleView?id=platform.devops_center_replace_pipeline_environment.htm&release=264.0.0&type=5 "Activating a refreshed sandbox permanently deletes the original environment and its data, which breaks the connection to Lifecycle Center. Replace the pipeline environment in Lifecycle Center before your team members promote changes to the associated pipeline stage. Lifecycle Center deploys changes from the pipeline branch to the new environment.")