public/nixpkgs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
nixpkgs/doc/introduction.chapter.md

52 lines
2.6 KiB
Markdown
Raw Normal View History

DOC: Overview of Nixpkgs/channels/Hydra/tests (close #11263) What I missed when I began using Nix and NixOS was a clear overview of how packages, channels, Hydra, the master branch and updates to channels relate to each other. I've noticed I am not the only one, given the amount of times these questions pop up. For now I propose to include this in the Nixpkgs manual, since this seems to be the best fit. However, I think it would be good to include this in either a new manual, i.e., a user manual, or an 'official' tutorial.
2015-11-25 17:13:44 +01:00
---
title: Introduction
author: Frederik Rietdijk
date: 2015-11-25
---
# Introduction
nixpkgs manual introduction: improve - make line wrapping more consistent (overlong lines) - don't stress the manual is *only* for contributors, as it does contain some user-guide parts, including the intro itself - since March our Hydra publishes binaries immediately, not waiting for channel update
2016-04-05 09:56:32 +02:00
The Nix Packages collection (Nixpkgs) is a set of thousands of packages for the
[Nix package manager](http://nixos.org/nix/), released under a
[permissive MIT/X11 license](https://github.com/NixOS/nixpkgs/blob/master/COPYING).
Packages are available for several platforms, and can be used with the Nix
package manager on most GNU/Linux distributions as well as NixOS.
This manual primarily describes how to write packages for the Nix Packages collection
(Nixpkgs). Thus it’s mainly for packagers and developers who want to add packages to
DOC: Overview of Nixpkgs/channels/Hydra/tests (close #11263) What I missed when I began using Nix and NixOS was a clear overview of how packages, channels, Hydra, the master branch and updates to channels relate to each other. I've noticed I am not the only one, given the amount of times these questions pop up. For now I propose to include this in the Nixpkgs manual, since this seems to be the best fit. However, I think it would be good to include this in either a new manual, i.e., a user manual, or an 'official' tutorial.
2015-11-25 17:13:44 +01:00
Nixpkgs. If you like to learn more about the Nix package manager and the Nix
expression language, then you are kindly referred to the [Nix manual](http://nixos.org/nix/manual/).
## Overview of Nixpkgs
Nix expressions describe how to build packages from source and are collected in
the [nixpkgs repository](https://github.com/NixOS/nixpkgs). Also included in the
nixpkgs manual introduction: improve - make line wrapping more consistent (overlong lines) - don't stress the manual is *only* for contributors, as it does contain some user-guide parts, including the intro itself - since March our Hydra publishes binaries immediately, not waiting for channel update
2016-04-05 09:56:32 +02:00
collection are Nix expressions for
[NixOS modules](http://nixos.org/nixos/manual/index.html#sec-writing-modules).
With these expressions the Nix package manager can build binary packages.
DOC: Overview of Nixpkgs/channels/Hydra/tests (close #11263) What I missed when I began using Nix and NixOS was a clear overview of how packages, channels, Hydra, the master branch and updates to channels relate to each other. I've noticed I am not the only one, given the amount of times these questions pop up. For now I propose to include this in the Nixpkgs manual, since this seems to be the best fit. However, I think it would be good to include this in either a new manual, i.e., a user manual, or an 'official' tutorial.
2015-11-25 17:13:44 +01:00
Packages, including the Nix packages collection, are distributed through
[channels](http://nixos.org/nix/manual/#sec-channels). The collection is
distributed for users of Nix on non-NixOS distributions through the channel
`nixpkgs`. Users of NixOS generally use one of the `nixos-*` channels, e.g.
nixpkgs manual introduction: improve - make line wrapping more consistent (overlong lines) - don't stress the manual is *only* for contributors, as it does contain some user-guide parts, including the intro itself - since March our Hydra publishes binaries immediately, not waiting for channel update
2016-04-05 09:56:32 +02:00
`nixos-16.03`, which includes all packages and modules for the stable NixOS
16.03. The purpose of stable NixOS releases are generally only given
DOC: Overview of Nixpkgs/channels/Hydra/tests (close #11263) What I missed when I began using Nix and NixOS was a clear overview of how packages, channels, Hydra, the master branch and updates to channels relate to each other. I've noticed I am not the only one, given the amount of times these questions pop up. For now I propose to include this in the Nixpkgs manual, since this seems to be the best fit. However, I think it would be good to include this in either a new manual, i.e., a user manual, or an 'official' tutorial.
2015-11-25 17:13:44 +01:00
security updates. More up to date packages and modules are available via the
`nixos-unstable` channel.
Both `nixos-unstable` and `nixpkgs` follow the `master` branch of the Nixpkgs
nixpkgs manual introduction: improve - make line wrapping more consistent (overlong lines) - don't stress the manual is *only* for contributors, as it does contain some user-guide parts, including the intro itself - since March our Hydra publishes binaries immediately, not waiting for channel update
2016-04-05 09:56:32 +02:00
repository, although both do lag the `master` branch by generally
[a couple of days](http://howoldis.herokuapp.com/). Updates to a channel are
distributed as soon as all tests for that channel pass, e.g.
[this table](http://hydra.nixos.org/job/nixpkgs/trunk/unstable#tabs-constituents)
DOC: Overview of Nixpkgs/channels/Hydra/tests (close #11263) What I missed when I began using Nix and NixOS was a clear overview of how packages, channels, Hydra, the master branch and updates to channels relate to each other. I've noticed I am not the only one, given the amount of times these questions pop up. For now I propose to include this in the Nixpkgs manual, since this seems to be the best fit. However, I think it would be good to include this in either a new manual, i.e., a user manual, or an 'official' tutorial.
2015-11-25 17:13:44 +01:00
shows the status of tests for the `nixpkgs` channel.
The tests are conducted by a cluster called [Hydra](http://nixos.org/hydra/),
nixpkgs manual introduction: improve - make line wrapping more consistent (overlong lines) - don't stress the manual is *only* for contributors, as it does contain some user-guide parts, including the intro itself - since March our Hydra publishes binaries immediately, not waiting for channel update
2016-04-05 09:56:32 +02:00
which also builds binary packages from the Nix expressions in Nixpkgs for
`x86_64-linux`, `i686-linux` and `x86_64-darwin`.
The binaries are made available via a [binary cache](https://cache.nixos.org).
DOC: Overview of Nixpkgs/channels/Hydra/tests (close #11263) What I missed when I began using Nix and NixOS was a clear overview of how packages, channels, Hydra, the master branch and updates to channels relate to each other. I've noticed I am not the only one, given the amount of times these questions pop up. For now I propose to include this in the Nixpkgs manual, since this seems to be the best fit. However, I think it would be good to include this in either a new manual, i.e., a user manual, or an 'official' tutorial.
2015-11-25 17:13:44 +01:00
The current Nix expressions of the channels are available in the
[`nixpkgs-channels`](https://github.com/NixOS/nixpkgs-channels) repository,
nixpkgs manual: remove reference to now defunct nixpkgs monitor
2017-10-17 16:04:29 +01:00
which has branches corresponding to the available channels.
Reference in New Issue Copy Permalink