How to Roll Back Applications in PipeOps

---

Even with the best CI/CD pipeline, not every deployment goes smoothly. Maybe a dependency breaks, an environment variable is misconfigured, or the new version simply doesn’t behave as expected.

PipeOps helps you recover quickly. With built-in rollback support, you can revert your application to a previously working version in just a few steps.

When Should You Roll Back?

You might consider rolling back a deployment when:

• A new version of your app crashes

• Users report issues after a new release

• You need to temporarily revert while investigating a bug

How Rollbacks Work in PipeOps

PipeOps keeps track of all previous deployments and commit versions. When you initiate a rollback, it redeploys a prior version of your app based on either Git history or deployment history.

Initiating a Rollback

To roll back your application:

1. Navigate to your project: Log in to your PipeOps dashboard and open the project.

2. Open the Actions menu: Click the “Actions” button in the top-right corner to reveal the dropdown menu.

3. Select "Rollback": This opens the rollback modal with two available options:

Rollback by Git

Use this if you want to revert based on a specific Git commit.

• Select the By Git tab.

• Browse your commit history.

• Choose the commit to roll back to.

• Click Rollback to initiate deployment.

Rollback by Action

Use this if you want to revert to a specific build from your deployment history.

• Select the By Action tab.

• View previous builds.

• Choose the build version to roll back to.

• Click Rollback to begin.

Best Practices

• Roll back quickly when uptime or user experience is at risk.

• Use meaningful Git commit messages—they help when choosing rollback points.

Once a rollback is triggered, PipeOps immediately starts a redeployment. You’ll see a "rollback triggered successfully" notification at the bottom right of your screen.

After the process completes, the rollback appears in your deployment history. You can also confirm that the version you rolled back to is now live by clicking the View Project button at the top right of your dashboard.

Rollbacks are a core part of building resilient applications. When things go wrong, PipeOps makes recovery fast, easy, and reliable.