Delete an Edge site

Updated: March 6, 2026

Delete an old or unused Edge site from Collibra Platform Self-Hosted. If you need to remove the data you previously ingested with this Edge site, you must delete that data manually.

Prerequisites

You have a global role that has the Manage Edge sites global permission.
You have created an Edge site.

How to delete an Edge site installed on bundled k3s

Prerequisites

You created an Edge site.
You have a global role that has the Manage Edge sites global permission.
Ensure that your environment uses the latest user interface.

Steps

Open a site.
1. On the main toolbar, click → Settings.
  The Settings page opens.
2. In the tab pane, click Edge.
  The Sites tab opens and shows a table with an overview of your sites.
3. In the site overview, click the name of a site.
  The site page appears.
In the top right corner, click Site Actions → Delete Site.
The Delete Edge site wizard starts.
Click Delete.
The Edge sites overview appears, without the deleted Edge site.

On the server that hosts the Edge site, go to /usr/local/bin where you can find the uninstall script uninstall-edge.sh, then run one of the following commands:

Note If you intend to reinstall the Edge site after performing an uninstall command, you need to recreate the Linux disk mount for the directory /var/lib/rancher/k3s

Command	Description
Copy `/usr/local/bin/uninstall-edge.sh`	Delete Edge site, but keep its data. The data consists of drivers, required files for capabilities, and data that was saved by Edge capabilities
Copy `/usr/local/bin/uninstall-edge.sh --remove-local-data`	Delete Edge site and its data.
Copy `/usr/local/bin/uninstall-edge.sh --remove-local-data --force`	Delete Edge site without confirmation request, for example if you want to delete the site via a script. You can use this in combination with removing the site data.

Tip

What is your Edge site installation method?

Edge CLI (recommended)Helm ChartZarf package

How to delete an Edge site installed via the Edge CLI method

Prerequisites

You created an Edge site.
You have a global role that has the Manage Edge sites global permission.
Ensure that your environment uses the latest user interface.

Steps

Open a site.
1. On the main toolbar, click → Settings.
  The Settings page opens.
2. In the tab pane, click Edge.
  The Sites tab opens and shows a table with an overview of your sites.
3. In the site overview, click the name of a site.
  The site page appears.
In the top right corner, click Site Actions → Delete Site.
The Delete Edge site wizard starts.
Click Delete.
The Edge sites overview appears, without the deleted Edge site.
On the server from which you manage your cluster, run one of the following commands. If your Edge site has a custom namespace, you must add -n <my-namespace> to the command.
- With terminal logging:
  Copy
```
./edgecli uninstall
```
- With terminal and file logging:
  Copy
```
./edgecli uninstall 2>&1 | tee "edge-installer-$(date +"%Y-%m-%d_%H-%M-%S").log"
```
The uninstall command automatically creates a backup of your site in the current working directory with file name format: edge-backup-SITE_ID-YYYYMMDD-HHMMSS.yaml. You can modify this behavior by adding the one of the following flags to the command:
- --path=/tmp/edge/backup: Specify a different location for the backup file.
- --no-backup:Skip the backup process.

Important If you do not plan on reinstalling your Edge site on the same Kubernetes cluster as it was originally installed on, then you must run the following command after you reinstall on the new cluster to delete unmanaged resources:

Copy

kubectl delete priorityclass job application platform
                    kubectl delete crd clusterworkflowtemplates.argoproj.io \
                    cronworkflows.argoproj.io workflowartifactgctasks.argoproj.io workfloweventbindings.argoproj.io workflows.argoproj.io workflowtaskresults.argoproj.io \
        workflowtasksets.argoproj.io workflowtemplates.argoproj.io

How to delete an Edge site installed via the Helm Chart method

Prerequisites

You created an Edge site.
You have a global role that has the Manage Edge sites global permission.
Ensure that your environment uses the latest user interface.

Steps

Open a site.
1. On the main toolbar, click → Settings.
  The Settings page opens.
