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

# Remediations

> One-click fixes suggested by the AI investigator — approval-gated and audited before anything touches your cluster.

## Overview

The **Remediations** page shows fixes that Niro's AI investigator has suggested based on active incidents in your fleet. Every remediation requires your explicit approval before it runs — Niro never takes action on a cluster without a human in the loop.

<Note>
  Remediations are available on <Badge>Pro</Badge> and above. The AI investigator must be enabled to generate remediation suggestions.
</Note>

## Where remediations come from

When you run an [AI investigation](/features/ai-investigation) on an incident, the investigator may suggest concrete fixes — for example, restarting a crash-looping pod, scaling up a deployment, or rolling back to a previous image. These suggestions appear on the Remediations page as pending items.

Suggested remediations are specific to the incident context. Each one shows:

* The incident that triggered the suggestion
* The proposed action and its target (which pod, deployment, or workload)
* The reasoning behind the suggestion

## Approving a remediation

<Steps>
  <Step title="Open the Remediations page">
    Click **Remediations** in the sidebar.
  </Step>

  <Step title="Review the suggestion">
    Read the proposed action and the AI's reasoning. Check the target cluster and workload before approving.
  </Step>

  <Step title="Approve">
    Click **Approve**. Niro sends the action to the cluster's agent immediately.
  </Step>

  <Step title="Verify the result">
    The remediation shows its outcome — success or failure — within a few seconds. The linked incident updates with the action taken.
  </Step>
</Steps>

## Rejecting a remediation

If you don't want to apply a suggestion, click **Reject**. The remediation is dismissed and does not run. Niro logs the rejection in the [audit log](/guides/audit-log).

## Audit trail

Every remediation action — approved or rejected — is logged in the audit log with:

* Who approved or rejected it
* When the action ran
* What the outcome was

This makes the remediation history fully reviewable, even for teams with multiple operators.

## Available actions

The types of remediations Niro can suggest depend on what the AI investigator identifies. Common examples include:

| Action               | What it does                                         |
| -------------------- | ---------------------------------------------------- |
| **Restart pod**      | Deletes the target pod so Kubernetes reschedules it  |
| **Scale deployment** | Changes the replica count of a Deployment            |
| **Roll back image**  | Reverts a Deployment's image to the previous version |
| **Restart job**      | Triggers a new run of a failed Kubernetes Job        |

The agent capability to apply changes must be enabled on the cluster for any remediation to run.

## Guardrails

Niro applies several guardrails before running any remediation:

* **Approval required** — no action runs without explicit approval from a logged-in user
* **Cluster must be online** — the agent must be active and heartbeating
* **Apply capability required** — the cluster must have the apply capability enabled
* **Scope-limited** — actions target only the specific resource identified in the investigation

<Warning>
  Remediations act on live clusters. Review the target workload and cluster before approving, especially on production clusters.
</Warning>

## Related

<CardGroup cols={2}>
  <Card title="AI Investigation" icon="brain" href="/features/ai-investigation">
    How investigations generate remediation suggestions.
  </Card>

  <Card title="Alerts & Incidents" icon="bell" href="/features/alerts">
    Incidents that trigger investigation and remediation workflows.
  </Card>

  <Card title="Agent Capabilities" icon="gear" href="/reference/agent-capabilities">
    The apply capability required to run remediations.
  </Card>

  <Card title="Plans" icon="credit-card" href="/reference/plans">
    Remediations are available on Pro and Enterprise.
  </Card>
</CardGroup>