NixOS Wiki: Difference between revisions

Revision as of 19:36, 30 December 2024

Getting started

This is the official NixOS Wiki. It includes topics not covered in the NixOS Manual: NixOS user guides, configuration examples, and troubleshooting tips.

NixOS is a Linux operating system based on the Nix package manager and the Nixpkgs package repository.

Newcomers to NixOS are encouraged to read the Nix Core Ecosystem overview article to get a comprehensive orientation. For more specific introductions, see:

If you want to try Nix standalone in another Linux distribution or on a Mac, take your first steps on nix.dev.

Much great additional tooling exists in the Nix ecosystem such as:

Home Manager, a system for managing user profile & home directory contents
Nix Flakes, an experimental feature for managing dependencies of Nix projects

These add complexity and may be confusing at first, and you may even decide that you don't need them. Start with plain Nix/NixOS, and only integrate Home Manager and/or Flakes into your setup once you're confident with Nix/NixOS and comprehend their significance.

Setting up NixOS

On desktop, with NixOS as a desktop
On ARM, with NixOS on ARM
In the cloud, with NixOS friendly hosters

Documentation topics

First stop should be Resources, which serves as a gateway to the most important documentation. Some highlights below.

Primary reference material:

Major page categories:

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

2024-09-02 — Wiki editors use Manual of Style

The Wiki team discussed and put into effect the Manual of Style for editing wiki articles. This is a huge step towards clear and consistent documentation. All editors are encouraged to follow this guide.

2024-08-22 — Wiki editors meeting

All interested wiki editors meet on 22th of August at 21:15 CEST in a Jitsi conference.

Agenda: https://pad.lassul.us/wiki-agenda?view

2024-07-05 — Wiki editors meeting

All interested wiki editors meet on 5th of July at 13:00 CEST in a Jitsi conference.

2024-04-01 — Launch of the wiki

The official NixOS wiki has taken off! If you want to find out why there is a new wiki effort, check out the FAQ.

... all news articles →

