Git Submodules: detached HEAD from lost commit pin

Published: 09 July 2026
on channel: TheCodeForge

A submodule update left a detached HEAD — the parent pinned a lost commit. Root cause: Submodules check out a commit, not a branch, by default. The fix: `git submodule update --remote` on a tracked branch; commit the pin.

A production war story from the TheCodeForge Git series — the incident, why it happened, and the exact fix.

⏳ Timestamps:
0:00 - Cold open: error: pathspec 'submodule/foo' did not match any file(s) known to git
0:11 - Intro
0:19 - What Is a Submodule?
0:38 - How Submodules Work
1:11 - Adding a Submodule
1:38 - Cloning with Submodules
2:05 - Updating Submodules
2:38 - Merge Conflicts with Submodules
3:14 - Submodules in CI/CD
3:47 - When Not to Use Submodules
4:05 - error: pathspec 'submodule/foo' did not match any file(s) known to git
4:28 - Submodule commit not pushed
4:42 - The Fix
5:00 - ⚠ Gotcha: Pushing parent before submodule commit
5:16 - ⚠ Gotcha: Making changes in submodule without checking out a branch
5:32 - ⚠ Gotcha: Pinning submodule to a branch instead of a tag
5:50 - Automated Submodule Push Check
6:06 - Submodule Branch Tracking Caveat
6:41 - Debugging Guide
6:56 - Interview Questions
7:24 - FAQ
7:48 - Key Takeaways
8:06 - Next up
8:21 - Wrap-up

👉 Full article + code: https://thecodeforge.io/devops/git-su...
⏭ Next up: Git Internals: Objects, Trees, Blobs and the DAG

#git #devops #versioncontrol

On this page of the site you can watch the video online Git Submodules: detached HEAD from lost commit pin with a duration of hours minute second in good quality, which was uploaded by the user TheCodeForge 09 July 2026, share the link with friends and acquaintances, this video has already been watched 9 times on youtube and it was liked by 1 viewers. Enjoy your viewing!

2,457