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 an app.

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

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. Select the SDR deployment on which to install the app.

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.

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.

SDR Orchestrator

warning

Before removing an app, confirm no active workflows are assigned to it in Workflow Center. Removing an app while workflows use it causes those workflows to fail.

1. Go to Settings > Self-Deployed Runtimes.
2. Select your SDR deployment.
3. Find the app and click Remove.

The Orchestrator stops the container and removes it from the deployment. The Orchestrator itself continues running.

SDR Single App

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