git pull origin develop fails when updating the Adobe Commerce software

This article provides a fix for when you can’t update Adobe Commerce software when running git pull origin develop.

Details

One of the steps to updating the Adobe Commerce software is to update your local repository by running:

$ git pull origin develop

The following error might display:

error: Your local changes to the following files would be overwritten by merge:
<list of files>

To find which files are subject to being overwritten, either read the message or enter:

git status

The next section discusses suggested solutions.

Suggested solutions

Your solution depends on whether or not you intentionally modified files in the Adobe Commerce file system. See one of the following sections for more information.

You intentionally modified files

Manually resolve the conflicts in the usual way. If you’re not sure what to do, consult GitHub help.

You didn’t intentionally modify any files

Try any of the following:

  • If you’re certain you didn’t modify any files, and you don’t mind removing or overwriting the changes in the Adobe Commerce file system, enter:

    code language-bash
    $ git reset --hard HEAD && git pull origin develop
    

    After that, continue where you left off with your Adobe Commerce update.

  • It’s possible that a GitHub configuration setting can prevent these errors in the future. By default, GitHub stores content using the operating system-default line ending characters. If you’re using Linux, but another collaborator committed a change using Windows, GitHub converts the Windows line endings to Linux when you clone or pull. This gives the appearance of a change to files when in fact, no change was made.

    To configure GitHub to ignore line endings, enter the following command in your Git client:

    code language-bash
    $ git config --system core.autocrlf false
    

    If you use Windows, enter:

    code language-bash
    $ git config --system core.eol LF
    
    note note
    NOTE
    Adobe does not recommend or endorse any particular GitHub configuration settings. The preceding are suggestions only. For more information, consult GitHub help.

    Continue where you left off with your Adobe Commerce update.

recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a