2021-02-26 13:55:54 +00:00
|
|
|
R""(
|
|
|
|
|
|
|
|
# Examples
|
|
|
|
|
2023-10-31 15:19:05 +00:00
|
|
|
* Create the lock file for the flake in the current directory:
|
2021-02-26 13:55:54 +00:00
|
|
|
|
|
|
|
```console
|
2023-10-31 15:19:05 +00:00
|
|
|
# nix flake lock
|
|
|
|
warning: creating lock file '/home/myself/repos/testflake/flake.lock':
|
|
|
|
• Added input 'nix':
|
|
|
|
'github:NixOS/nix/9fab14adbc3810d5cc1f88672fde1eee4358405c' (2023-06-28)
|
|
|
|
• Added input 'nixpkgs':
|
|
|
|
'github:NixOS/nixpkgs/3d2d8f281a27d466fa54b469b5993f7dde198375' (2023-06-30)
|
2021-02-26 13:55:54 +00:00
|
|
|
```
|
|
|
|
|
2023-10-31 15:19:05 +00:00
|
|
|
* Add missing inputs to the lock file for a flake in a different directory:
|
2021-02-26 13:55:54 +00:00
|
|
|
|
2023-10-31 15:19:05 +00:00
|
|
|
```console
|
|
|
|
# nix flake lock ~/repos/another
|
|
|
|
warning: updating lock file '/home/myself/repos/another/flake.lock':
|
|
|
|
• Added input 'nixpkgs':
|
|
|
|
'github:NixOS/nixpkgs/3d2d8f281a27d466fa54b469b5993f7dde198375' (2023-06-30)
|
|
|
|
```
|
2021-02-26 13:55:54 +00:00
|
|
|
|
2023-10-31 15:19:05 +00:00
|
|
|
> **Note**
|
|
|
|
>
|
|
|
|
> When trying to refer to a flake in a subdirectory, write `./another`
|
|
|
|
> instead of `another`.
|
|
|
|
> Otherwise Nix will try to look up the flake in the registry.
|
2021-02-26 13:55:54 +00:00
|
|
|
|
2023-10-31 15:19:05 +00:00
|
|
|
# Description
|
2021-02-26 13:55:54 +00:00
|
|
|
|
2023-10-31 15:19:05 +00:00
|
|
|
This command adds inputs to the lock file of a flake (`flake.lock`)
|
|
|
|
so that it contains a lock for every flake input specified in
|
|
|
|
`flake.nix`. Existing lock file entries are not updated.
|
2021-02-26 13:55:54 +00:00
|
|
|
|
2023-10-31 15:19:05 +00:00
|
|
|
If you want to update existing lock entries, use
|
|
|
|
[`nix flake update`](@docroot@/command-ref/new-cli/nix3-flake-update.md)
|
2021-02-26 13:55:54 +00:00
|
|
|
|
|
|
|
)""
|