# Differences between Nix channels

**URL:** https://discourse.nixos.org/t/differences-between-nix-channels/13998
**Category:** Help
**Created:** [July 9, 2021, 12:55pm UTC](https://discourse.nixos.org/t/differences-between-nix-channels/13998 "2021-07-09T12:55:52Z")
**Posts on this page:** 1
**Showing post:** 5

<div class="post-metadata">

### Author: ![jtojnar](https://discourse.nixos.org/user_avatar/discourse.nixos.org/jtojnar/32/70_2.png) [@jtojnar](https://discourse.nixos.org/u/jtojnar)
#### Post date: [June 3, 2023, 2:50pm UTC](https://discourse.nixos.org/t/differences-between-nix-channels/13998/5 "2023-06-03T14:50:56Z")

</div>

The site also had this very nice [description of the update process](https://github.com/madjar/howoldis/blob/a0045352b6a6ebfaafc08ed164505ac03a5c7ae2/src/index.hamlet) by @domenkozar, which is why I continued linking it even after it stopped updating. But I guess I can just quote it here:

> ### How does channel update?
> 
> #### 1. Git commit
> 
> Anyone with commit access can push changes to either **master** or one of the **release-XX.XX** branches.
> 
> #### 2. Hydra build
> 
> Each channel has an associated _jobset_ on [Hydra (Nix CI)](http://nixos.org/hydra/) that is a collection of individual _jobs_ . A _job_ roughly corresponds to building a particular package, which itself may depend on other packages built by other _jobs_ .
> 
> Before a channel can update, its associated _jobset_ must be finished building, though the building of some jobs may fail.
> 
> As long as certain special _jobs_ – _unstable_ for nixpkgs, and _tested_ for nixos – build successfully, the channel can update. The role of these special jobs is to ensure that essential functionality is present on each channel update.
> 
> There are two major differences between those jobsets:
> 
> - **nixpkgs-unstable**
> - builds all packages for supported platforms (Linux, Darwin)
> - [unstable](https://github.com/NixOS/nixpkgs/blob/8ebcb96e4ab9f54920396c6e1db6dd4738a902fe/pkgs/top-level/release.nix#L34-L70) job that consists of most commonly used packages
> 
> - **nixos-** \*
> - builds all packages and NixOS machinery only for Linux
> - [tested](https://github.com/NixOS/nixpkgs/blob/8ebcb96e4ab9f54920396c6e1db6dd4738a902fe/nixos/release-combined.nix#L34-L105) job that consists of mostly NixOS tests firing up qemu instances with different kinds of configurations
> 
> #### 3. Channel update
> 
> For a channel to be updated two conditions need to be satisfied:
> 
> - Particular jobset evaluation needs to be completely built ie. no more queued jobs, even if some jobs may fail
> - Particular jobset evaluation’s **tested/unstable** job needs to be built succesfully
> 
> The [nixos.org](http://nixos.org) server has a cronjob for which [nixos-channel-scripts](https://github.com/NixOS/nixos-channel-scripts) are executed and poll for the newest jobset that satisfies the above two conditions and trigger a channel update.
> 
> Once triggered, release files such as ISOs are copied. For the NixOS channel [command-not-found](https://github.com/NixOS/nixos-channel-scripts/blob/035a2d539b318b9ecb73ab4eefb2a7de93aed158/generate-programs-index.cc) index is generated, which can take some time since it has to fetch all packages.
> 
> **nixpkgs** is quickly updated since none of the above needs to happen once a channel update is triggered.

Some details are no longer true (e.g. the `command-not-found` tooling has been [replaced by `nix-index`](https://github.com/NixOS/nixos-channel-scripts/commit/8656f3e07f1d45404f92888ca118544eae999cbf)) but I believe it is still mostly correct.

---

_[View the full topic](https://discourse.nixos.org/t/differences-between-nix-channels/13998)._
