Git Errors | Appsmith
https://docs.appsmith.com/help-and-support/troubleshooting-guide/git-errors • 63 KB fetched
Open original page
Git Errors | Appsmith
Skip to main content
Ask AI
Search
Ask Appsmith AI Submit message
Examples How do I install Appsmith using Docker? How do I connect to my local PostgreSQL database? How do I pass inputs from a widget to a query? How do I trigger multiple queries conditionally? How do I fix the error: This value does not evaluate to type Array<Object>?
Search
Try Appsmith
* Get Started
* Introduction
* Build Your First App
* Self Hosting
* New Installation Guides
* Manage Installation
* Upgrade Installation Guides
* Concepts
* Connect Data
* Overview
* How-to Guides
* Reference
* Datasources
* Query Settings
* Concepts
* Build Apps
* Overview
* Quickstart
* How-to Guides
* Reference
* Widgets
* Accessibility
* Theme
* Sample Apps
* Write Code
* Overview
* How-to Guides
* Reference
* Global Objects
* Global Functions
* JS Libraries
* Fetch API
* Data Transformation
* JavaScript Settings
* Concepts
* Best Practices
* Manage Apps and Users
* Authentication
* Granular Access Control
* Versioning with Git
* Setup SCIM Provisioning
* Embed Appsmith
* Migrate Applications
* Audit Logs
* Branding
* External Client Portal
* Packages
* Overview
* Tutorial
* How-to Guides
* Reference
* Package Version Control
* GIT Apps with Packages Best Practices
* Code Packages
* UI Packages
* Workflows
* Overview
* Tutorial
* How-to Guides
* Reference
* Workflow Triggers
* Workflow Queries
* Workflow Functions
* Pass Parameters to Workflows
* Run History
* Troubleshooting
* Overview
* Self-hosting Errors
* Application Errors
* Datasource Errors
* Query Errors
* Git Errors
* Granular Access Control Errors
* Cyclic Dependency Errors
* Embedding and Content Security Errors
* JS Errors
* Query Errors
* Widget Errors
* Product
* FAQ
* Security
* Telemetry
* Support at Appsmith
* Privacy Policy
* Release Notes
* Contribute
© 2026 Appsmith, Inc.
*
* Troubleshooting
* Application Errors
* Git Errors
On this page
Git Errors
This page shows how to resolve common Git errors on Appsmith.
Invalid Git repo
Invalid Git repo
Cause
The SSH address provided is incorrect or access rules prevent connection to the repository.
Solution
* Verify if the SSH address is correct and functional.
* Check connection rules on the platform where the application is deployed.
* If issues persist, contact support for assistance.
Invalid GitConfig
Invalid GitConfig.
Cause
This error occurs due to a Redis cache issue with user profiling, resulting in an invalid Git configuration.
Solution
* Logout from the application.
* Login again to refresh the user profile and Git configuration.
* If issues persist, contact support for assistance.
Conflicts while merging
Conflicts while merging branch b <= a
Cause
Conflicts arise during the merging process when the same file has been edited on both branches, and Git cannot automatically resolve these conflicts.
Solution
If facing conflicts in the Appsmith UI while merging branch A into branch B , raise a pull request targeting branch B on your Git provider, and manually resolve the conflicts.
See Resolve Merge Conflicts in Git
Git push failed for pending upstream changes
Looks like there are pending upstream changes. To prevent you from losing history, we will pull the changes and push them to your repo.
Cause
If you're working on branch A and someone else pushes changes to the remote counterpart of the same branch, you may encounter conflicts if both have edited the same files.
Solution
To resolve this:
* Create a new branch from your local branch A , naming it branch A-fix .
* Raise a pull request from branch A-fix against the original branch A .
* Resolve conflicts within the pull request interface or locally before merging.
* In Appsmith, discard and pull the changes into branch A .
See Resolve Merge Conflicts in Git
Maximum call size exceeded error
Maximum call size exceeded
Cause
This error is due to the size limit on the merge operation being exceeded, possibly from large files or too many changes.
Solution
Split the merge operation into smaller chunks and remove any unnecessary large files from the repository.
Private repo limit error
Private Repo Limit Error
Cause
This occurs due to restrictions on the number of private repositories that can be connected.
Solution
In the community edition, you can only connect to 3 private repositories. If you want to connect more private repositories, you must upgrade to a paid plan. For more information, see Pricing .
CI/CD deployment failed - missing packages
AE-GIT-5002: Deployment aborted to protect the last successful version as the artifact is in an invalid state. Details: Module instances exist without the necessary packages/modules in the current workspace. Please resolve the missing dependencies first.
Cause
This error occurs when CI/CD fails because the application uses Packages that are not present in the workspace where the CI/CD is being triggered. The deployment is aborted to protect the last successful version.
Solution
To resolve this:
*
Ensure that all Packages used by the application are imported into the workspace of the application for which CI/CD is being triggered.
*
If the issue continues to happen despite importing all Packages, reconfigure the bearer token from the CI/CD settings of the application and use the new bearer token in your CI/CD API. This is required because older bearer tokens may not have the necessary permissions to resolve Package dependencies.
For more information, see CI/CD with Git-Connected Apps and Packages .
Edit and view mode out of sync
Cause
In some cases, an issue can occur where the latest changes have been pulled to the edit mode of the application, but the deployment to view mode failed. This results in edit mode and view mode being out of sync, with no more commits to be pushed.
Solution
When edit and view mode are out of sync and there are no more changes to be committed, you will see the Deploy button on the top right of the editor displaying an orange notification dot. When you hover over it, a tooltip will appear stating "Redeploy needed to sync changes from edit mode." To resolve this:
* Open the Git commit modal by clicking the Deploy button on the top right of the editor.
* Click the Redeploy button in the Git modal to synchronize the changes from edit mode to view mode.
Redeploy app
Git connection lost after restart
Cause
On self-hosted instances without a persistent volume, the local Git repository clones are stored on ephemeral container storage. When the Appsmith container or instance is restarted, the cloned repositories are wiped, and the app is no longer able to reconnect to its Git repository.
Solution
* Configure a persistent volume for your deployment so that Git repositories are maintained across restarts.
* Set the APPSMITH_GIT_ROOT environment variable to a directory on the persistent volume so repositories are created and persisted. See Git Local File Path .
* If issues persist, contact support for assistance.
SSHKey error when connecting to a repository
SSHKey error
Cause
Appsmith connects to Git over SSH using deploy keys. This error typically appears when the instance cannot reach the Git provider over the network, due to firewall rules, security group settings, or proxy configuration blocking outbound traffic, rather than the key itself being missing.
Solution
* Verify network connectivity from the Appsmith host to the Git provider, including firewall rules, security group settings, and any proxy configuration that may restrict outbound traffic.
* From an affected node, test basic connectivity and HTTPS port reachability, for example ping github.com and telnet github.com 443 .
* If a proxy is in use, test connectivity with the proxy disabled to isolate the cause.
* Confirm you are using the SSH repository URL with a deploy key. HTTPS Git connections are not supported. See Setup GitHub .
* If issues persist, contact support for assistance.
Unable to populate branches / file system lock error
Git command execution error: We were unable to place a lock on the file system to perform status command. This error can occur when another command listBranch, which is in progress.
Cause
A concurrent Git operation holds a lock on the file system, preventing other Git commands (such as listing branches) from completing. This can surface after upgrading the instance.
Solution
* As an instance admin, enable Atomic pushes in the instance settings (only visible to instance admins).
* If issues persist, contact support for assistance.
Version mismatch when pulling between environments
Cause
When a development environment runs a newer Appsmith version than a higher environment (such as staging or production), pulling changes from the newer environment into the older one fails with a version mismatch. This is expected behavior.
Solution
* Update the other environment to the same Appsmith version (or higher) so the Git operation succeeds.
* Keep all environments connected to the same repository on the same Appsmith version to avoid version-related Git conflicts. See Continuous Delivery (CI/CD) with Git .
Discard local changes fails or changes reappear
Unexpected character ('<' (code 60)): was expecting double-quote to start field name
Cause
When a merge conflict is resolved manually on the remote (for example in an editor or your Git provider) and the resulting page JSON becomes invalid, Appsmith cannot import the artifact. As a result, discarding local changes reports success but the uncommitted changes reappear, or the discard fails outright.
Solution
* Identify the corrupted page file in your repository (the error message names the file, line, and column, for example pages/<PageName>/<PageName>.json ).
* Validate the page JSON with a JSON validator and correct the formatting issue introduced during conflict resolution, then commit the fix to the remote.
* In Appsmith, click Discard and Pull to update the app. See Resolve Merge Conflicts in Git .
* If issues persist, contact support for assistance.
Was this page helpful?
Edit this page
Previous
Query Errors
Next
Granular Access Control Errors
* Invalid Git repo
* Invalid GitConfig
* Conflicts while merging
* Git push failed for pending upstream changes
* Maximum call size exceeded error
* Private repo limit error
* CI/CD deployment failed - missing packages
* Edit and view mode out of sync
* Git connection lost after restart
* SSHKey error when connecting to a repository
* Unable to populate branches / file system lock error
* Version mismatch when pulling between environments
* Discard local changes fails or changes reappear
Links found on this page
- Skip to main content [direct]
- Try Appsmith [direct]
- Get Started [direct]
- Build Your First App [direct]
- Self Hosting [direct]
- New Installation Guides [direct]
- Manage Installation [direct]
- Upgrade Installation Guides [direct]
- Concepts [direct]
- Connect Data [direct]
- How-to Guides [direct]
- Reference [direct]
- Query Settings [direct]
- Concepts [direct]
- Build Apps [direct]
- Quickstart [direct]
- How-to Guides [direct]
- Reference [direct]
- Widgets [direct]
- Accessibility [direct]
- Theme [direct]
- Sample Apps [direct]
- Write Code [direct]
- How-to Guides [direct]
- Reference [direct]
- Global Objects [direct]
- Global Functions [direct]
- JS Libraries [direct]
- Fetch API [direct]
- Data Transformation [direct]
- JavaScript Settings [direct]
- Concepts [direct]
- Best Practices [direct]
- Manage Apps and Users [direct]
- Granular Access Control [direct]
- Versioning with Git [direct]
- Setup SCIM Provisioning [direct]
- Embed Appsmith [direct]
- Migrate Applications [direct]
- Audit Logs [direct]
- Branding [direct]
- External Client Portal [direct]
- Packages [direct]
- Tutorial [direct]
- How-to Guides [direct]
- Reference [direct]
- GIT Apps with Packages Best Practices [direct]
- Code Packages [direct]
- UI Packages [direct]
- Workflows [direct]
- Tutorial [direct]
- How-to Guides [direct]
- Reference [direct]
- Workflow Queries [direct]
- Workflow Functions [direct]
- Pass Parameters to Workflows [direct]
- Run History [direct]
- Troubleshooting [direct]
- Self-hosting Errors [direct]
- Application Errors [direct]
- Datasource Errors [direct]
- Query Errors [direct]
- Granular Access Control Errors [direct]
- Cyclic Dependency Errors [direct]
- Embedding and Content Security Errors [direct]
- JS Errors [direct]
- Query Errors [direct]
- Widget Errors [direct]
- Product [direct]
- Security [direct]
- Telemetry [direct]
- Support at Appsmith [direct]
- Privacy Policy [direct]
- Release Notes [direct]
- Contribute [direct]
- Resolve Merge Conflicts in Git [direct]
- Pricing [direct]
- Git Local File Path [direct]
- Setup GitHub [direct]
- Continuous Delivery (CI/CD) with Git [direct]