Git troubleshooting#

Git is in itself a very complex and powerful system that sometimes causes difficulties. In combination with external Git servers it can sometimes come to some mistakes, which are listed here.

General recommendations#

  • Keep your Git repository on an internal drive. Avoid mapped/ network drives or RAID management software that creates custom volumes.

  • Don’t put your Git repository in a Dropbox, Google Drive, Cloud Drive, NAS or similar

  • If you run out of storage, clear the Git cache by clicking on Git commands / Clear Cache.

  • Make sure that you have enough Git LFS storage on your Git hosting provider (GitHub, Azure, GitLab, etc).

The commit process shows an error#

This problem often occurs if you are using a mapped/network or custom mounted drive with RAID management software. Git will not be stable here. It’s recommended that you work on an internal hard drive. If you have created your project on a mapped drive, simply cut and paste the project folder (including the _.approj file) to your internal drive. Then open Anchorpoint by double clicking on the _.approj file.

A team member cannot join the Git repository#

This may be because the team member was added on the Git server. Besides Anchorpoint, you also need to invite him to your repository on GitHub, Azure DevOps, Gitea, etc. so that he has access to the data. If a member does not have access, Anchorpoint will display the name of the Git server where you need to add your team member in a message.

Azure DevOps#

In the case of Azure DevOps, we have created a tutorial. Remember to change your team member from “Basic” to “Stakeholder” so they can read and edit data in the repository.

GitHub#

Upload your team member to a repository. To do this, do the following:

  • Open your repository on GitHub.com.

  • Click on Settings at the top

  • Click on Collaborators on the left.

  • Click on the Add people button. It is important that you use the same email that was used in Anchorpoint.

The Timeline is empty#

You reformatted your computer#

In this case Git thinks you are no longer the original owner of the project because your user ID has changed. To fix this:

  • Click on Git Commands in the Anchorpoint project

  • Choose Open Git Console / Terminal

  • In the terminal type in: git status and press enter

https://cdn.loom.com/images/originals/a081a105687c47a1afb758715b3a5b1f.jpg?

  • If you get a similar output, retype what you see in the console. In this case git config --global --add safe.directory H:/myProject and press enter

  • Then, type in: git status again and press enter.

It should rebuild the index. You may will be asked to enter your Git login data for your Git hosting provider again. Once you have done this, restart Anchorpoint and open the timeline.

You are running out of disk space#

Git needs at least twice the disk space of your production files in the Git repo. If Git does not get enough memory, it has to recalculate the index. This process takes time.

What you can do is to move your project in the file explorer to another disk. Important, copy the whole project folder and not only the content. Then when you open Anchorpoint by clicking on the *.approj file, Anchorpoint will open your project in the new location.

Not a Git repository#

The toast shows “This folder is not a git repository”.

In this case the hidden .git folder is not available. The best way to get it back is to download the repository from the cloud again. Follow these steps:

  1. Close Anchorpoint and rename the project folder in Windows Explorer/ macOS Finder

  2. Open Anchorpoint again (it won’t be able to find the project)

  3. Create a new folder and download the Git repo there

Azure DevOps network configuration#

At times, Azure DevOps may experience malfunctions when accessed through the IPv6 network protocol. To address this issue, Anchorpoint offers a solution that involves modifying your network configuration to ensure that only Azure DevOps utilizes the IPv4 protocol. We do this by making adjustments to the hosts configuration file.

Alternatively, you have the option to completely disable IPv6 on your system. Follow the steps outlined in this guide to disable IPv6.

Other issues#

We are constantly collecting issues to either improve Anchorpoint or to provide help. To make our life easier report us your issue by doing the following:

  • Go to your Workspace Settings / Troubleshooting and enable Advanced Python Logging

  • Restart Anchorpoint

  • Try to do what went wrong (e.g. committing files, pulling, opening the timeline, reverting etc.)

  • When the error shows up again send us a message by clicking on the “…” button in the top right corner

  • After that, please disable Advanced Python Logging again

Describe your problem in the message. We will get a log file containing the error. This should give us all the information we need to fix it. Otherwise, you can also contact us at our Discord server