---
name: "alr-pin"
section: "1"
platform: "linux"
package: "alire"
version: "1.2.1-2.1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/alr-pin"
---

# alr-pin(1)

Pin dependencies to exact versions

## NAME

alr-pin - Pin dependencies to exact versions

## SYNOPSIS

*alr pin* \[options\] \[\[crate\[=\<version\>\]\] \| crate --use=\<path\> \[--commit=REF\] \[--branch=NAME\] \| --all\]

## OPTIONS

- \--all

  Pin the complete solution

- \--unpin

  Unpin a release

- \--branch=*NAME*

  Branch to be tracked in repository

- \--commit=*REF*

  Reference to be retrieved from repository

- \--use=*PATH\|URL*

  Use a directory or repository to fulfill a dependency

## GLOBAL OPTIONS

- \-c, --config=*ARG*

  Override configuration folder location

- \-f, --force

  Keep going after a recoverable troublesome situation

- \-h, --help

  Display general or command-specific help

- \-n, --non-interactive

  Assume default answers for all user prompts

- \--no-color

  Disables colors in output

- \--no-tty

  Disables control characters in output

- \--prefer-oldest

  Prefer oldest versions instead of newest when resolving dependencies

- \--version

  Displays version and exits

- \-q

  Limit output to errors

- \-v

  Be more verbose (use twice for extra detail)

- \-d, --debug\[\]

  Enable debug-specific log messages

## DESCRIPTION

Pin releases to a particular version. By default, the current solution version is used. A pinned release is not affected by automatic updates.

Without arguments, show existing pins. Use *--all* to pin the whole current solution. Specify a single crate to modify its pin. Use the *--use* \<PATH\|URL\> switch to use the target to fulfill a dependency locally instead of looking for indexed releases. An optional reference can be specified with *--commit*; the pin will be frozen at the commit currently matching the reference.  Alternatively, a branch to track can be specified with *--branch*. Use \`alr update\` to refresh the tracking pin contents.

## SEE ALSO

*[alr(1)](/alr/1.md)*, *[alr-get(1)](/alr-get/1.md)*, *[alr-index(1)](/alr-index/1.md)*, *[alr-init(1)](/alr-init/1.md)*, *[alr-search(1)](/alr-search/1.md)*, *[alr-show(1)](/alr-show/1.md)*, *[alr-update(1)](/alr-update/1.md)*, *[alr-with(1)](/alr-with/1.md)*, *[gprbuild(1)](/gprbuild/1.md)*

## AUTHOR

Generated with generate-man from Alire execution