Skip to main content

Troubleshooting

How do I know if my repository is initialized for XetHub?​

Open your terminal and navigate to the local copy of your Xet repository and check your .gitattributes file. If the first three lines of output matches the following, your repository supports Xet functionality:

$ cat .gitattributes
* filter=xet diff=xet merge=xet -text
*.gitattributes filter=
*.xet/** filter=

If not, double check that you have fully followed the installation instructions. Create a new Xet repository and move/copy your files in.

I'd like to work with a Xet repository, but it's too large to fit on my computer. What should I do?​

Follow our best practices for working with huge repositories if you need to edit access, or use Xet mount for read access without needing to download the full repository.

I'm getting a fatal error that says that I may not have the correct access, even though I'm just trying to use my own repository. What's going on?​

If your error looks like this and your repository exists, you may be trying to use SSH without having your SSH key set:

xet@xethub.com: Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

Check your account settings to verify that your SSH key is set. If there are no keys shown, follow our instructions to generate and add a SSH key to your XetHub account.

I just cloned a Xet repository but my local large files seem to be pointers. What do I do?​

The git xet clone command materializes all files by default. If this is not the case, it's possible that the git-xet extension was never initialized. Run the following two commands to manually resolve the files:

git xet install
git xet checkout

I'm using git-xet for the first time on Windows and a Git for Windows prompt appears. What do I enter?​

When connecting with SSH for the first time over Windows, you may encounter the following popup that forgets to ask its intended prompt of: "Do you want to continue? (yes/no)"

To continue, type "yes" in the box and click OK.

I tried to run mount on my Windows machine and it returns an error. What should I do?​

If the error you get looks like the following, you do not have access to the Windows NFS client:

mount: invalid option - 'anon'
Error : Other("Mount command Command { std: \"mount.exe\" \"-o\" \"anon,nolock,mtype=soft,fileaccess=4,casesensitive,lang=ansi,rsize=128,wsize=128,timeout=60,retry=2\" \"\\\\\\\\127.88.0.1\\\\\\\\\" \"X:\", kill_on_drop: false } failed with ExitStatus(ExitStatus(1))")

Windows Home does not support NFS client and thus cannot mount repositories. If you are on Windows Pro, Enterprise, or Server, follow the instructions under the Windows installation tab to enable NFS client. Still stuck? Let us know!

How do I upgrade my git-xet extension?​

If you initially installed git-xet with MacOS Homebrew, use Homebrew's upgrade path:

brew update
brew upgrade xet-tools

Otherwise, follow our standard installation instructions, which will overwrite the previous installation with the most recent release.

How do I uninstall the git-xet extension?​

  1. From your terminal, uninstall the extension:

    git xet uninstall

  2. Then delete the pkg file:

    sudo rm /usr/local/bin/git-xet

If you do uninstall the git-xet extension, please help us understand what we could've done better!