git-lfs-unlock(1)

git-lfs-unlock1

Remove "locked" setting for a file on the git lfs server

Usage

git lfs unlock [<options>] <path>

Overview

Removes the given file path as "locked" on the Git LFS server. Files must exist and have a clean git status before they can be unlocked. The --force flag will skip these checks.

Options

-r <name>, --remote=<name>

Specify the Git LFS server to use. Ignored if the lfs.url config key is set.

-f, --force

Tells the server to remove the lock, even if it’s owned by another user.

-i <id>, --id=<id>

Specifies a lock by its ID instead of path.

-j, --json

Writes lock info as JSON to STDOUT if the command exits successfully. Intended for interoperation with external tools. If the command returns with a non-zero exit code, plain text messages will be sent to STDERR.

Releases

5 releases since Debian 10 (Buster); the text changed 4 times.

  1. 10
  2. 11
  3. 12
  4. 13
  5. Arch

--id since Debian 12 (Bookworm); --remote since Debian 12 (Bookworm); -i since Debian 12 (Bookworm); -j since Arch Linux 2026-11-01; -r since Debian 12 (Bookworm).

From git-lfs 3.8.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.