Git cleanup in Mendix after migration from svn to Git

0
After migration from SVN to GIT ,upgraded the app to 10.24.6 version and mendix suggesting to do the Git Cleanup .Is it mandatory ? When trying to do cleanup it is asking to install cleanup tool .is there any alternative way ?If tool is the only way please suggest the write direction to do this.
asked
3 answers
0

As far as I know, It is not mandatory. Mendix suggests doing Git Cleanup after migrating from SVN to Git mainly to reduce repository size and improve clone/download performance. If your team can clone the project and work normally, you can skip it.


However, if the repository becomes very large or new developers experience slow downloads, doing the cleanup is recommended.


When Studio Pro suggests cleanup, it means your repository still contains old SVN history or unnecessary Git history. Cleaning it removes that extra history and keeps only the relevant state of the repository.


Regarding the tool: there is no built-in alternative inside Studio Pro. The official method recommended by Mendix is to use the Git cleanup tool (git-fixer).


Before running the cleanup, it is important to:

  • make sure all important branches are merged to the main branch
  • ensure there are no uncommitted changes
  • take a backup of the repository


After the cleanup is completed and pushed to the server, developers will usually need to reset or re-clone their local repositories, because the Git history will change.


So in short: cleanup is recommended but not strictly required, and the cleanup tool is the official way to perform it.


If this resolves the issue, please mark the answer as accepted.



answered
0

Hi,


The Git Cleanup suggestion after migrating from SVN to Git in Mendix is not strictly mandatory, but it is strongly recommended. The cleanup process removes leftover SVN metadata and restructures the project so that it fully follows the Git-based project format used by newer Mendix versions.

If you skip the cleanup, the project will usually still run, but you may run into issues later with repository size, merge conflicts, or version control inconsistencies.

Regarding the tool: currently the Mendix Git Cleanup Tool is the only supported way to perform this operation. There is no manual or built-in alternative inside Studio Pro because the cleanup modifies multiple internal project files and repository structures.

The typical process is:

  1. Download the Mendix Git Cleanup Tool from the Mendix documentation page.
  2. Close Mendix Studio Pro and ensure the project is not running.
  3. Create a backup or commit all changes before starting.
  4. Run the cleanup tool and point it to your project directory.
  5. After completion, open the project again in Studio Pro and commit the changes to Git.

Once the cleanup is completed, the project will be fully aligned with the Git-native project structure used by Mendix 9/10, which helps avoid future repository issues.

So in short: it is not mandatory for the application to run, but it is recommended, and the official cleanup tool is the supported method to perform it.


answered
0

The error you see is related to Git metadata, not the application itself. The important part in your log is:


refs/notes/mx_metadata is invalid


This means Studio Pro cannot correctly read the Mendix Git notes used for commit history.


A common fix for this kind of repository metadata issue is to run the Mendix cleanup tool described in the documentation. It removes leftover metadata and restructures the repository so it follows the expected Git structure.


You can follow the steps here:

https://docs.mendix.com/refguide/troubleshoot-repository-size/#cleanup-tool


After running the cleanup, reopen the project in Studio Pro and check the History again.


answered