Skip to main content
When you need to quickly revert a change or deploy a specific version without waiting for the normal release flow, Ryvn provides two manual deployment options: Rollback and Force Deploy.

Rollback

Rollback restores your installation to the exact state it was in before the last deployment. This includes the previous version, configuration, environment variables, and secrets that were active at that time.
1

Navigate to Installation

Go to Environments > select your environment > click on the installation
2

Open Activity Tab

Navigate to the Activity tab
3

Initiate Rollback

Find a successful deployment and click Rollback next to it, then confirm
Only successful deployments can be rolled back to. Failed deployments won’t appear as rollback options.
Persistent storage volumes are stateful and cannot be rolled back. Ensure your application can handle any data schema differences.

Force Deploy

Force Deploy lets you deploy any available version to your installation, regardless of release channels or promotion rules.
1

Navigate to Installation

Go to Environments > select your environment > click on the installation
2

Open Force Deploy

Click Force Deploy in the installation header
3

Select Version

Choose the version you want to deploy and optionally provide a reason
4

Confirm

Click Deploy to initiate the deployment
Force deploy uses the latest configuration and current secrets, combined with the build assets from the selected version.

Automatic Change Protection

After performing a rollback or force deploy, Ryvn automatically blocks all automatic changes to your installation. This prevents promotions, config sync, and other automated updates from overwriting your manual deployment. You’ll see a “Changes Blocked” indicator in the installation header:
Changes Blocked popup showing an active exclusion
This protection stays active until you explicitly remove it. To resume automatic updates:
  1. Click on the Changes Blocked status
  2. Find the active exclusion in the popup
  3. Click the trash icon to remove it
  4. Confirm the removal
Once removed, your installation will return to normal operation and receive automatic updates based on your release channel and promotion rules.

Additional Notes

  • After removing protection: If a newer version is available on your release channel or configuration changes were made while protection was active, those will apply immediately. However, if your installation is on a higher version than the release channel, it will not auto-downgrade.
  • Registry deployments: If the image from a previous deployment is no longer available in your registry, the rollback will fail.