2. In the tab pane, click Edge.
  The Sites tab opens and shows a table with an overview of your sites.
3. In the site overview, click the name of a site.
  The site page appears.
In the top right corner, click Site Actions → Delete Site.
The Delete Edge site wizard starts.

If you plan to reinstall your Edge site, create a backup of your site.

Copy

kubectl get -n <my-namespace> secrets -l edge.collibra.com/backup -o yaml > <PATH_OF_BACKUP_FILE>

Click Delete.
The Edge sites overview appears, without the deleted Edge site.
From the extracted TGZ archive, run the following command. If your Edge site had a custom namespace, add --namespace <my-namespace>, replacing <my-namespace> with the name of your Edge site namespace.
Copy
```
sh edge-cd-helm-chart/helm-uninstall.sh
```

How to delete an Air-Gapped Edge site

Prerequisites

In your workstation:
- You must have admin level access to the Kubernetes cluster
- Your existing Edge site is installed using Zarf.
- Zarf is available on your workstation.

Steps

From the Zarf CLI, run the following command:

Copy

ZARF_VAR_KEEP_CPSH_EDGE_SITE=<true or false> \ 
    ZARF_VAR_SKIP_BACKUP_EDGE_SITE=<true or false> \
    zarf package remove <path to package | package name> \
    --confirm

Show me the Zarf flags…

Flag	Description
`ZARF_VAR_KEEP_CPSH_EDGE_SITE=<true or false>`	This flag determines whether or not you want to keep the Edge site in Edge. For example, if you want to reinstall the Edge site at any point, you should set this to `true`. True: Keep the Edge site in Edge. False (default): Delete the Edge site from Edge.
`zarf package remove <path to package \| package name>`	Either the file path to or name of the Zarf Edge package.
`ZARF_VAR_SKIP_BACKUP_EDGE_SITE=<true or false>`	When you run the `zarf package remove` command, a backup of your Edge site is automatically created as a safeguard. We recommend you always create and retain a backup of your Edge site to ensure configurations and credentials are not lost, and that you have a reliable way to restore your Edge site.

Optionally, if you set ZARF_VAR_KEEP_CPSH_EDGE_SITE to true, and you later want to delete the Edge site in Edge, do the following:

Ensure the following 2 directories are present on your workstation:
1. /tmp/collibra/edge/delete-edge-site.sh
2. /tmp/collibra/edge/edge.sh

Run the following command:

Copy

ZARF_VAR_SITE_ID=<SITE_ID> \
    ZARF_VAR_PLATFORM_USER=<DIC_PLATFORM_USER> \
    ZARF_VAR_PLATFORM_PASSWORD=<DIC_PLATFORM_PASSWORD> \
    ZARF_VAR_PLATFORM_ID=<DIC_PLATFORM_URL> \
    /tmp/collibra/edge/delete-edge-site.sh

Show me the Zarf flags…

Flag	Description
`ZARF_VAR_SITE_ID=<SITE_ID>`	The ID of your Air-gapped Edge site.
`ZARF_VAR_PLATFORM_USER=<DIC_PLATFORM_USER>`	The username that you used to install the site.
`ZARF_VAR_PLATFORM_PASSWORD=<DIC_PLATFORM_PASSWORD>`	The password of your Edge site user.
`ZARF_VAR_PLATFORM_ID=<DIC_PLATFORM_URL>`	The URL of your Collibra Platform.

Show me an example

Copy

ZARF_VAR_SITE_ID=EdgeSite1234 \
    ZARF_VAR_PLATFORM_USER=EdgeUser1 \
    ZARF_VAR_PLATFORM_PASSWORD=Pass1234\
    ZARF_VAR_PLATFORM_ID=https://mycollibra.com \
    /tmp/collibra/edge/delete-edge-site.sh

What's next

Create a newEdge site.
Review planned or currently running jobs.
Create new connections or capabilities.