Move existing LFS history from GitHub

Copy all required LFS objects before switching collaborators, and keep the old copy until verification is complete.

Prepare the migration

Confirm every required object across history fits within your 10 GB workspace allowance. Files must be no larger than 5 GB each.
Pause writes or arrange a final synchronization window. Record the existing LFS endpoint and all local lfs.url, lfs.pushurl, and remote-specific overrides.
Keep an independent backup. Confirm that the source credentials can read every required branch and tag, including any separately managed refs.

Fetch from the old host first

In a complete clone with the original LFS configuration still active, fetch Git refs and all reachable LFS objects. Do not switch the endpoint until this succeeds. Extra refs outside the remote's normal fetch refspec must be fetched explicitly.

git fetch origin --prune --tags
git lfs fetch --all origin

This moves objects that are already tracked by Git LFS. Converting ordinary Git blobs into LFS is a separate history-rewriting operation that requires its own backup and team coordination.

Copy to LFSPush

Create the destination repository and a scoped write token. Resolve any existing push URL overrides so uploads use the intended destination. A local URL override lets you test the copy before changing the shared configuration.

git config --local credential.https://lfspush.dev.useHttpPath true
git config --local lfs.url https://lfspush.dev/lfs/rep_YOUR_ID
git lfs push --all origin

Your Git origin remains the code host. This command sends LFS objects to the configured LFS endpoint; it does not migrate GitHub issues, pull requests, permissions, or locks.

Switch the team after verification

Verify the destination in a clean clone using an explicit local LFSPush URL override, then test current and historical files. After the final source synchronization and destination upload, commit the shared endpoint. Reapply local overrides as needed when checking older commits whose .lfsconfig still points at the old host.

git config -f .lfsconfig lfs.url https://lfspush.dev/lfs/rep_YOUR_ID
git add .lfsconfig
git commit -m 'Move LFS storage to LFSPush'
git push origin HEAD

Do not delete the source storage until the team's clean-clone, history, and CI checks all pass. Keep the original endpoint and credentials available for rollback.

Client references

Git LFS fetch reference Git LFS push reference

Open your workspace