GITBOOK-19: How to move stacks to a new env FAQ

Author: hannah-portainer

.gitbook/assets/Remove env.png

@@ -379,6 +379,7 @@
   * [“Failed logging user activity” error in Portainer](faqs/troubleshooting/failed-logging-user-activity-error-in-portainer.md)
   * [Unable to Authenticate After Portainer Update](faqs/troubleshooting/unable-to-authenticate-after-portainer-update.md)
   * [How do I recover orphaned stacks from a previously deleted environment?](faqs/troubleshooting/how-do-i-recover-orphaned-stacks-from-a-previously-deleted-environment.md)
+  * [How do I change the way I connect to an environment without losing my existing stacks?](faqs/troubleshooting/how-do-i-change-the-way-i-connect-to-an-environment-without-losing-my-existing-stacks.md)
 * [Contributing](faqs/contributing/README.md)
   * [How do I report a bug?](faqs/contributing/how-do-i-report-a-bug.md)
   * [How do I raise a feature request?](faqs/contributing/how-do-i-raise-a-feature-request.md)

SUMMARY.md

@@ -42,3 +42,5 @@ description: >-
 * [Why is my Portainer Edge Agent using a large amount of memory](why-is-my-portainer-edge-agent-using-a-large-amount-of-memory.md)
 * [“Failed logging user activity” Error in Portainer](failed-logging-user-activity-error-in-portainer.md)
 * [Unable to Authenticate After Portainer Update](unable-to-authenticate-after-portainer-update.md)
+* [How do I recover orphaned stacks from a previously deleted environment? ](how-do-i-recover-orphaned-stacks-from-a-previously-deleted-environment.md)
+* [How do I change the way I connect to an environment without losing my existing stacks?](how-do-i-change-the-way-i-connect-to-an-environment-without-losing-my-existing-stacks.md)

faqs/troubleshooting/README.md

@@ -0,0 +1,38 @@
+# How do I change the way I connect to an environment without losing my existing stacks?
+
+{% hint style="info" %}
+Note that these steps apply to Docker environments only.
+{% endhint %}
+
+In the case of changing the way you connect to an environment (for example by moving from connecting to the Docker socket directly to using a socket proxy) you can move your stacks by:
+
+{% stepper %}
+{% step %}
+### Removing the current environment connection in Portainer
+
+Under **Administration**, navigate to **Environment-related**, then to **Environments**. Select the environment you would like to remove and click **Remove.** The stacks in this environment will become orphaned, and therefore available to be re-associated once you re-add the environment in the next step.
+
+<figure><img src="../../.gitbook/assets/Remove env.png" alt=""><figcaption></figcaption></figure>
+{% endstep %}
+
+{% step %}
+### Adding a new environment using the new connection method
+
+[Add the environment again](../../admin/environments/add/) using the new connection method.
+{% endstep %}
+
+{% step %}
+### Re-associating the orphaned stacks with the new environment
+
+Within the environment that you want to associate your orphaned stacks with, click **Stacks** in the left hand menu. At the Stacks list, click on the three dots in the top right corner and select **Show all orphaned stacks**. Your stack list will then update to include any orphaned stacks.
+
+<div align="left"><figure><img src="../../.gitbook/assets/orphaned stacks selection.png" alt=""><figcaption></figcaption></figure></div>
+
+Click into the stack that you want to recover, and select **Associate.**
+
+<div align="center"><figure><img src="../../.gitbook/assets/associate.png" alt=""><figcaption></figcaption></figure></div>
+
+Your stack will now appear in your stack list with total control. Repeat this process for each stack you want to re-associate.&#x20;
+{% endstep %}
+{% endstepper %}
+

faqs/troubleshooting/how-do-i-change-the-way-i-connect-to-an-environment-without-losing-my-existing-stacks.md

@@ -4,7 +4,7 @@ Stacks from an environment that has been deleted will be labelled as orphaned st
 
 
 
-1. Within the environment that you want to associate your orphaned stacks with, open the stacks list and click on the three dots in the top right corner, select **Show all orphaned stacks**. Your stack list will then update to include any orphaned stacks.
+1. Within the environment that you want to associate your orphaned stacks with, click **Stacks** in the left hand menu. At the Stacks list, click on the three dots in the top right corner and select **Show all orphaned stacks**. Your stack list will then update to include any orphaned stacks.
 
 <div align="left"><figure><img src="../../.gitbook/assets/orphaned stacks selection.png" alt=""><figcaption></figcaption></figure></div>