@@ Line 1: / Line 1: @@
-__NOTOC__{{#tweekihide:sidebar-right}}{{#tweekihide:firstHeading}}
+<languages/>
-<div class="nixos-wiki-jumbotron">
+<translate>
-    <div class="row">
+<!--T:1-->
-	<div class="col-lg-3 col-md-4">
+__NOTOC__
-	    <p style="text-align: center; padding-top: 1em;">[[File:home-nixos-logo.png|207px|link=|class=jumbotron-logo]]</p>
+<!-- NOTE: Please don't change the layout/categorizing without first coordinating with the other editors. -->
-	</div>
+<!-- NOTE: Feel free to add/edit content though! -->
-	<div class="col-lg-9 col-md-8">
+<!-- NOTE: Removing those notes and/or disregarding this is not only rude, but should be considered defacement. -->
-	    <h1 style="font-size: 4rem;">NixOS Wiki</h1>
-	    <p class="lead" style="font-size:3rem; margin-bottom: 1rem;">Welcome to the '''unofficial''' user's wiki</p>
-	    <p class="lead">
-	    This wiki is user-maintained. Take a look at [[{{ns:4}}:About|the about page]] for more information.
-	    </p>
-	</div>
-    </div>
-</div>
-<hr />
 <div class="row home-panes">
      <div class="col-md-7">
 {{home:box|get-started|icon=clarifications|Getting started|
-Newcomers are encouraged to read the [[Nix Ecosystem|Nix Ecosystem]] and [[Resources|Resources]] overview articles to get a comprehensive orientation. For more specific introductions, see:
+This is the official NixOS Wiki.
-* [[NixOS]]
+It includes topics not covered in the [https://nixos.org/nixos/manual NixOS Manual]: NixOS user guides, configuration examples, and troubleshooting tips.
-* [[Nix Package Manager | Nix]]
-* [[Nix Expression Language | Nix Language]]
+<!--T:2-->
-* [[Nixpkgs]]
+NixOS is a Linux operating system based on the Nix package manager and the Nixpkgs package repository.
-* [[NixOps]]
-* [[Hydra]]
+<!--T:3-->
-* [[Applications|Applications / Extended Nix Ecosystem]]
+Newcomers to NixOS are encouraged to read the [[Nix Ecosystem|Nix Core Ecosystem]] overview article to get a comprehensive orientation. For more specific introductions, see:
-Or for more extensive reference, check out:
+* [[Overview_of_the_NixOS_Linux_distribution|NixOS]]
-* [https://nixos.org/nixos/manual/ NixOS manual]
+* [[Nix package manager]]
-* [https://nixos.org/nix/manual/ Nix manual]
+* [[Nixpkgs|Nixpkgs package repository]]
-* [https://nixos.org/nixos/nix-pills/ Nix Pills]
+* [[Overview of the Nix Language |Nix Language]]
-* [https://nixos.org/nixpkgs/manual/ Nixpkgs manual]
+If you want to try Nix standalone in another Linux distribution or on a Mac, take your first steps on [https://nix.dev nix.dev].
-* [https://nixos.org/nixops/manual/ NixOps manual]
-* [https://nixos.org/hydra/manual/ Hydra manual]
+<!--T:4-->
-''See also:''
+Much great additional tooling exists in the Nix ecosystem such as:
-* [[FAQ]]
-* [[Nixpkgs vs other packagers]]
+<!--T:12-->
-* [[Cheatsheet|Comparison between Ubuntu and NixOS]]
+* [[Home Manager|Home Manager]], a system for managing user profile & home directory contents
-}}
+* [[Flakes|Nix Flakes]], an experimental feature for managing dependencies of Nix projects
+<!--T:13-->
+These add complexity and may be confusing at first, and you may even decide that you don't need them.
+Start with plain Nix/NixOS, and only integrate Home Manager and/or Flakes into your setup once you're confident with Nix/NixOS and comprehend their significance.}}
+<!--T:5-->
 {{home:box|hosting|icon=cloud|Setting up NixOS|
 <!-- once ready: * On your computer, with [[NixOS Installation Guide]] -->
+* On desktop, with [[NixOS as a desktop]]
 * On ARM, with [[NixOS on ARM]]
 * In the cloud, with [[NixOS friendly hosters]]
 }}
+<!--T:6-->
 {{home:box|doctopics|icon=manual|Documentation topics|
-* [[:Category:Software|Software]]
+First stop should be [[Resources]], which serves as a gateway to the most important documentation. Some highlights below.
-* [[:Category:Hardware|Hardware]]
-* [[:Category:Desktop|Desktop]]
+<!--T:7-->
+Primary reference material:
+* [https://nixos.org/nixos/manual/ NixOS manual]
+* [https://nixos.org/nix/manual/ Nix manual]
+* [https://nixos.org/nixpkgs/manual/ Nixpkgs manual]
+* [https://nixos.org/hydra/manual/ Hydra manual]
+<!--T:8-->
+Major page 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
+<!--T:9-->
+See also:
+* [[FAQ]]
+* [[Nix vs. Linux Standard Base]]
+* [[Terms and Definitions in Nix Project]]
+* [[Cheatsheet]]
+* [[Ubuntu vs. NixOS|Comparison between Ubuntu and NixOS]]
 }}
-{{home:box|oldwiki|icon=wiki|Where’s the old wiki?|
+<!--T:10-->
-The old wiki can still be accessed on [https://web.archive.org/web/20160829175233/https://nixos.org/wiki/Main_Page archive.org]. Though badly outdated, it can still be helpful. Don’t hesitate to transfer still valid information into this wiki! We also have a write-up on the [[NixOS_Wiki:History|history of NixOS wikis]].
-}}
 {{home:box|wikipages|Special pages|3=<ul>
+<li><span class="plainlinks">[{{fullurl:Special:SpecialPages}} Overview of special pages]</span></li>
 <li><span class="plainlinks">[{{fullurl:Special:AllPages|hideredirects=1}} All pages of {{SERVERNAME}}]</span></li>
 <li>[[Special:Categories|All categories of {{SERVERNAME}}]]</li>
-<li>[[Special:RecentChanges|Recent changes of {{SERVERNAME}}]]</li>
+<li>[{{fullurl:Special:RecentChanges|hidebots=1&reviewStatus=unpatrolled}} Unpatrolled changes of {{SERVERNAME}}]</li>
 </ul>}}
      </div>
      <div class="col-md-5">
 {{home:box|get-in-touch|icon=dialog-hi|Get in touch|
-*[[Nix Community|Community overview]]
+<b>With the community</b>
-*[[Support|Get support]]
+* [https://nixos.org/ Official NixOS website]
-*[https://nixos.org/ Official Website]
+* [https://nixos.org/community/#governance-teams Official Teams]
-*[https://github.com/NixOS/nixpkgs/ GitHub repository]
+* [[Nix Community|Community overview]]
-* Forums
+* [[Get In Touch|Chats and forums]]
-** [https://discourse.nixos.org/ Discourse]
+* [[Support|Get support]]
-** [https://stackoverflow.com/questions/tagged/nixos+or+nix+or+nixops+or+nixpkgs Stack Overflow]
+* [[Get In Touch#Events|Events]]
-** [https://unix.stackexchange.com/questions/tagged/nixos+or+nix+or+nixops+or+nixpkgs Unix & Linux Stack Exchange]
-** [https://www.reddit.com/r/NixOS/ /r/NixOS]
+<!--T:11-->
-* [[Get_In_Touch#Chat|IRC]]
+<b>About the Wiki</b>
-** Users: [irc://irc.freenode.net/nixos ''#nixos'' on Freenode]
+* Matrix chat for Wiki contributors [https://matrix.to/#/#wiki:nixos.org #wiki:nixos.org]
-** Developers: [irc://irc.freenode.net/nixos-dev ''#nixos-dev'' on Freenode]
+* Email [mailto:wiki@nixos.org wiki@nixos.org] for contacting wiki.nixos.org regarding any wiki operational topics or requests
-** Wiki: [irc://irc.freenode.net/nixos-wiki ''#nixos-wiki'' on Freenode]
+* [[Contributing|Contribute to wiki and NixOS]]
-* [[Get_In_Touch#Events|Events]]
+* [[Manual of Style]]
-* [[Workgroup]]s (“Interest Groups”)
-** [[Workgroup:Container]]
-** [[Workgroup:Router]]
-** [[Workgroup:DataScience]]
 }}
 {{home:box|news|News|{{NixOS_Wiki:News}}
@@ Line 86: / Line 100: @@
      </div>
 </div>
+</translate>