Repository collaboration with Large Media

When a repository is configured to use Large Media and Git LFS, contributors cloning and working with the repository locally must also have these services installed, and must have access to the site on Netlify.

To start working locally with a repository configured for Large Media, complete all of the stated requirements, then clone and push as normal.

Tip

No local setup is required for contributing to a repository via Netlify CMS.

Repository forks

You can fork a repository connected to a site enabled for Large Media, with the following limitations:

  • In order to access the Large Media files, you must fulfill all of the Large Media requirements, including access to the Netlify site connected to the main (upstream) repository.
  • You cannot create a new Netlify site from the fork, because the Large Media files are accessible on the original site only.

Clone without Large Media files

For contributions that don't require access to a repository's Large Media files, you can use GIT_LFS_SKIP_SMUDGE=1 with your clone command to ignore LFS settings and download the text pointer files only:

GIT_LFS_SKIP_SMUDGE=1 git clone YOUR_REPOSITORY_URL

Windows users

PowerShell and the Windows command line (cmd.exe) do not support the above syntax. For Windows users, we recommend running the command above using Git Bash for Windows.

Netlify CMS

When you have Large Media enabled on your site, you can use Netlify CMS with Netlify Identity to allow your site editors to work seamlessly with Large Media files in the Netlify CMS UI — with no local setup required on their end.

To get started, refer to the Large Media setup instructions to enable Large Media on your site, then visit the Netlify CMS docs for more information on CMS setup and configuration options.