Set up Git LFS

Install the Git LFS extension for your operating system.

brew install git-lfs

Run this once per machine. It installs the Git hooks that intercept LFS-tracked files during git push and git pull.

git lfs install

Tell Git which server handles LFS objects for this repository. Using .lfsconfig keeps the setting in version control so your team picks it up automatically.

git config -f .lfsconfig lfs.url YOUR_LFS_URL
git add .lfsconfig

Replace YOUR_LFS_URL with the value shown on your repository page in the dashboard.

Git needs an access token to authenticate with LFS Harbor.

1. Go to the LFS Harbor Dashboard.
2. Click on your repository.
3. Click Create token.
4. Name the token and set the expiry.
5. Copy the username and token value.
6. Store the credentials with Git's credential helper:

git credential approve <<EOF
protocol=https
host=lfs.lfsharbor.com
username=YOUR_USERNAME
password=YOUR_ACCESS_TOKEN
EOF

Replace YOUR_USERNAME and YOUR_ACCESS_TOKEN with the values from the dashboard. Git will use whichever credential store is configured on your machine (keychain on macOS, libsecret on Linux, Windows Credential Manager on Windows).

Tell Git LFS which files to manage. This writes a rule to .gitattributes — commit it so the whole team shares the same tracking rules.

git lfs track "*.psd"
git add .gitattributes

You can track multiple patterns. Run git lfs track once for each file type, or edit .gitattributes directly.

Add a tracked file, commit, and push as normal. Git LFS uploads the objects to LFS Harbor before updating the Git ref — pushes may take longer for large files.

git add your-file.psd
git commit -m "Add large file"
git push

That's it. LFS Harbor now stores your large files and your Git history stays fast.