Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.upsun.com/llms.txt

Use this file to discover all available pages before exploring further.

When a Git repository contains a high number of references and files, the performance of Git can decrease. This is why most Git providers have repository size limits in place (for more information, see the GitHub, GitLab and Bitbucket documentation). The Upsun API and Console are closely tied to Git. When the performance of Git decreases, Upsun API servers also become slower. As a user, you can then experience significant latencies. If your repository becomes too large, your Console may even become unresponsive, leaving you unable to access your project. To avoid such issues, make sure you keep your Git repository clean by following the instructions on this page. If you’re already facing performance issues and suspect they might be related to the size of your Git repository, see how you can troubleshoot a sizeable Git repository.

​
Enable the automated pruning of old branches in your project

To keep your repository size to a minimum, make sure that branches that don’t exist anymore in your repository have also been deleted from Upsun. To automate this process, when setting up a source integration, enable the prune-branches option. If you already have a source integration set up and want to enable the prune-branches option, follow these steps:
  1. To enable the prune-branches option, you must first enable the fetch-branches option. To do so, run the following command: 
    upsun integration:update --project <PROJECT_ID> <SOURCE_INTEGRATION_ID> --fetch-branches true
  2. Then, to enable the prune-branches option, run the following command: 
    upsun integration:update --project <PROJECT_ID> <SOURCE_INTEGRATION_ID> --prune-branches true

​
Upload your files through mounts

Keeping too many files, especially large binary files, in your Git repository can cause performance and stability issues. Therefore, Upsun recommends that you only commit your source code in Git. To upload any other files to your app, create mounts and transfer your files directly to them.
Upsun does not currently support Git Large File Storage.There is a 100MB default file size limit for direct Git pushes to Upsun. Pushing files larger than the limit will result in rejecting the push, so please keep this in mind. If you’d like to request a custom limit, please contact Support.

​
Troubleshoot a sizeable Git repository

If you’re experiencing latencies or can’t access your Console anymore, your Git repository may have become too large and may need to be cleaned up. To do so, follow these instructions:
  1. Remove old, unwanted files from your repository (especially large files). You can do it manually, or use a tool such as BFG Repo-Cleaner.
  2. Remove stale branches from your repository and Upsun project.
  3. Rebase and/or squash commits to clean up your history.
  4. Make sure you enable the automated pruning of old branches in your project and upload your files through mounts to avoid facing the same situation in the future.
Last modified on March 13, 2026