NixOS Wiki: Difference between revisions

Revision as of 19:39, 9 May 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.

A lot of people use Home manager for managing the contents of their home directory, many use Flakes instead of the NixOS bi-annually release channels. Both add complexity and you may not even need them. Begin with NixOS, and only integrate Home Manager and/or Flakes into your setup once you're confident with 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__
+__NOTOC__<!-- NOTE: Please don't change the layout/categorizing without first coordinating with the other editors. --><!-- NOTE: Feel free to add/edit content though! -->
-{|
+{{Jumbotron}}{{home:box|get-started|icon=clarifications|Getting started|
-|- style="vertical-align:top;"
-|
-{| class="wikitable" style="width:100%;"
-|-
-! style="text-align:left;" |
-= [[{{ns:6}}:home-clarifications.png]] Getting started =
-|-
-|
 This is the official NixOS Wiki.
 It includes topics not covered in the [https://nixos.org/nixos/manual NixOS Manual]: NixOS user guides, configuration examples, and troubleshooting tips.
@@ Line 22: / Line 14: @@
 A lot of people use [[Home manager]] for managing the contents of their home directory, many use [[Flakes]] instead of the NixOS bi-annually release channels. Both add complexity and you may not even need them. Begin with NixOS, and only integrate Home Manager and/or Flakes into your setup once you're confident with NixOS and comprehend their significance.
-|-
+}}
-|}
-{| class="wikitable" style="width:100%;"
+{{home:box|hosting|icon=cloud|Setting up NixOS|
-|-
-! style="text-align:left;" |
-= [[{{ns:6}}:home-cloud.png]] 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]]
-|-
+}}
-|}
-{| class="wikitable" style="width:100%;"
+{{home:box|doctopics|icon=manual|Documentation topics|
-|-
-! style="text-align:left;" |
-= [[{{ns:6}}:home-manual.png]] Documentation topics =
-|-
-|
 First stop should be [[Resources]], which serves as a gateway to the most important documentation. Some highlights below.
@@ Line 62: / Line 44: @@
 * [[Terms and Definitions in Nix Project]]
 * [[Cheatsheet|Cheatsheet / Comparison between Ubuntu and NixOS]]
-|-
+}}
-|}
+    </div>
-|
+    <div class="col-md-5">
-{| class="wikitable" style="width:100%;"
+{{home:box|get-in-touch|icon=dialog-hi|Get in touch|
-|-
-! style="text-align:left;" |
-= [[{{ns:6}}:home-dialog-hi.png]] Get in touch =
-|-
-|
 * [https://nixos.org/ Official NixOS website]
 * [[Nix Community|Community overview]]
@@ Line 81: / Line 57: @@
 ** [[Contributing to the wiki]]
 * [[Get In Touch#Events|Events]]
-|-
-|}
+}}
-{| class="wikitable" style="width:100%;"
+{{home:box|news|News|{{NixOS_Wiki:News}}
-|-
+[[NixOS_Wiki:News{{!}}... all news articles &rarr;]]
-! style="text-align:left;" |
+}}
-== [[{{ns:6}}:home-news.png]] News ==
+    </div>
-|-
+</div>
-|
-{{{{ns:4}}:News}}
-|-
-|
-[[{{ns:4}}:News|… all news articles &rarr;]]
-|-
-|}
-|-
-|}