NixOS Wiki

 Getting started

This is the official NixOS Wiki. It contains NixOS user guides, configuration examples, and troubleshooting tips.

NixOS is a Linux operating system based on the Nix package manager and the Nixpkgs software distribution. If you want to try Nix standalone, take your first steps on nix.dev.

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

• Nix Package Manager
• Nix Language
• Nixpkgs
• NixOS
• Hydra
• Applications - Extended Nix Ecosystem

 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:

• Nix manual
• Nixpkgs manual
• NixOS manual
• Hydra manual
• NixOps manual
• Home Manager manual

Major page categories:

• Software
• Hardware
• Desktop
• Server

See also:

• FAQ
• Nixpkgs vs other packagers
• Terms and Definitions in Nix Project
• Cheatsheet / Comparison between Ubuntu and NixOS

 Where’s the old wiki?

The old wiki can still be accessed on 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 history of NixOS wikis.

 Special pages

• All pages of wiki.nixos.org
• All categories of wiki.nixos.org
• Recent changes of wiki.nixos.org

 Get in touch

• Community overview
• Get support
• Official Website
• GitHub repository
• Forums
  • Discourse
  • Stack Overflow
  • Unix & Linux Stack Exchange
  • /r/NixOS
• Chat
  • Matrix
  • Other ways to get in touch (IRC, Discord, Telegram, etc.)
  • #wiki:nixos.org on Matrix
• Email
  • wiki@nixos.org for contacting wiki.nixos.org regarding any wiki operational topics or requests
• Events
• Workgroups (“Interest Groups”)
  • Workgroup:Container
  • Workgroup:Router
  • Workgroup:DataScience

 News

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 →