diff --git a/git/git-lfs.rst b/git/git-lfs.rst
index 8c3cbe1d..36cdaa9b 100644
--- a/git/git-lfs.rst
+++ b/git/git-lfs.rst
@@ -142,6 +142,25 @@ For instance, if you were working with
     git config lfs.url https://git-lfs-rw.lsst.cloud/lsst/testdata_subaru
     git config lfs.locksverify false
 
+.. _migrating-git-lfs:
+
+Migrating Git LFS
+=================
+
+If you were already using Git LFS with ``https://git-lfs.lsst.codes``
+you will find that pulling a repository you had previously been using
+fails.  This is because the ``.lfsconfig`` in that repository is still
+referencing the old LFS URL, which is no longer serving content.
+
+In that case you need to run:
+
+``git config lfs.url https://git-lfs.lsst.cloud/<owner>/<repo>`` and
+then try the pull again.
+
+If you know you are going to need to push LFS objects, you can use
+``git-lfs-rw`` here instead as described above, or you can configure
+that later, if and when you need it.
+
 .. _git-lfs-historical:
 
 Checking out historical commits