> For the complete documentation index, see [llms.txt](https://docs.one-click.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.one-click.dev/platform/rollouts.md).

# Rollouts

Each time you edit and change something in a deployment a new rollout will get created. This is like a **snapshot** of your [CRD](/operator-manual/crd.md) configuration. This gives you the power to undo any changes you did to your **deployment** configuration like changing the port of an interface or updating your image tag. You can see every rollout in the rollouts table. Through the frontend you won't be able to delete a rollout, you can just hide it. This is due to get some statistics about you rollouts. If you need to delete a rollout completely you need to go to the pocketbase backend and delete the record in the "rollouts" collection.

<figure><img src="https://3601602753-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FclSnVNQ9cQ3UGmpo9Q9i%2Fuploads%2Fh7vkmisComdeXYVDs3WL%2Fimage.png?alt=media&amp;token=451a0111-5209-4162-923c-3a0f056f7255" alt=""><figcaption><p>rollouts overview</p></figcaption></figure>

### Rollback diff

When selecting a previous rollout you can click on "rollback" and then a diff shows up which diffs the CRD files and show you exactly what will change:

<figure><img src="https://3601602753-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FclSnVNQ9cQ3UGmpo9Q9i%2Fuploads%2FAMvmfpAZAv1lLl0yHp8e%2Fimage.png?alt=media&amp;token=449581f4-4156-4bcb-8654-e15994fce7bd" alt=""><figcaption><p>rollout diff</p></figcaption></figure>

### Hidden rollouts

You can hide your rollouts to keep the table organized. You can also delete a rollout from the table, but then it will also affect your stats page on the **overview** page.

When you have hidden rollouts you can show them by toggle the "Show hidden" slider:

<figure><img src="https://3601602753-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FclSnVNQ9cQ3UGmpo9Q9i%2Fuploads%2FgJVTXfu607PMGhmXnIcj%2Fimage.png?alt=media&amp;token=e0d6a055-3524-49b3-b928-d68da4f9daf7" alt=""><figcaption><p>hidden rollouts</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.one-click.dev/platform/rollouts.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
