> ## Documentation Index
> Fetch the complete documentation index at: https://libops-renovate-github-com-libops-sitectl-0-x.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# converge

> Detect and repair component configuration drift.

Use `converge` when component files have drifted from what sitectl expects — for example after pulling new upstream changes or toggling a component with `sitectl set`. It reads each component's desired state and applies any missing changes.

## Reference

Inspect each component registered by the active context's plugin and apply
any changes needed to bring the project back into alignment.

By default the command is interactive and asks before applying changes. Pass
`--report` to preview what would change without applying it.

This command dispatches to the plugin associated with the active context.
All flags and arguments are forwarded to the plugin's converge handler.

Examples:
sitectl converge
sitectl converge `--report`
sitectl converge `--component` fcrepo

```bash theme={null}
sitectl converge [flags]
```

## Workflow

```bash theme={null}
# Preview what would change without applying it
sitectl converge --report

# Apply all changes interactively
sitectl converge

# Converge a single component
sitectl converge --component fcrepo
```

## Relationship to validate

`sitectl validate` tells you *whether* something has drifted. `sitectl converge` fixes it. Run validate first to understand what needs to change, then converge to apply it.

## Plugin flags

All flags are forwarded to the plugin's converge handler. For the ISLE plugin the following flags are available:

| Flag                | Description                                            |
| ------------------- | ------------------------------------------------------ |
| `--report`          | Preview changes without applying them                  |
| `--component`       | Converge a single component (e.g. `fcrepo`)            |
| `--verbose`         | Show additional detail for each component              |
| `--format`          | Output format for `--report` (table, json, yaml)       |
| `--codebase-rootfs` | Codebase rootfs path relative to the project directory |