---
title: "Enable Adaptive Pod placement"
slug: "enable-adaptive-pod-placement"
updated: 2026-08-18T10:00:16Z
published: 2026-08-18T10:00:16Z
canonical: "docs.zesty.co/enable-adaptive-pod-placement"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zesty.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Enable Adaptive Pod placement

You enable Adaptive Pod placement (APP) at the cluster level through the Helm **values.yaml** configuration.

You can enable APP during the initial Kompass installation or after Kompass has been installed.

When APP is enabled, the following actions take place:

1. The Insights agent begins to collect the eviction status of workloads.

This status can be displayed in the **Clusters > Workloads** tab after an hour.
2. The APP banner is removed from the **Clusters > Workloads** tab.

For more information, see [Manage workloads](/v1/docs/manage-workloads).

### Enable Adaptive Pod placement during Kompass installation

You can enable APP at the same time that you install the Insights agent.

**Prerequisites**

- You are also enabling Pod rightsizing on the cluster.

**To enable Adaptive Pod placement in a new installation of Kompass**:

1. Edit **values.yaml** and add these lines:

```yaml
Kompass-pod-placement
  enabled: true
  mode: "classification"
```
  - When installing with the UI, you download and edit **values.yaml** during the Insights agent installation.
  - When installing with Terraform, install the Insights agent first. Terraform will output **values.yaml**. You can then edit that file.
2. Continue to install Kompass as directed.

### Enable Adaptive Pod placement in an existing Kompass installation

You can enable APP into an existing Kompass installation.

**Prerequisites**

- Pod rightsizing is enabled on the cluster.
- You have the cluster-specific Kompass onboarding **values.yaml** file.
  - If your account was onboarded using **Terraform**, you can find this in your environment.
  - You can also download **values.yaml** through the Zesty platform UI by beginning the [Install Kompass Insights agent](/v1/docs/install-the-insights-agent-azure-aks) procedure through downloading the YAML. Do not proceed to install the Helm chart.

**To enable Adaptive Pod placement in an existing Kompass installation**:

1. Edit **values.yaml** file by adding these parameters at the top level (the same as other Kompass components):

```yaml
kompass-pod-placement:
  enabled: true
```
2. Run Helm upgrade. This creates the required components (ConfigMap, controller, webhook) and applies the configuration.

### Optional configurations

You can configure the following parameters during the installation:

| Parameter | Description | Default | Environment variable |
| --- | --- | --- | --- |
| `--classification-interval` | How often pods in the cluster are reclassified | Duration (default: 1h0m0s) | `CLASSIFICATION_INTERVAL` |
| `--eviction-interval` | Minimum time between Pod eviction cycle | Duration (default 4h0m0s) | `EVICTION_INTERVAL` |
| `--eviction-max-pods-multiplier` | Fraction of workload replicas that can be simultaneously deleted (e.g. 0.2 = 20%) | Float (default 0.2) | `EVICTION_MAX_PODS_MULTIPLIER` |