Forge installation "Error: Insufficient permissions to install app" in Bitbucket Cloud
Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.
Summary
When trying to install a forge app in a Bitbucket Cloud workspace, an error related to permissions occurs.
1
2
3
Error: Insufficient permissions to install app (requestId: xxxxxx)
To install the app on this site, generate an installation link in the developer console and share it with the site admin: https://developer.atlassian.com/console/myapps/xxxxx-xxxx-xxxx-xxxx-xxxx/distribution
Solution
Ensure you are not installing the Forge app in your personal workspace. You can learn more about personal vs. shared workspaces here: Difference between shared and personal workspaces.
It is also documented here.
Forge apps are not supported on personal workspaces. If you install an app to a personal workspace, you will get an insufficient permissions error. See set up a shared team workspace.
ℹ️ Please note that we no longer create personal workspaces for the new users signed up for Bitbucket Cloud after February 2023.
Updated on April 24, 2025
Was this helpful?
Still need help?
The Atlassian Community is here for you.