--- title: "Upgrading an appliance with sdpctl" slug: "sdpctl-v7-0" description: "Manage your Collectives with sdpctl, a command-line tool for upgrades, backups, and more." tags: ["Upgrading Appliances", "sdpctl", "Appliances"] updated: 2026-06-05T15:23:31Z published: 2026-06-05T19:17:41Z canonical: "support.appgate.com/sdpctl-v7-0" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.appgate.com/llms.txt > Use this file to discover all available pages before exploring further. # Upgrading an appliance with sdpctl **sdpctl** is a command-line tool for managing AppGate Collectives. It supports critical operations such as upgrading and backing up a Collective, as well as several other functions. For the full list of `sdpctl` capabilities, see the see the documentation hosted in [GitHub](https://appgate.github.io/sdpctl/). --- ## Before upgrading Before upgrading, complete the following steps: 1. Note the hostname of your primary Controller. You will connect to its admin interface and may need to reference this Controller if you revert the upgrade. > [!NOTE] > NOTE > > Do not use a load-balanced address or hostname. `sdpctl` must work consistently with the same Controller. 2. Download the [CA certificate file](/v1/docs/internal-certificates-v7-0#downloading-the-current-ca-certificate1) from the Controller **Certificate Authority** page (System > Certificate Authority). This establishes a mutually trusted TLS connection between `sdpctl` and the Controller when the self-signed certificate is still in use. 3. Create an admin user account for `sdpctl` with the appropriate privileges: *Upgrade* on the Controller, or *Backup* on other appliances. 4. Create a policy for the admin user and assign the appropriate Admin role. --- ## Using sdpctl To use `sdpctl`: 1. Download the [latest version](https://appgate.github.io/sdpctl/). This site is not linked to AppGate ZTNA versions. Check the GitHub page before using `sdpctl` to verify whether a newer version is available. 2. Copy the relevant version of `sdpctl` to the system on which it will run. This system must be outside the AppGate ZTNA Collective.