Resources: Difference between revisions

Latest revision as of 06:48, 14 September 2024

Note: Reference documentation and learning materials for using Nix standalone are maintained at nix.dev.

This article is an overview of resources available both within the NixOS Wiki and elsewhere. For communication channels, support and information of contributing, see the community menu.

Wiki - search by topic

While most people just search for the article they want to read, there is also a way to reach almost all arcticles via 2 to 3 clicks from the starting page via the main 5 topic categories:

Software
Hardware
Desktop - how to setup PCs
Server - how to setup servers
Community - people, communication, work on NixOS

Wiki - search by article type

The NixOS Wiki's core articles are divided into five type categories. Each category link will list all pages in that category:

Pedias, for encyclopedic description
Guides, for broad hands-on understanding and connections to other learning resources
Tutorials, intended to teach a particular process or project
Cookbooks, collections of tips and tricks
Reference, full manuals and technical coverage

Pages are also organized by the six most prominent components of the Nix Ecosystem — NixOS, Nix: the package manager, Nix: the language (Nix Expressions), Nixpkgs, NixOps and Hydra.

NixOS Wiki Resources
Category	NixOS	Nix	Nix Expressions	Nixpkgs	NixOps	Hydra
Pedia	NixOS	Nix	Nix Expression Language	Nixpkgs	NixOps	Hydra
Cookbook	NixOS Cheatsheet	Nix Cookbook	Nix Language: Tips & Tricks
NixOS Official Resources
Category	NixOS	Nix	Nix Expressions	Nixpkgs	NixOps	Hydra
Reference	NixOS Manual	Nix Manual	Nix Manual: Writing Nix Expressions	Nixpkgs Manual	Nixops Manual	Hydra Manual

Note: Home Manager is also a major community project to make user environment management in NixOS easier. It is intended to replace much of what you would do with nix-env, to reduce hard-to-track imperative actions.
Official Home Manager manual

Also, see Applications for an overview of tools in the extended ecosystem.

News

planet.nixos.org - Aggregator for blogs related to nix/nixOS
NixOS Discourse - Official forum
nixpkgs.news

Interactive websites

NixOS Packages Search - full-text search through all packages of NixOS
NixOS Option Search - full-text search through all options of NixOS
Noogle - Nix API search engine that lets you search nix functions
A tour of nix - interactive Nix tutorial
Nix Channel Status - when nixpkgs/nixos channels were updated last
Hydra
Nix Review Tools Reports - reports showing problematic dependencies for major Hydra jobsets

Tutorials

How to learn Nix - A set of over 40 posts from 2021, looking at — as the author describes — not just what Nix does, but what it does. It is their notes from reading the manual, doing experiments, and trying to deeply understand Nix.
Tutorial Introduction to Nix - An introduction focused on the use of shell environments, for Python and with links to R versions as well
Interactive Tour of Nix - An interactive tutorial of the Nix Expression Language by Joachim Schiele and Paul Seitz
Nix shell workshop
Scrive workshop - Nix language and packaging workshop
ZFS NAS
NixOS & Flakes Book - An unofficial book for beginners - A beginner friendly tutorial about NixOS and Flakes. By Ryan Yin
NixOS in Production - A NixOS handbook for professional use. By Gabriella Gonzalez

Video tutorials

Wil T Nix Guides - A video series in 8 parts, covering the Nix ecosystem from foundations, providing orientation with all available resources, and showing hands on how to get NixOS installed and running (including managing all your configuration through git and using Flakes).
Nix Friday - a series of 24 video streams of 1-2 hours on learning Nix and meeting community members
The Nix Hour - A weekly beginner-oriented improvised QA-style lecture on Nix
Vimjoyer's Nix Tutorials - A regularly released tutorial series about configuring things with Nix.
NixOS Config Guides for Nerds and Other Cool People - A tutorial series geared towards people that have some Linux command line experience.
Nixology - A tutorial series by Burke Libbey, originally released internally at Shopify
Informal intro to the Nix language, derivations and nixpkgs - A thorough introduction to the Nix language
EmergentMind's Nix Tutorials - A tutorial series for Nix configuration and secrets management

Examples

Talks

NixCon

NixCon 2023 Talks
NixCon 2022 Talks
NixCon 2020 Talks
NixCon 2019 Talks
NixCon 2018 Talks
NixCon 2017 Talks
NixCon 2015 Talks produced and hosted by the CCC Video Operation Center

