git » homepage.git » commit 08df659

Document LFS restore workflow

author Alan Dipert
2026-08-09 19:03:36 UTC
committer Alan Dipert
2026-08-09 19:03:36 UTC
parent 158240641d60de55c8dabc55f778b233e1c89257

Document LFS restore workflow

README.md +10 -0

diff --git a/README.md b/README.md
index fc9f673..38b8a6a 100644
--- a/README.md
+++ b/README.md
@@ -61,3 +61,13 @@ Deploy first runs the reproducible container build, then uses host-side rsync an
 ## Media preservation tools
 
 The pinned builder image also includes `yt-dlp`, `ffmpeg`, and `git-lfs` for preserving media associated with the TechWorks archive. They are archival tools, not requirements for the local fallback build. Media should be downloaded only when redistribution is appropriate; otherwise preserve metadata, captions, and durable source links.
+
+Full-resolution MP4 masters under `md/TechWorks/media/video/` are tracked with Git LFS. Initialize Git LFS before checking out or restoring them, then verify the local object store:
+
+```sh
+git lfs install
+git lfs pull
+git lfs fsck
+```
+
+The DreamHost upstream uses Git LFS's pure-SSH transport. Maintainer remotes must use standard `ssh://user@host/absolute/path` syntax; a colon between the host and absolute path prevents Git LFS from identifying the endpoint.