Skip to content
English
Sign in
  • There are no suggestions because the search field is empty.

Orchestry Uninstallation Overview

In this article, learn how to uninstall Orchestry from your tenant

    Should you need to uninstall Orchestry from your tenant, please follow the instructions below carefully to remove all components. 

    How to Delete Orchestry from Your Tenant

    The steps below are best performed by a M365 Global admin.

    Step 1 - Remove App Registrations

    This step removes both the enterprise app and app registration from your tenant:

    1. Navigate to Entra > App Registrations > All Applications

    2. Delete the following (note some may not exist in your tenant):
      1. Orchestry Service App
      2. Orchestry Content App
      3. Orchestry API

    kb-uninstall-01

     

    Step 2 - Remove the Orchestry Enterprise App

    1. Navigate to Entra > Enterprise Apps

    2. Open the Orchestry app

    3. DELETE the app from the 'Properties' page

    kb-uninstall-02

     

    Step 3 - Delete the Orchestry Teams app

    1. Navigate to the 'Manage Apps' page in the Teams Admin Center

    2. Open the Orchestry app and click DELETE (Actions > Delete)

    kb-uninstall-03

     

    Step 4 - Delete the Orchestry Web Parts

    1. Navigate to the SharePoint Apps catalogue (https://<yourtenant>.sharepoint.com/sites/AppCatalog)

      1. From SharePoint Admin, navigate to More Features > Apps
    2. DELETE 'Orchestry Webparts' from the list

    kb-uninstall-04

     

    Uninstalling Self-Hosted Orchestry

    For tenants that self-host Orchestry, the listed steps above should still be followed.  One additional consideration for cleanup is the database (i.e: Cosmos DB, Azure Storage, SQL Tenant storage) used to store your Orchestry data.

    Before deleting the database, it is strongly recommended that you:

    • Review it for any additional workloads

    • Consider creating a backup of the database

     

    Deleting the Orchestry SharePoint Site

    The Orchestry site (https://<yourtenant>.sharepoint.com/sites/Orchestry) is used to store the Orchestry Directory and logs from various jobs.   This site will remain accessible even after completing all of the steps above.

    Deleting this site is optional.  Should you choose to delete it, we recommended to consider creating a backup of the data to avoid losing data needed for regulatory requirements in your industry.