Other

@@ Line 1: / Line 1: @@
-== Documentation ==
+{{Note|Reference documentation and learning materials for using Nix standalone are maintained at [https://nix.dev/ nix.dev].}}
-* [https://nixos.org/nixos/nix-pills/index.html Nix Pills] - series of blog post about Nix/Nixpkgs internals
+This article is an overview of resources available both within the NixOS Wiki and elsewhere. For communication channels, support and information of contributing, see the community menu.
-* [https://nixos.org/nix/manual/ Official nix Manual]
-* [https://nixos.org/nixos/manual/ Official NixOS Manual]
-* [https://nixos.org/nixpkgs/manual/ Official Nixpkgs Manual]
-== News ==
+=== Wiki - search by topic ===
+While most people just search for the article they want to read, there is also a way to reach almost all arcticles via 2 to 3 clicks from the starting page via the main 5 topic categories:
+# [[:{{ns:14}}:Software|Software]]
+# [[:{{ns:14}}:Hardware|Hardware]]
+# [[:{{ns:14}}:Desktop|Desktop]] - how to setup PCs
+# [[:{{ns:14}}:Server|Server]] - how to setup servers
+# [[:{{ns:14}}:Community|Community]] - people, communication, work on NixOS
+=== Wiki - search by article type ===
+The NixOS Wiki's core articles are divided into [[:Category:Resource|five type categories]]. Each category link will list all pages in that category:
+# [[:Category:Pedias|Pedias]], for encyclopedic description
+# [[:Category:Guide|Guides]], for broad hands-on understanding and connections to other learning resources
+# [[:Category:Tutorial|Tutorials]], intended to teach a particular process or project
+# [[:Category:Cookbook|Cookbooks]], collections of tips and tricks
+# [[:Category:Reference|Reference]], full manuals and technical coverage
+Pages are also organized by the six most prominent components of the [[Nix Ecosystem]] &mdash; NixOS, [[Nix package manager | Nix: the package manager]], [[Nix Expression Language | Nix: the language (Nix Expressions)]], Nixpkgs, NixOps and Hydra.
+{| class="wikitable table" style="text-align: left; width: 100%"
+! NixOS Wiki Resources
+|-
+! Category
+! [[:Category:NixOS|NixOS]]
+! [[:Category:Nix|Nix]]
+! [[:Category:Nix Language|Nix Expressions]]
+! [[:Category:Nixpkgs|Nixpkgs]]
+! [[:Category:NixOps|NixOps]]
+! Hydra
+|-
+! [[:Category:Pedias|Pedia]]
+| [[NixOS]]
+| [[Nix package manager | Nix]]
+| [[Nix Expression Language]]
+| [[Nixpkgs]]
+| [[NixOps]]
+| [[Hydra]]
+|-
+! [[:Category:Cookbook|Cookbook]]
+| [[Cheatsheet|NixOS Cheatsheet]]
+| [[Nix Cookbook]]
+| [[Nix Language: Tips & Tricks]]
+| <!-- [[Nixpkgs Cookbook]] -->
+| <!-- [[NixOps Cookbook]] -->
+| <!-- [[Hydra Cookbook]] -->
+|-
+|-
+! NixOS Official Resources
+|-
+! Category
+! NixOS
+! Nix
+! Nix Expressions
+! Nixpkgs
+! NixOps
+! Hydra
+|-
+! [[:Category:Reference|Reference]]
+| [https://nixos.org/nixos/manual/ NixOS Manual]
+| [https://nixos.org/nix/manual/ Nix Manual]
+| [https://nixos.org/nix/manual/#chap-writing-nix-expressions Nix Manual:<br>Writing Nix Expressions]
+| [https://nixos.org/manual/nixpkgs/stable/ Nixpkgs Manual]
+| [https://nixops.readthedocs.io/en/latest/release-notes/index.html Nixops Manual]
+| [https://nixos.org/hydra/manual/ Hydra Manual]
+|}
+{{Note| [[Home Manager]] is also a major community project to make user environment management in NixOS easier. It is intended to replace much of what you would do with ''nix-env'', to reduce hard-to-track [https://en.wikipedia.org/wiki/Imperative_programming imperative] actions.<br>[https://nix-community.github.io/home-manager/ Official Home Manager manual]}}
+Also, see [[Applications]] for an overview of tools in the extended ecosystem.
+=== More documentation ===
+* [https://github.com/nix-community/awesome-nix awesome-nix] - community-curated list of Nix learning resources and tools
+=== News ===
 * [http://planet.nixos.org/ planet.nixos.org] - Aggregator for blogs related to nix/nixOS
-* [http://weekly.nixos.org/ NixOS Weekly]
+* [https://discourse.nixos.org/ NixOS Discourse] - Official forum
-* [https://mailman.science.uu.nl/pipermail/nix-dev/ nix-dev mailing list]
+* [https://nixpkgs.news nixpkgs.news]
-== Interactive Websites ==
+=== Interactive websites ===
-* [https://nixos.org/nixos/packages.html NixOS Packages Search] - full-text search through all packages of NixOS
+* [https://search.nixos.org/packages NixOS Packages Search] - full-text search through all packages of NixOS
-* [https://nixos.org/nixos/options.html NixOS Option Search] - full-text search through all options of NixOS
+* [https://search.nixos.org/options NixOS Option Search] - full-text search through all options of NixOS
-* [https://search.nix.gsc.io/ NixOS Code Search] - full-text search through NixOS related packages
+* [https://noogle.dev/ Noogle] - Nix API search engine that lets you search nix functions
 * [https://nixcloud.io/tour/?id=1 A tour of nix] - interactive Nix tutorial
-* [http://howoldis.herokuapp.com/ How old is ...] - when have the nixos-channels last updated
+* [https://status.nixos.org/ Nix Channel Status] - when nixpkgs/nixos channels were updated last
 * [https://hydra.nixos.org/ Hydra]
+* [https://malob.github.io/nix-review-tools-reports/ Nix Review Tools Reports] - reports showing problematic dependencies for major Hydra jobsets
-== Tutorials ==
+=== Tutorials ===
-* [https://nixcloud.io/tour Interactive Tour of Nix] - an interactive tutorial of the Nix Expression Language by Joachim Schiele and Paul Seitz
+* [https://ianthehenry.com/posts/how-to-learn-nix/ How to learn Nix] - A set of over 40 posts from 2021, looking at &mdash; as the author describes &mdash; not just what Nix does, but what it '''''does'''''. It is their notes from reading the manual, doing experiments, and trying to deeply understand Nix.
+* [https://rgoswami.me/posts/ccon-tut-nix/ Tutorial Introduction to Nix] - An introduction focused on the use of shell environments, for Python and with links to R versions as well
+* [https://nixcloud.io/tour Interactive Tour of Nix] - An interactive tutorial of the Nix Expression Language by Joachim Schiele and Paul Seitz
 * [https://github.com/nixcloud/nix-shell-workshop Nix shell workshop]
+* [https://scrive.github.io/nix-workshop/ Scrive workshop ] - Nix language and packaging workshop
+* [https://danielunderwood.dev/post/nixos-nas/ ZFS NAS]
+* [https://nixos-and-flakes.thiscute.world/ NixOS & Flakes Book - An unofficial book for beginners] - A beginner friendly tutorial about NixOS and Flakes. By Ryan Yin
+* [https://leanpub.com/nixos-in-production NixOS in Production] - A NixOS handbook for professional use. By Gabriella Gonzalez
+==== Video tutorials ====
+* [[Wil T Nix Guides]] - A video series in 8 parts, covering the Nix ecosystem from foundations, providing orientation with all available resources, and showing hands on how to get NixOS installed and running (including managing all your configuration through git and using Flakes).
+* [https://www.youtube.com/playlist?list=PLuVXx3vBwgelE9hbg5lH4w-JFU7llOqtI Nix Friday] - a series of 24 video streams of 1-2 hours on learning Nix and meeting community members
+* [https://www.youtube.com/playlist?list=PLyzwHTVJlRc8yjlx4VR4LU5A5O44og9in The Nix Hour] - A weekly beginner-oriented improvised QA-style lecture on Nix
+* [https://www.youtube.com/playlist?list=PLko9chwSoP-15ZtZxu64k_CuTzXrFpxPE Vimjoyer's Nix Tutorials] - A regularly released tutorial series about configuring things with Nix.
+* [https://www.youtube.com/playlist?list=PL_WcXIXdDWWpuypAEKzZF2b5PijTluxRG NixOS Config Guides for Nerds and Other Cool People] - A tutorial series geared towards people that have some Linux command line experience.
+* [https://www.youtube.com/playlist?list=PLRGI9KQ3_HP_OFRG6R-p4iFgMSK1t5BHs Nixology] - A tutorial series by Burke Libbey, originally released internally at Shopify
+* [https://youtu.be/9DJtHIpdp0Y Informal intro to the Nix language, derivations and nixpkgs] - A thorough introduction to the Nix language
+* [https://m.youtube.com/playlist?list=PLAWyx2BxU4OyERRTbzNAaRHK08DQ0DD_l EmergentMind's Nix Tutorials] - A tutorial series for Nix configuration and secrets management
-== Cookbooks ==
+=== Examples ===
+* [[Configuration Collection]]
+* [[Comparison of NixOS setups]]
-* [http://nix-cookbook.readthedocs.io Domen's Nix Cookbook] - A community initiative, by Domen Kožar
+=== Talks ===
-* [http://funops.co/nix-cookbook/ Susan's Nix cookbook] - a concise cookbook with comparisons to more familiar tools and commands, by Susan Potter
-== Talks ==
+==== NixCon ====
-* [https://media.ccc.de/c/nixcon2015 Nixcon 2015 Talks] produced and hosted by the CCC Video Operation Center
+*[https://media.ccc.de/c/nixcon2023 NixCon 2023 Talks]
+* [https://www.youtube.com/playlist?list=PLgknCdxP89ReD6gxl755B6G_CI65z4J2e NixCon 2022 Talks]
+* [https://www.youtube.com/playlist?list=PLgknCdxP89RcXpf7xLU7tuWXTOsL1rSHU NixCon 2020 Talks]
+* [https://www.youtube.com/playlist?list=PLgknCdxP89Re9oFsLnAb5iLO0XG_rMuAo NixCon 2019 Talks]
+* [https://www.youtube.com/playlist?list=PLgknCdxP89ReJKWX3sthcsbBYsoihzSQX NixCon 2018 Talks]
+* [https://www.youtube.com/playlist?list=PLgknCdxP89ReQzhfKwMYjLdwWsc7us8ns&index=1 NixCon 2017 Talks]
+* [https://media.ccc.de/c/nixcon2015 NixCon 2015 Talks] produced and hosted by the CCC Video Operation Center
-== Wiki ==
+==== Other ====
+* [https://fosdem.org/2024/schedule/track/nix-devroom/ FOSDEM 2024 - Nix and NixOS devroom]
+* [https://www.youtube.com/playlist?list=PLt4-_lkyRrOPcBuz_tjm6ZQb-6rJjU3cf Summer of Nix 2023 Talks]
+* [https://archive.fosdem.org/2023/schedule/track/nix_and_nixos/ FOSDEM 2023 - Nix and NixOS devroom]
+* [https://www.youtube.com/playlist?list=PLt4-_lkyRrOMWyp5G-m_d1wtTcbBaOxZk Summer of Nix 2022 Talks]
-Wiki resources are organized by a grid:
-{|  class="wikitable"
-|+ NixOS Wiki Resources
-|-
-|
-| NixOS
-| Nix
-| Nix Language
-| Nixpkgs
-| NixOps
-| Hydra
-|-
-| [[:Category:Discussion]]
-| [[NixOS]]
-| [[Nix Package Manager]]
-| [[Nix Language]]
-| [[Nixpkgs]]
-| [[NixOps]]
-| []Hydra]]
-|-
-| [[:Category:Guide]]
-| [[NixOS User Guide]]
-| [[Nix User Guide]]
-| [[Nix Language User Guide]]
-| [[Nixpkgs User Guide]]
-| [[NixOps User Guide]]
-| [[Hydra User Guide]]
-|-
-| [[:Category:Tutorial]]
-| [[NixOS Tutorial]]
-| [[Nix Tutorial]]
-| [[Nix Language Tutorial]]
-| [[Nixpkgs Tutorial]]
-| [[NixOps Tutorial]]
-| [[Hydra Tutorial]]
-|-
-| [[:Category:Cookbook]]
-| [[NixOS Cookbook]]
-| [[Nix Cookbook]]
-| [[Nix Language Cookbook]]
-| [[Nixpkgs Cookbook]]
-| [[NixOps Cookbook]]
-| [[Hydra Cookbook]]
-|}
-[[Category:Reference]]
+[[Category:Guide]]