Skip to content

Commit c116a16

Browse files
add info on how to get the commits and channel names to use (#1080)
* added how to find the specfic commit commits or channel names for constructing pin URLs * clarify terms, shorten phrasing Co-authored-by: Ellyse Cedeno <ellyse7777@gmail.com>
1 parent 899a87c commit c116a16

File tree

2 files changed

+21
-4
lines changed

2 files changed

+21
-4
lines changed

source/concepts/faq.md

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,13 @@ See [](flakes-definition).
1818

1919
Nixpkgs and NixOS have both stable and rolling releases.
2020

21+
These releases are distributed in variants called "channel branches":
22+
Git branches used for releases, which are also converted to Nix channels.
23+
24+
:::{tip}
25+
Consult the [`nix-channel`](https://nix.dev/manual/nix/2.22/command-ref/nix-channel) entry in the Nix Reference Manual for more information on channels, and the [Nixpkgs contributing guide](https://github.com/NixOS/nixpkgs/blob/master/CONTRIBUTING.md#branch-conventions) on the Nixpkgs branching strategy.
26+
:::
27+
2128
### Stable
2229

2330
Stable releases receive conservative updates to fix bugs or security vulnerabilities; otherwise package versions are not changed.
@@ -51,10 +58,6 @@ Rolling releases follow [`master`](https://github.com/NixOS/nixpkgs/branches/all
5158

5259
[`*-small`](https://github.com/NixOS/nixpkgs/branches/all?query=-small) channel branches have passed a smaller test suite, which means they are more up-to-date with respect to their base branch, but offer fewer stability guarantees.
5360

54-
:::{tip}
55-
Consult the [`nix-channel`](https://nix.dev/manual/nix/2.22/command-ref/nix-channel) entry in the Nix Reference Manual for more information on channels, and the [Nixpkgs contributing guide](https://github.com/NixOS/nixpkgs/blob/master/CONTRIBUTING.md#branch-conventions) on the Nixpkgs branching strategy.
56-
:::
57-
5861
## Are there any impurities left in sandboxed builds?
5962

6063
Yes. There is:

source/reference/pinning-nixpkgs.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,3 +77,17 @@ Specifying remote Nix expressions, such as the one provided by Nixpkgs, can be d
7777
pkgs = import (fetchTarball "https://github.com/NixOS/nixpkgs/archive/nixos-22.11.tar.gz") {};
7878
in pkgs.stdenv.mkDerivation { ... }
7979
```
80+
81+
## Finding specific commits and releases
82+
83+
[status.nixos.org](https://status.nixos.org/) provides:
84+
85+
- Latest tested commits for each release - use when pinning to specific commits
86+
- List of active release channels - use when tracking latest channel versions
87+
88+
The complete list of channels is available at [nixos.org/channels](https://nixos.org/channels).
89+
90+
:::{tip}
91+
More information on Nixpkgs and NixOS releases: [](channel-branches)
92+
:::
93+

0 commit comments

Comments
 (0)