NixOS Wiki: Difference between revisions

From NixOS Wiki
m Re-add special pages box, though dropping the link to "recent changes" since it's in the menu bar...
m Separate the Ubuntu/NixOS comparison from the Cheatsheet, as they're separate pages.
 
(15 intermediate revisions by 10 users not shown)
Line 1: Line 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! -->
<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. -->
<div class="row home-panes">
<div class="row home-panes">
     <div class="col-md-7">
     <div class="col-md-7">
Line 6: Line 12:
It includes topics not covered in the [https://nixos.org/nixos/manual NixOS Manual]: NixOS user guides, configuration examples, and troubleshooting tips.
It includes topics not covered in the [https://nixos.org/nixos/manual NixOS Manual]: NixOS user guides, configuration examples, and troubleshooting tips.


<!--T:2-->
NixOS is a Linux operating system based on the Nix package manager and the Nixpkgs package repository.
NixOS is a Linux operating system based on the Nix package manager and the Nixpkgs package repository.


<!--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:
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]]
* [[Nix package manager]]
* [[Nixpkgs]] package repository
* [[Nixpkgs]] package repository
Line 15: Line 23:
If you want to try Nix standalone in another Linux distribution or on a Mac, take your first steps on [https://nix.dev nix.dev].
If you want to try Nix standalone in another Linux distribution or on a Mac, take your first steps on [https://nix.dev 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.
<!--T:4-->
}}
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-->
{{home:box|hosting|icon=cloud|Setting up NixOS|
{{home:box|hosting|icon=cloud|Setting up NixOS|
<!-- once ready: * On your computer, with [[NixOS Installation Guide]] -->
<!-- once ready: * On your computer, with [[NixOS Installation Guide]] -->
Line 25: Line 42:
}}
}}


<!--T:6-->
{{home:box|doctopics|icon=manual|Documentation topics|
{{home:box|doctopics|icon=manual|Documentation topics|
First stop should be [[Resources]], which serves as a gateway to the most important documentation. Some highlights below.
First stop should be [[Resources]], which serves as a gateway to the most important documentation. Some highlights below.


<!--T:7-->
Primary reference material:
Primary reference material:
* [https://nixos.org/nixos/manual/ NixOS manual]
* [https://nixos.org/nixos/manual/ NixOS manual]
Line 34: Line 53:
* [https://nixos.org/hydra/manual/ Hydra manual]
* [https://nixos.org/hydra/manual/ Hydra manual]


<!--T:8-->
Major page categories:
Major page categories:
* [[:{{ns:14}}:Software|Software]]
* [[:{{ns:14}}:Software|Software]]
Line 41: Line 61:
* [[:{{ns:14}}:Community|Community]] - people, communication, work on NixOS
* [[:{{ns:14}}:Community|Community]] - people, communication, work on NixOS


<!--T:9-->
See also:
See also:
* [[FAQ]]
* [[FAQ]]
* [[Nix vs. Linux Standard Base]]
* [[Nix vs. Linux Standard Base]]
* [[Terms and Definitions in Nix Project]]
* [[Terms and Definitions in Nix Project]]
* [[Cheatsheet|Cheatsheet / Comparison between Ubuntu and NixOS]]
* [[Cheatsheet]]
* [[Ubuntu vs. NixOS|Comparison between Ubuntu and NixOS]]
}}
}}


<!--T:10-->
{{home:box|wikipages|Special pages|3=<ul>
{{home:box|wikipages|Special pages|3=<ul>
<li><span class="plainlinks">[{{fullurl:Special:SpecialPages}} Overview of special pages]</span></li>
<li><span class="plainlinks">[{{fullurl:Special:AllPages|hideredirects=1}} All pages of {{SERVERNAME}}]</span></li>
<li><span class="plainlinks">[{{fullurl:Special:AllPages|hideredirects=1}} All pages of {{SERVERNAME}}]</span></li>
<li>[[Special:Categories|All categories of {{SERVERNAME}}]]</li>
<li>[[Special:Categories|All categories of {{SERVERNAME}}]]</li>
Line 58: Line 82:
<b>With the community</b>
<b>With the community</b>
* [https://nixos.org/ Official NixOS website]
* [https://nixos.org/ Official NixOS website]
* [https://nixos.org/community/#governance-teams Official Teams]
* [[Nix Community|Community overview]]
* [[Nix Community|Community overview]]
* [[Get In Touch|Chats and forums]]
* [[Get In Touch|Chats and forums]]
Line 63: Line 88:
* [[Get In Touch#Events|Events]]
* [[Get In Touch#Events|Events]]


<!--T:11-->
<b>About the Wiki</b>
<b>About the Wiki</b>
* Matrix chat for Wiki contributors [https://matrix.to/#/#wiki:nixos.org #wiki:nixos.org]
* 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
* 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}}
{{home:box|news|News|{{NixOS_Wiki:News}}
Line 73: Line 100:
     </div>
     </div>
</div>
</div>
</translate>

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:

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

 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:

See also:

 Get in touch

With the community

About the Wiki

 News

2024-09-02Wiki 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-22Wiki 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-05Wiki editors meeting

All interested wiki editors meet on 5th of July at 13:00 CEST in a Jitsi conference.

2024-04-01Launch 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 →