# error: LFS: Unable to checkout '<file>' because it has LFS pointer content but Git LFS is not installed or configured

- **ID:** `git/lfs-pointer-not-smudged`
- **Domain:** git
- **Category:** install_error
- **Verification:** ai_generated
- **Fix Rate:** 93%

## Root Cause

A file tracked by Git LFS contains only the pointer text (e.g., 'version https://git-lfs.github.com/spec/v1') instead of the actual content because Git LFS is not installed, not initialized, or the smudge filter is missing.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| git-lfs 3.3.0 | active | — | — |
| git-lfs 3.4.1 | active | — | — |
| git-lfs 3.5.0 | active | — | — |

## Workarounds

1. **Install Git LFS: 'brew install git-lfs' (macOS) or 'sudo apt-get install git-lfs' (Linux), then run 'git lfs install' to set up filters, and 'git lfs pull' to download the actual file content** (95% success)
   ```
   Install Git LFS: 'brew install git-lfs' (macOS) or 'sudo apt-get install git-lfs' (Linux), then run 'git lfs install' to set up filters, and 'git lfs pull' to download the actual file content
   ```
2. **If installation is not possible, manually download the file from the LFS remote server using the OID in the pointer file: 'curl -H "Accept: application/vnd.git-lfs+json" <lfs-endpoint>/objects/<oid>'** (70% success)
   ```
   If installation is not possible, manually download the file from the LFS remote server using the OID in the pointer file: 'curl -H "Accept: application/vnd.git-lfs+json" <lfs-endpoint>/objects/<oid>'
   ```

## Dead Ends

- **** — This bypasses LFS tracking, causing the large file to be stored directly in Git, defeating the purpose of LFS and bloating the repository. (70% fail)
- **** — The 'git lfs' command does not exist if LFS is not installed; the shell will return 'command not found'. (90% fail)