NixOS Wiki: Difference between revisions

Revision as of 18:14, 14 April 2025

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

@@ Line 6: / Line 6: @@
 <!-- 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">