Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Unlinking apps #9289

Open
wants to merge 7 commits into
base: development
Choose a base branch
from
Open
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
Original file line number Diff line number Diff line change
@@ -97,33 +97,7 @@ For more details on downloading a backup, see [Download a Backup](/developerport

### Unlinking From Current Environment{#unlink}

Before you can link an app to a new environment, you need to unlink it from its current environment. By default, all apps are created as Free Apps the first time they are deployed. So, in most cases, you must unlink them.

#### Unlinking a Free App{#unlink-free}

To unlink a Free App, do the following:

1. From [Apps](https://sprintr.home.mendix.com), go to the [Environments](/developerportal/deploy/environments/) page of the app you want to unlink.

1. If the page shows the following message, then your app is not currently linked to a node. In that case, you can go straight to the [Connecting Your App to a Licensed Node](#connect-app) section.

{{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/link-node.png" >}}

1. Click **Unlink your app**.

{{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/unlink-free-app.png" >}}

1. Click **Yes, delete all data and unlink this app** to confirm.

{{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/confirm-unlink.png" max-width=70% class="no-border" >}}

1. If prompted, authenticate yourself with [two-factor authentication](/developerportal/deploy/two-factor-authentication/).

Your app has now been unlinked from the Free App environment.

#### Unlinking a Licensed App{#unlink-licensed}

It is not possible to unlink an app from a licensed node. The only way to do this is to connect another app to the licensed node; this automatically unlinks the existing app.
It is not necessary to unlink an app from its current environment before linking it to a new node. Instead, you can [connect another app to the node](#connect-app); this automatically unlinks the existing app.

The [Exchanging Linked Apps Between Nodes](#exchange-apps) section provides an example of how you can use this behavior.

@@ -147,19 +121,21 @@ To connect your app to a licensed node, do the following:

1. From [Apps](https://sprintr.home.mendix.com), go to the [Environments](/developerportal/deploy/environments/) page of the app you want to unlink.

1. Click **Select a node**.
1. Click **Select Licensed Node**.

{{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/link-node.png" >}}

1. Click **Use this Node**.
1. If prompted, authenticate yourself with [two-factor authentication](/developerportal/deploy/two-factor-authentication/).

{{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/choose-node.png" class="no-border" >}}
1. In the list of your cloud nodes, click **Use this Node** by the node that you want to connect to your app.

1. If there is already an app linked to the node, you will be prompted to confirm that you want to replace it. Click **Continue** to confirm.
1. If there is already an app linked to the node, you will be prompted to confirm that you want to replace it. Click **Proceed** to confirm.

{{< figure src="/attachments/deployment/mendix-cloud-deploy/licensing-apps/confirm-replace.png" max-width=70% class="no-border" >}}
{{% alert color="warning" %}}
Unlinking a sandbox app cannot be undone. All data in the app is deleted. Before you proceed, make sure to download a backup of the app that you want to replace.

1. If prompted, authenticate yourself with [two-factor authentication](/developerportal/deploy/two-factor-authentication/).
Linking a new project to a node removes all existing team members and resets node permissions. The technical contact must re-add everyone to the project, and reconfigure any necessary settings.
{{% /alert %}}

Your app is now connected to this node.

Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.