## Manage apps on SDR

URL: https://docs.atlan.com/product/connections/self-deployed-runtime/how-tos/manage-apps

> Install, update, and remove Atlan connector apps on your Self-Deployed Runtime deployment.

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](https://docs.atlan.com/product/connections/self-deployed-runtime/concepts/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](https://docs.atlan.com/llms/platform/self-deployed-runtime/install-on-docker-compose/llms.txt).
- **Kubernetes**: Deploy a new manifest or Helm release. Follow the [Kubernetes install guide](https://docs.atlan.com/llms/platform/self-deployed-runtime/install-on-kubernetes/llms.txt).

## 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:

 ```bash
 docker compose pull
 ```

2. Restart the container with the new image:

 ```bash
 docker compose up -d
 ```

**Kubernetes:**

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

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

Or update via Helm:

```bash
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:**

```bash
docker compose down
```

**Kubernetes:**

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

Or via Helm:

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

## See also

- [App management concepts](https://docs.atlan.com/llms/platform/self-deployed-runtime/app-management/llms.txt): How SDR manages app lifecycle
- [SDR Orchestrator architecture](https://docs.atlan.com/product/connections/self-deployed-runtime/references/sdr-orchestrator): Architecture and container management details
- [Configure workflow execution](https://docs.atlan.com/llms/platform/self-deployed-runtime/configure-workflow-execution/llms.txt): Set up workflows to run on SDR apps
- [SDR Orchestrator FAQ](https://docs.atlan.com/product/connections/self-deployed-runtime/faq/sdr-orchestrator-faq): Troubleshooting app install and update issues

---