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

Still need help?

The Atlassian Community is here for you.