Keep your Git repository clean
On this page
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 Platform.sh API and Console are closely tied to Git. When the performance of Git decreases, Platform.sh 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.
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 Platform.sh.
To automate this process, when setting up a source integration,
If you already have a source integration set up and want to enable the
follow these steps:
Keeping too many files, especially large binary files, in your Git repository can cause performance and stability issues. Therefore, Platform.sh recommends that you only commit your source code in Git.
Platform.sh does not currently support Git Large File Storage.
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:
- Remove old, unwanted files from your repository (especially large files). You can do it manually, or use a tool such as BFG Repo-Cleaner.
- Remove stale branches from your repository and Platform.sh project.
- Rebase and/or squash commits to clean up your history.
- 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.