Delete a gateway

Deleting a VPN gateway permanently removes the associated virtual infrastructure and terminates all encrypted tunnels. This action also releases the public IPv4 addresses assigned to the gateway.

If you proceed with the action described here, your data will be lost irrevocably.

Please check carefully,

• which of your data are affected,
• if those data are still in use or otherwise required to be present in your organization,
• and if a backup on your side is necessary, if it exists and if it is up to date and in usable condition.

Do not proceed unless you have checked the above points thoroughly and are authorized within your organization to delete the data.

Prerequisites

Before you delete a gateway, ensure that:

• You have the gatewayId of the resource you want to remove.
• No critical production traffic is currently using the gateway or its active connections.
• You have notified any affected teams, as this action results in an immediate network disconnection.

API

Identify the gateway

You need the unique identifier of the gateway to proceed with the deletion.

1. List the VPN gateways in your project:

GET /v1beta1/projects/{projectId}/regions/{region}/gateways

2. Locate the gateway you want to delete and copy its id.

Delete the gateway

To remove the resource, send a DELETE request to the gateway endpoint.

1. Open your API client or terminal.

2. Send the request to the following endpoint:

DELETE /v1alpha1/projects/{projectId}/regions/{region}/gateways/{gatewayId}

Portal

Visit the STACKIT Portal, select your desired project and follow these steps:

1. In the sidebar under Networking, click on VPN.
2. Locate the VPN Gateway you want to delete and open its details or use the actions menu.
3. Click Delete and confirm the deltion in the dialog

Once confirmed, the VPN and its underlying ressources will be removed shortly. You can see the lifecycle state of the VPN Gateway in the VPN overview.

CLI

CLI functions not yet available.

Terraform

Terraform functions not yet available.

Verify deletion

Once you initiate the deletion, the gateway status transitions to DELETING.

• Process initiated: Gateway deletion initiated.
• Final state: The resource is removed from your project and will no longer appear in the gateway list.

If the gateway remains in the DELETING state for an extended period, please contact the STACKIT support team.