NixOS Wiki: Difference between revisions

Latest revision as of 14:49, 30 October 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 to manage user profile & home directory contents
Nix Flakes instead of nix-channel

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: @@
+<languages/>
 <translate>
 <!--T:1-->
-__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: Removing those notes and/or disregarding this is not only rude, but should be considered defacement. -->
+__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: 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">
@@ Line 13: / Line 17: @@
 <!--T:3-->
 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:
-* [[NixOS]]
+* [[Overview_of_the_NixOS_Linux_distribution|NixOS]]
 * [[Nix package manager]]
 * [[Nixpkgs]] package repository
@@ Line 20: / Line 24: @@
 <!--T:4-->
-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.
+Much great additional tooling exists in the Nix ecosystem such as:
-}}
+<!--T:12-->
+* [[Home Manager|Home-manager]] to manage user profile & home directory contents
+* [[Flakes|Nix Flakes]] instead of nix-channel
+<!--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-->
@@ Line 55: / Line 66: @@
 * [[Nix vs. Linux Standard Base]]
 * [[Terms and Definitions in Nix Project]]
-* [[Cheatsheet|Cheatsheet / Comparison between Ubuntu and NixOS]]
+* [[Cheatsheet]]
+* [[Ubuntu vs. NixOS|Comparison between Ubuntu and NixOS]]
 }}
@@ Line 70: / Line 82: @@
 <b>With the community</b>
 * [https://nixos.org/ Official NixOS website]
+* [https://nixos.org/community/#governance-teams Official Teams]
 * [[Nix Community|Community overview]]
 * [[Get In Touch|Chats and forums]]
@@ Line 79: / Line 92: @@
 * 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
-* [[Contributing to the wiki]]
+* [[Contributing|Contribute to wiki and NixOS]]
+* [[Manual of Style]]
 }}
 {{home:box|news|News|{{NixOS_Wiki:News}}