We’re excited to announce the general availability (GA) of Bitbucket Packages, a native container registry built into Bitbucket Cloud. With this launch, you can now manage your source code, CI/CD pipelines, and now, container images all within Bitbucket. This means less context switching, simplified permission management, and a more cost-effective way for your team to manage container artifacts.
With the transition to GA, Bitbucket Packages will transition to a paid pricing model, which will take effect in your workspace’s next billing cycle. If you’ve been a beta user and have uploaded test images and multiple tag variations to your workspace, we recommend reviewing and removing any unused images or tags to manage your costs.
Benefits of managing container images within Bitbucket
- Better developer experience: Developers reduce context switching and stay in the flow by creating and managing container images in the same place as their code and CI/CD.
- Lower costs: Managing code, CI/CD, and artifact storage across different platforms can slow down teams and drive up costs. By storing container images in Bitbucket, you can reduce tool costs and management overhead.
- Reduce risk and simplify administration: Setting up access controls in multiple tools is cumbersome and error-prone. With Packages, permissions for images and tags automatically cascade from the Bitbucket repository to which the image is linked. This enables teams to maintain a single consistent set of permissions and access.
What’s included at launch
- Workspace-level container registry with each image mapped to a specific repository. Repository permissions (Admin, Write, Read) automatically apply to all images and tags associated with that repository.
- Push and pull using Docker CLI: Authenticate with Atlassian API tokens and the appropriate package scopes. You can build, push, and pull images directly through the Docker CLI or integrate into your CI/CD pipelines with minimal configuration.
- Image and tag deletion: Manage storage costs by removing unused images, deleting individual tags, or entire images (including all associated tags)
- Transparent billing and usage: Only pay for what you use. See how much storage and network traffic you’re using, right from your workspace settings.
Here’s how it works.
Pricing & availability
Bitbucket Packages will be available to Standard and Premium workspaces on monthly plans, with support for annual plans coming next year.
| Plan | Storage | Network traffic |
| Standard | Included: 1 GB Overages: $0.35/GB/mo | Included: 5 GB Overages: $0.70/GB/mo |
| Premium | Included: 2 GB Overages: $0.35/GB/mo | Included: 7 GB Overages: $0.70/GB/mo |
Getting started
To start using Bitbucket Packages, ensure that your Bitbucket workspace is connected to an Atlassian organization. If you haven’t connected your workspace yet, follow these steps to do so.
- When you link your workspace to an Atlassian organization, your Bitbucket billing will automatically transition (typically within a few days) to the unified billing experience in Atlassian Administration. This allows you to manage billing for Packages and all Bitbucket charges together with your other Atlassian products in a single place.
- Note: For a small number of workspaces, the migration to unified billing may take longer. If your workspace is affected, we’ll reach out directly with status updates and any actions required.
Once you’ve connected your workspace and have been moved to the unified billing experience, you can use Bitbucket Packages. You’ll see a Packages tab in the left navigation of your repository page.
Monitoring usage: If you are the billing administrator, you can track costs and usage for all Bitbucket features, including Packages, via the “Billing management” option in the Settings menu in Atlassian Admin.
Check out our support documentation to learn more about how you can create and publish your packages.
What we’re building next
We are working on several enhancements and are building support for language packages as well. Upcoming features include:
- Immutable tags to prevent container overwrites to improve deployment integrity.
- Enhanced Pipelines integration to enable seamless, end-to-end authentication within Bitbucket Pipelines.
- Language packages support will expand functionality beyond container images to include registries like NPM, Maven, PYPI, and more.
Share your Feedback
Your feedback during the beta phase helped shape this release. We encourage you to continue sharing questions, suggestions, or feature requests in the Bitbucket community. Your input plays a key role in guiding our roadmap as we continue to evolve Bitbucket Packages.