NixOS Wiki: Difference between revisions
m Update to direct link |
m added MoS to wiki section on front page |
||
(31 intermediate revisions by 9 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="col-md-7"> | |||
{{home:box|get-started|icon=clarifications|Getting started| | |||
This is the official NixOS Wiki. | This is the official NixOS Wiki. | ||
It | It includes topics not covered in the [https://nixos.org/nixos/manual 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 | <!--T:2--> | ||
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 Ecosystem|Nix Ecosystem | <!--T:3--> | ||
* [[Nix | 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]] | |||
* [[Nix package manager]] | |||
* [[Nixpkgs]] package repository | |||
* [[Overview of the Nix Language |Nix Language]] | * [[Overview of the Nix Language |Nix Language]] | ||
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]. | |||
* | |||
* | <!--T:4--> | ||
Much great additional tooling exists in the Nix ecosystem such as: | |||
}} | |||
<!--T:12--> | |||
* Home-manager to manage user profile & home directory contents | |||
* 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 23: | Line 39: | ||
}} | }} | ||
<!--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/nix/manual/ Nix manual] | * [https://nixos.org/nix/manual/ Nix manual] | ||
* [https://nixos.org/nixpkgs/manual/ Nixpkgs manual] | * [https://nixos.org/nixpkgs/manual/ Nixpkgs manual] | ||
* [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}}:Hardware|Hardware]] | ||
* [[: | * [[:{{ns:14}}:Desktop|Desktop]] - how to setup PCs | ||
* [[: | * [[:{{ns:14}}:Server|Server]] - how to setup servers | ||
* [[:{{ns:14}}:Community|Community]] - people, communication, work on NixOS | |||
<!--T:9--> | |||
See also: | See also: | ||
* [[FAQ]] | * [[FAQ]] | ||
Line 47: | Line 66: | ||
}} | }} | ||
<!--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> | ||
<li>[{{fullurl:Special:RecentChanges|hidebots=1&reviewStatus=unpatrolled}} Unpatrolled changes of {{SERVERNAME}}]</li> | <li>[{{fullurl:Special:RecentChanges|hidebots=1&reviewStatus=unpatrolled}} Unpatrolled changes of {{SERVERNAME}}]</li> | ||
</ul>}} | </ul>}} | ||
Line 56: | Line 76: | ||
<div class="col-md-5"> | <div class="col-md-5"> | ||
{{home:box|get-in-touch|icon=dialog-hi|Get in touch| | {{home:box|get-in-touch|icon=dialog-hi|Get in touch| | ||
<b>With the community</b> | |||
* [https://nixos.org/ Official NixOS website] | |||
*[https://nixos.org/ Official | * [[Nix Community|Community overview]] | ||
* [[Get In Touch|Chats and forums]] | |||
* [[Support|Get support]] | |||
* [[Get In Touch#Events|Events]] | |||
<!--T:11--> | |||
<b>About the Wiki</b> | |||
* [[Get In Touch | * 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|Contribute to wiki and NixOS]] | |||
* | * [[Manual of Style]] | ||
* | |||
* [[ | |||
}} | }} | ||
{{home:box|news|News|{{NixOS_Wiki:News}} | {{home:box|news|News|{{NixOS_Wiki:News}} | ||
Line 82: | Line 95: | ||
</div> | </div> | ||
</div> | </div> | ||
</translate> |
Revision as of 20:47, 2 September 2024
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:
- NixOS
- Nix package manager
- Nixpkgs package repository
- Nix Language
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.
- On desktop, with NixOS as a desktop
- On ARM, with NixOS on ARM
- In the cloud, with NixOS friendly hosters
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
See also:
With the community
About the Wiki
- Matrix chat for Wiki contributors #wiki:nixos.org
- Email wiki@nixos.org for contacting wiki.nixos.org regarding any wiki operational topics or requests
- Contribute to wiki and NixOS
- Manual of Style
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.
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.