Skip to content
DevContainer Features

Git LFS

Status

Section titled “Status”

Version: 1.0.0 | Tests: Passing

Usage

Section titled “Usage”
devcontainer.json 
{
    "features": {
        "ghcr.io/infrashift/trusted-devcontainer-features/git-lfs:latest": {}
    }
}

Options

Section titled “Options”

This feature has no configurable options.

Dependencies

Section titled “Dependencies”
git → this feature

How It Works

Section titled “How It Works”

Git Large File Storage (LFS) replaces large files in your repository with lightweight pointer files while storing the actual file content on a remote server. This feature downloads and installs Git LFS from the official GitHub releases, enabling you to work with repositories that track large binaries, datasets, or media files.

The Ansible playbook downloads the linux-amd64 tarball for the specified Git LFS version, extracts the archive, and runs the included install.sh script. This script sets up the necessary Git hooks and filters so that LFS-tracked files are automatically fetched and checked out when you clone or pull a repository. The playbook then verifies the installation to confirm everything is working correctly.

This feature requires the Git feature to be installed first, as Git LFS operates as a Git extension and depends on a working Git installation. When you include git-lfs in your devcontainer configuration, the dependency chain ensures that Git is compiled from source and installed before Git LFS is set up. This feature has no configurable options; it installs the bundled version included with the feature.