# Rollouts

This is an overview of Rollouts using the Standard Rollout. [See Progressive Rollouts](/feature-guides/deployment-and-management/progressive-rollouts.md)

### What are Rollouts?

Rollouts are the way Bindplane manages deploying configuration changes to collectors. Rollouts allow you to stage and compare a new version of a configuration before deploying the changes to collectors. Rollouts also apply changes to collectors incrementally, so that errors due to any configuration changes are isolated to only a few collectors.

### Rolling out a new Version

The currently deployed version of the configuration is displayed by default and is editable. Edits are not instantly applied to collectors. When an edit is made, it is added to a new version that is created as a draft. When the new version is ready to be deployed, press the Start Rollout button to begin deploying the new version to collectors.

<figure><img src="/files/5MTY6j81qIfVs3oeB8zq" alt="Bindplane docs - Rollouts - image 1"><figcaption></figcaption></figure>

After pressing the Start Rollout button, the new configuration begins to roll out incrementally to collectors. First, the configuration is rolled out to 3 collectors. Every five seconds, another batch of collectors will be rolled out. The batch size will multiply by 5 each time, up to a cap of 100. If any collectors experience [errors](#resolving-rollout-errors) when the new configuration is applied, the rollout will be automatically paused so that the configuration may be corrected.

While making edits, you can switch to the live tab or click the compare button to view the currently deployed version. You may also discard your draft entirely.

<figure><img src="/files/GJ6O9FPTCSQXh2qwVPAg" alt="Bindplane docs - Rollouts - image 2"><figcaption></figcaption></figure>

### Permissions (RBAC)

{% hint style="warning" %}
**IMPORTANT**

🚧 RBAC is only available in Bindplane Enterprise or Bindplane for Google. Learn more [here](https://bindplane.com/solutions).
{% endhint %}

The following table shows what actions each role is able to perform.

|        | Can Start Rollouts | Can Edit New Versions | Can View Staged Configurations |
| ------ | ------------------ | --------------------- | ------------------------------ |
| Admin  | ✓                  | ✓                     | ✓                              |
| User   |                    | ✓                     | ✓                              |
| Viewer |                    |                       | ✓                              |

### Resolving Rollout Errors

Sometimes, rolling out a configuration will result in collector errors. When a collector reports an error due to a configuration rollout, the rollout will automatically pause.

<figure><img src="/files/3K6cW7pi3SncSEZvvbho" alt="Bindplane docs - Rollouts - image 3"><figcaption></figcaption></figure>

You can click the red error text to open a new tab that shows the collectors that are errored. Clicking on one of the collectors will show the specific error message. In order to resolve the error, edit the configuration and roll out a new version that corrects the error.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bindplane.com/feature-guides/deployment-and-management/rollouts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
