Manage Bench Dependencies
Every Frappe Cloud bench uses several dependencies such as Python, Node.js, Bench, and wkhtmltopdf. You can view and update these dependency versions from the Dependencies tab of your bench.
Note
A ! icon next to a dependency indicates that it is using a custom version instead of the default version.
View Bench Dependencies
- Open your Bench dashboard.
- Go to the Dependencies tab.
- Review the versions of the installed dependencies.
Change a Dependency Version
- Navigate to the Dependencies tab.
- Click the three-dot (⋮) menu next to the dependency you want to update.
- Select Edit.
- Choose the required version from the available list.
- Click Update to save the change.
Use a Custom Version
If you need to use a version that is not available in the default list:
- Open the Edit Dependency dialog.
- Enable Use Custom Version.
- Enter the required version number.
- Click Update.
Warning
Before using a custom version, verify that the version exists and is officially supported. An invalid or unsupported version may cause future bench deployments to fail. It is recommended to test custom dependency versions in a local environment before applying them on Frappe Cloud.
When Are Dependency Changes Applied?
Updating a dependency only changes the bench configuration. The new version is applied the next time you deploy the bench.
To start using the updated dependency version:
- Update or redeploy your bench.
- Wait for the deployment to complete successfully.
- The newly created bench will use the updated dependency versions.
Good to Know
Changing a dependency does not affect the currently running bench. Existing deployments continue using their current versions until a new bench deployment is completed.
