NixOS Wiki: Difference between revisions

Latest revision as of 18:27, 7 March 2026

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.

Many great additional tools exist 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

2025-11-30 — NixOS 25.11 released

Release Notes: https://nixos.org/blog/announcements/2025/nixos-2511/

2025-05-23 — NixOS 25.05 released

Release Notes: https://nixos.org/blog/announcements/2025/nixos-2505/

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: @@
+<languages/>
+<span style="height: 4px;"></span>
+__NOTOC__
+<!-- NOTE: Please don't change the layout/categorizing without first coordinating with the other editors. -->
+<!-- NOTE: Feel free to add/edit content though! -->
+<!-- NOTE: This page is affected by special CSS rules that alter the brightness of images in dark mode.
+     Please do not add images here unless you understand the rules in MediaWiki:Common.css and have
+     tested how this page looks in both light and dark mode. -->
+<!-- NOTE: Removing those notes and/or disregarding this is not only rude, but should be considered defacement. -->
+<div class="row home-panes">
+    <div class="col-md-7">
+{{home:box|get-started|icon=clarifications|2=<translate><!--T:15--> Getting started</translate>|3=
+<translate>
+<!--T:14-->
+This is the official NixOS Wiki.
+It includes topics not covered in the [<tvar name=1>https://nixos.org/nixos/manual</tvar> NixOS Manual]: NixOS user guides, configuration examples, and troubleshooting tips.
-== Welcome to the '''unofficial''' NixOS Wiki! ==
+<!--T:2-->
+NixOS is a [<tvar name=1>https://kernel.org/</tvar> Linux] operating system based on the Nix package manager and the Nixpkgs package repository.
-Take a look at [[NixOS_Wiki:About]]
+<!--T:3-->
+Newcomers to NixOS are encouraged to read the [[<tvar name=0>Special:MyLanguage/Nix Ecosystem</tvar>|Nix Core Ecosystem]] overview article to get a comprehensive orientation. For more specific introductions, see:
+* [[<tvar name=1>Special:MyLanguage/Overview_of_the_NixOS_Linux_distribution</tvar>|NixOS]]
+* [[<tvar name=2>Special:MyLanguage/Nix package manager</tvar>|Nix package manager]]
+* [[<tvar name=3>Special:MyLanguage/Nixpkgs</tvar>|Nixpkgs package repository]]
+* [[<tvar name=4>Special:MyLanguage/Overview of the Nix Language</tvar>|Nix Language]]
+If you want to try Nix standalone in another Linux distribution or on a Mac, take your first steps on [<tvar name=5>https://nix.dev</tvar> nix.dev].
+<!--T:4-->
+Many great additional tools exist in the Nix ecosystem, such as:
-<strong>We are still in the process of setting up the wiki.</strong>
+<!--T:12-->
+* [[<tvar name=1>Special:MyLanguage/Home Manager</tvar>|Home Manager]], a system for managing user profile & home directory contents
+* [[<tvar name=2>Special:MyLanguage/Flakes</tvar>|Nix Flakes]], an experimental feature for managing dependencies of Nix projects
-Expect breaking changes until this message is removed.
+<!--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.
+</translate>}}
-== Getting started with Nix / NixOS ==
+{{home:box|hosting|icon=cloud|<translate><!--T:16--> Setting up NixOS</translate>|<!-- once ready: * On your computer, with [[NixOS Installation Guide]] -->
-* Nix [http://nixos.org/nix/manual/ manual]
+<translate>
-* NixOS [http://nixos.org/nixos/manual/ manual]
+<!--T:5-->
-* Nixpkgs [http://nixos.org/nixpkgs/manual/ manual]
+* On desktop, with [[<tvar name=1>Special:MyLanguage/NixOS as a desktop</tvar>|NixOS as a desktop]]
-* NixOps [http://hydra.nixos.org/job/nixops/master/tarball/latest/download-by-type/doc/manual manual]
+* On ARM, with [[<tvar name=2>Special:MyLanguage/NixOS on ARM</tvar>|NixOS on ARM]]
-* NixOS [[Cheatsheet]]
+* In the cloud, with [[<tvar name=3>Special:MyLanguage/NixOS friendly hosters</tvar>|NixOS friendly hosters]]
+</translate>}}
-=== Why Nix and NixOS ===
+{{home:box|doctopics|icon=manual|2=<translate><!--T:17--> Documentation topics</translate>|3=
-* [[FAQ]]
+<translate>
-* [[Nixpkgs vs other packagers]]
+<!--T:6-->
-* [[Cheatsheet|the differences between Ubuntu and NixOS]]
+First stop should be [[<tvar name=1>Special:MyLanguage/Resources</tvar>|Resources]], which serves as a gateway to the most important documentation. Some highlights below.
-== Our [http://nixos.org/nixos/community.html community] ==
+<!--T:7-->
-* Mailing list: [https://groups.google.com/forum/#!forum/nix-devel nix-devel]
+Primary reference material:
-* IRC: [irc://irc.freenode.net/nixos #nixos] on freenode
+* [https://nixos.org/nixos/manual/ NixOS manual]
-* Bugtracker: [https://github.com/NixOS/nixpkgs/issues Nixpkgs]
+* [https://nixos.org/nix/manual/ Nix manual]
-* See also [[Get Involved]]
+* [https://nixos.org/nixpkgs/manual/ Nixpkgs manual]
+* [https://nixos.org/hydra/manual/ Hydra manual]
-== Hosting Providers ==
+<!--T:8-->
-* [[NixOS friendly hosters]]
+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
-== Tutorials ==
+<!--T:9-->
-* [[NixOS on ZFS]]
+See also:
+* [[<tvar name=1>Special:MyLanguage/FAQ</tvar>|FAQ]]
+* [[<tvar name=2>Special:MyLanguage/Nix vs. Linux Standard Base</tvar>|Nix vs. Linux Standard Base]]
+* [[<tvar name=3>Special:MyLanguage/Terms and Definitions in Nix Project</tvar>|Terms and Definitions in Nix Project]]
+* [[<tvar name=4>Special:MyLanguage/Cheatsheet</tvar>|Cheatsheet]]
+* [[<tvar name=5>Special:MyLanguage/Ubuntu vs. NixOS</tvar>|Comparison between Ubuntu and NixOS]]
+</translate>}}
-== News ==
+{{home:box|wikipages|2=<translate><!--T:18--> Special pages</translate>|3=
-* 2017-06-28: Login via GitHub has been enabled
+<ul>
-** We are still working out some kinks. If you encounter any errors please contact [[User:Fadenb]]
+<li><span class="plainlinks"><translate><!--T:10--> [{{fullurl:Special:SpecialPages}} Overview of special pages]</translate></span></li>
-* 2017-08-21: More content
+<li><span class="plainlinks"><translate><!--T:19--> [{{fullurl:Special:AllPages|hideredirects=1}} All pages of {{SERVERNAME}}]</translate></span></li>
-** The content of [https://github.com/nixos-users/wiki/wiki nixos-users' wiki] is already integrated
+<li><translate><!--T:20--> [[Special:Categories|All categories of {{SERVERNAME}}]]</translate></li>
+<li><translate><!--T:21--> [{{fullurl:Special:RecentChanges|hidebots=1&reviewStatus=unpatrolled}} Unpatrolled changes of {{SERVERNAME}}]</translate></li>
+</ul>}}
+    </div>
+    <div class="col-md-5">
-== All nixos.wiki Pages ==
+{{home:box|get-in-touch|icon=dialog-hi|2=<translate><!--T:22--> Get in touch</translate>|3=
-[[Special:AllPages]]
+<translate>
+<!--T:23-->
+<b>With the community</b>
+* [<tvar name=1>https://nixos.org/</tvar> Official NixOS website]
+* [<tvar name=2>https://nixos.org/community/#governance-teams</tvar> Official Teams]
+* [[<tvar name=3>Special:MyLanguage/Nix Community</tvar>|Community overview]]
+* [[<tvar name=4>Special:MyLanguage/Get In Touch</tvar>|Chats and forums]]
+* [[<tvar name=5>Special:MyLanguage/Support</tvar>|Get support]]
+* [[<tvar name=6>Special:MyLanguage/Get In Touch#Events</tvar>|Events]]
+<!--T:11-->
+<b>About the Wiki</b>
+* Matrix chat for Wiki contributors [https://matrix.to/#/#wiki:nixos.org #wiki:nixos.org]
+* Email [mailto:wiki@nixos.org wiki@nixos.org] for contacting wiki.nixos.org regarding any wiki operational topics or requests
+* [[<tvar name=1>Special:MyLanguage/Contributing</tvar>|Contribute to wiki and NixOS]]
+* [[<tvar name=2>Special:MyLanguage/Manual of Style</tvar>|Manual of Style]]
+* [[<tvar name=3>Special:MyLanguage/Official_NixOS_Wiki:History</tvar>|History of NixOS Wikis]]
+</translate>}}
+{{home:box|news|2=<translate><!--T:24--> News</translate>|3=
+{{Official NixOS_Wiki:News}}
+<translate>
+<!--T:25-->
+[[Official NixOS_Wiki:News{{!}}... all news articles &rarr;]]
+</translate>}}
+    </div>
+</div>