Repository size limits

By on May 30, 2014

In order to improve and maintain the overall performance for everyone who uses Bitbucket, we are rolling out size limits on newly-created repositories. Starting today, repository size limits will be:

If you already have a repository that is larger than the 2GB limit, your repository has been grandfathered so you won’t have any issues. Should you find your new repository approaching the 1GB soft limit, check out our documentation on how to reduce repository sizes or our blog “How to handle big repositories”.

Of course, Bitbucket still offers unlimited private repositories free for five users!

  • Raleigh

    How do we how large our repositories are and if we have any that currently close to the limit?

    • Brodie Rao

      If you go to the repository settings/admin page, you’ll see your repo’s size listed under the name.

      There isn’t a place on the site to view the size of all of your repositories in one central location. You could use the REST API to see that, however:

      • Matt Rock

        I can’t seem to find any setting/admin page… has this changed since this post, or it is cleverly tucked away someplace…

        • mike rigley

          It is still there;
          1) click through to a single repository
          2) click the settings icon (on the left)

          or go to this url:

          • Matt Rock

            Thanks @mikerigley:disqus !

  • Sebastiano Pilla

    This is not necessarily good news for us (though I understand your motivation in imposing those restrictions). Do you plan you offer bigger repository sizes for paying customers?

    • Justen Stepka

      Support for larger repos is something we may offer in the future but have no plans at this time.

      The primary motivation to implement repo limits to protect the service from run away repos that are causing havoc on performance. Right now only about .01% of repos are over the 2GB limit and are mostly from individual users for non-code projects such as storing MP3s or movies.

      • Lachlan Gemmell

        So are you grandfathering those pre-existing huge repositories that are abusing the service as well?

  • Michael Stevenson

    That’s unfortunate. Given that most of my project repos are in excess of 1 GB, it sounds like I’ll need to discontinue using BitBucket for all future work unless a paid tier with a significantly higher repo size limit is offered soon.

    • Hannan Ali

      are you doing fucking photography or sound editing in git?

      • Michael Stevenson

        Game and media-rich app development, where code and assets aren’t easily separable.

        Since I wrote that comment two years ago, we moved to a self-hosted Atlassian Stash server and it was smooth sailing. Atlassian is now working on a LFS implementation for Stash (now branded BitBucket Server) which we’ll migrate to.

        • Hannan Ali

          Stash seems a good solution for your needs. Good Luck migrating. but you know what I love Github more cos they sent me free stickers 😉

        • Hannan Ali

          There are more reasons too though..

    • Hannan Ali

      you can use git lfs by github though…

      • Michael Stevenson

        There were no hosted LFS solutions available when this blog was posted, and GitHub’s LFS implementation was more than a year away from being announced.

        • Hannan Ali

          Oh yup I noticed you said it was a long time ago.. 2 years in tech is a very long time.. but github lfs is really cool though.. just one command

          git lfs track *.png

          to track all the png files

  • kevintho

    Are “Issues”, “Wiki”, and “Downloads” included (counted) in the size limits? Or do these new size limits refer only to the repository itself?

  • Jens Laufer

    So can have 20 repos with 1GB? Or is there also a limit on the account level?

    • killerloader

      quotes from “razaq omar” (STAFF)

      Please refer to our official guidelines and size limits on Bitbucket repositories in this article.. Bitbucket does not have any limits on the amount of size a user consumes in their account, but a single repository should not go over 2GB, as GIT will normally start suffering performance problems and that’s by Git design.”

      So yeah, there is no size limit on the account level, unless they’ve changed it since this post (2014 some time)

  • msx

    I LOVE BITBUCKET! – Can’t say the same about Confluence ¬¬
    Thanks guys for your great work.

  • Tasadduq Ali

    Hi Bitbucket team
    Great work guys (y)

    M Tasadduq Ali

  • Andrey Fedyashov

    Hi! I’ve gone through steps to reduce repository size via BFG. I see mirrored clone of repository is significantly smaller now, so I performed pruning, GC and pushing to bitbucket. I don’t see the size in settings to reflect immediately. How long it will take for bitbucket to reflect those changes in size?

  • mario tabali

    why don’t you guys offer dropbox google drive pack i get crazy having different subscription for git pictures so on

  • Sean

    If the 2 GB limit has already been exceeded, and Bitbucket restricted my ability to push, how do I delete files in my repository? I’ve moved/deleted files but Bitbucket won’t let me push the commits so I’m stuck with my old repository and unable to make changes to be backed up without copying my files, creating two new repositories, and deleting the first repository. This way I lose all of my old commits and old code which is information I really needed. I can’t seem to find any help on this issue. The only help I get is how to delete files when I’m close to the 2 GB limit (which is obvious), but now that I reached the limit, I’m helpless. Any help is appreciated.

    • Александр

      Actually, even when you delete/remove files in repository (and then doing commit), those files are still left in the repository history, they are just marked as removed, but continue to occupy space on disk (inside .hg/.git folder). Reducing repository size without deleting it is a bit complicated thing. See this before-mentioned doc. But there also can be some “caching issues” (see this issue).

  • Benjamin Leppard

    Per supposedly Atlassian is working with GitHub on Git LFS support. But there is no timeline mentioned, so given Atlassian’s normal development pace, we could be waiting awhile.

  • Luis Fernando

    What would be the optimal way to manage assets in a game project ? like images, 3D models, etc … these can easily make the project exceed 2GB.

  • Billy Schmidt

    Wow Bitbucket is so cool!

  • Michael Ivanov

    Dear Bitbucket.I am your user already for several years.I think that the model where I can pay for additional space could be very beneficial for both parties.Some dudes here think people are mad needing more than 2gb of space and that’s usually true when the project contains mostly code.But if the project comes from the field of gaming or UI there are assets like images,data files etc.Unity3D project is one of those where it is really hard to decouple graphic assets from the code.And using 2 different cloud services for code and for assets is a pain in the ass.

  • Ganesh Kumar Pandithurai

    Is Bitbucketserver 4.9 also has 2GB limit?

    • Brent Plump

      Please see my reply to your post above. Bitbucket Server has no repository size limits.

  • Ganesh Kumar Pandithurai

    We recently moved to Bitbucket. It is a cool tool.

  • Ganesh Kumar Pandithurai

    Would like to understand what is the repository size limit for Bitbucket 4.9.

    • Brent Plump

      This post is only relevant to Bitbucket Cloud. If you are running Bitbucket Server on your own server, there are no repository size limits.