App Patch

The App Patch feature lets you temporarily apply changes to an app on your Bench without creating a new deployment. It is designed for quick fixes, testing, or debugging and can be applied to a single deploy or all active deploys within the Bench Group.

Before You Begin

Keep the following limitations in mind before using App Patch:

• App patches are intended only for temporary fixes and testing.
• Changes made using App Patch do not persist across deployments or server restarts.
• If you need the change permanently, commit it to your application’s repository and create a new deploy.
• After a new deployment, you’ll need to apply the patch again if required.

Apply an App Patch

You can apply a patch in either of the following ways:

1. Open your Bench Group.
2. Either:
   • Go to the Apps tab and select Apply Patch from an app’s menu, or
   • Open the Patches tab and click Apply Patch.
3. Configure the patch details:
   • Select App (if required).
   • Provide a Patch URL or upload a patch file.
   • Select the target deploy or choose Apply patch to all active deploys.
   • Enable Build assets after applying patch if the patch modifies JavaScript or frontend assets.
4. Click Apply Patch.
5. A background job will be created. You can monitor its progress from the Jobs tab.

Revert a Patch

1. Open the Patches tab in your Bench Group.
2. Select the required patch.
3. Click Revert Patch.
4. A new background job will be created to remove the applied patch.

Delete a Patch

A patch can only be deleted when its status is Not Applied.

Troubleshooting Patch Failures

If applying a patch fails, it usually means one of the following:

• The patch has already been applied or reverted.
• The patch does not match the currently deployed version of the app.