Manage apps on SDR

Install, update, or remove connector apps on an existing SDR deployment. Use this guide when you need to add a new connector, apply a version update, or decommission a single-app deployment.

Select your deployment type once—tabs stay in sync across all sections.

Before you begin

Read Install-to-workflow flow to understand how installing an app relates to environment selection and workflow setup before following the steps below.

Install apps

Add a connector app to your SDR deployment when you need to run workflows for a new source system. Each connector type runs as its own app.

SDR Orchestrator

Your SDR Orchestrator deployment must be registered and Active before installing apps.

1. Go to Workflows > Marketplace.
2. Find the connector you want to install and click Install.
3. In the Choose install environments modal, select the SDR agents on which to install the app. The Cloud Tenant is always selected.
4. Click Install.

The Orchestrator pulls the image, provisions OAuth credentials, and starts the container. The app appears in your deployment's app list when the container is running.

To install the app on additional SDR agents after the first install, open the app in the Marketplace sidebar and click Install on more environments.

SDR Single App

Each connector runs as a separate container. To add a connector, deploy a new service for it.

• Docker Compose: Follow the Docker Compose install guide.
• Kubernetes: Deploy a new manifest or Helm release. Follow the Kubernetes install guide.

Update apps

Keep connector apps current to pick up bug fixes, new source system support, and performance improvements. Updates are non-disruptive—active workflows finish before the container is replaced.

SDR Orchestrator

App images—including the SDR Orchestrator image itself—are automatically updated. No additional steps are required from the user.

SDR Single App

Docker Compose:

1. Pull the updated connector image:

   docker compose pull

2. Restart the container with the new image:

   docker compose up -d

Kubernetes:

Update the image tag in your manifest or Helm values and apply the change:

kubectl set image deployment/<app-deployment> <container>=<new-image>:<new-tag> -n <namespace>

Or update via Helm:

helm upgrade <release-name> <chart> --set image.tag=<new-tag> -n <namespace>

Remove apps

Remove a connector app when you no longer run workflows for that source system. Removing an app doesn't affect your SDR deployment or other connector apps.

note

App removal applies only to SDR Single App deployments managed through Docker Compose or Kubernetes. There is no app removal option in the Atlan UI for SDR Orchestrator deployments.

Docker Compose:

docker compose down

Kubernetes:

kubectl delete deployment <app-deployment> -n <namespace>

Or via Helm:

helm uninstall <release-name> -n <namespace>

See also

• App management concepts: How SDR manages app lifecycle
• SDR Orchestrator architecture: Architecture and container management details
• Configure workflow execution: Set up workflows to run on SDR apps
• SDR Orchestrator FAQ: Troubleshooting app install and update issues