NixOS Wiki: Difference between revisions

From NixOS Wiki
Vater (talk | contribs)
(much more) pure mediawiki (pure table foo (no "useless" special templates are needed))
AveryKoen (talk | contribs)
mNo edit summary
 
(27 intermediate revisions by 13 users not shown)
Line 1: Line 1:
<languages/>
<translate>
<!--T:1-->
__NOTOC__
__NOTOC__
{|
<!-- NOTE: Please don't change the layout/categorizing without first coordinating with the other editors. -->
|- style="vertical-align:top;"
<!-- 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. -->
{| class="wikitable" style="width:100%;"
<div class="row home-panes">
|-
    <div class="col-md-7">
! style="text-align:left;" |
{{home:box|get-started|icon=clarifications|Getting started|
= [[{{ns:6}}:home-clarifications.png]] Getting started =
|-
|
This is the official NixOS Wiki.
This is the official NixOS Wiki.
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.


NixOS is a Linux operating system based on the Nix package manager and the Nixpkgs package repository.
<!--T:2-->
NixOS is a [https://kernel.org/ 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|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].
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:
|}
 
{| class="wikitable" style="width:100%;"
<!--T:12-->
|-
* [[Home Manager|Home Manager]], a system for managing user profile & home directory contents
! style="text-align:left;" |
* [[Flakes|Nix Flakes]], an experimental feature for managing dependencies of Nix projects
= [[{{ns:6}}:home-cloud.png]] Setting up NixOS =
 
|-
<!--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|
<!-- once ready: * On your computer, with [[NixOS Installation Guide]] -->
<!-- once ready: * On your computer, with [[NixOS Installation Guide]] -->
* On desktop, with [[NixOS as a desktop]]
* On desktop, with [[NixOS as a desktop]]
* On ARM, with [[NixOS on ARM]]
* On ARM, with [[NixOS on ARM]]
* In the cloud, with [[NixOS friendly hosters]]
* In the cloud, with [[NixOS friendly hosters]]
|-
}}
|}
 
{| class="wikitable" style="width:100%;"
<!--T:6-->
|-
{{home:box|doctopics|icon=manual|Documentation topics|
! style="text-align:left;" |
= [[{{ns:6}}:home-manual.png]] 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 50: 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]]
* [[:{{ns:14}}:Hardware|Hardware]]
* [[:{{ns:14}}:Hardware|Hardware]]
* [[:{{ns:14}}:Desktop|Desktop]]
* [[:{{ns:14}}:Desktop|Desktop]] - how to setup PCs
* [[:{{ns:14}}:Server|Server]]
* [[:{{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]]
* [[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]]
|}
}}
{| class="wikitable" style="width:100%;"
 
|-
<!--T:10-->
! style="text-align:left;" |
{{home:box|wikipages|Special pages|3=<ul>
= [[{{ns:6}}:home-wikipages.png]] Special pages =
<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>[[Special:Categories|All categories of {{SERVERNAME}}]]</li>
* [{{fullurl:{{ns:-1}}:AllPages|hideredirects=1}} All pages of {{SERVERNAME}}]
<li>[{{fullurl:Special:RecentChanges|hidebots=1&reviewStatus=unpatrolled}} Unpatrolled changes of {{SERVERNAME}}]</li>
* [[{{ns:-1}}:Categories|All categories of {{SERVERNAME}}]]</li>
</ul>}}
* [[{{ns:-1}}:RecentChanges|Recent changes of {{SERVERNAME}}]]</li>
    </div>
* [{{fullurl:{{ns:-1}}:RecentChanges|hidebots=1&reviewStatus=unpatrolled}} Unpatrolled changes of {{SERVERNAME}}]
    <div class="col-md-5">
|-
{{home:box|get-in-touch|icon=dialog-hi|Get in touch|
|}
<b>With the community</b>
|
{| class="wikitable" style="width:100%;"
|-
! style="text-align:left;" |
= [[{{ns:6}}:home-dialog-hi.png]] Get in touch =
|-
|
* [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]]
* [[Support|Get support]]
* [[Support|Get support]]
* Wiki
** 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]]
* [[Get In Touch#Events|Events]]
* [[Get In Touch#Events|Events]]
|-
 
|}
<!--T:11-->
{| class="wikitable" style="width:100%;"
<b>About the Wiki</b>
|-
* Matrix chat for Wiki contributors [https://matrix.to/#/#wiki:nixos.org #wiki:nixos.org]
! style="text-align:left;" |
* Email [mailto:wiki@nixos.org wiki@nixos.org] for contacting wiki.nixos.org regarding any wiki operational topics or requests
== [[{{ns:6}}:home-news.png]] News ==
* [[Contributing|Contribute to wiki and NixOS]]
|-
* [[Manual of Style]]
|
}}
{{{{ns:4}}:News}}
{{home:box|news|News|{{NixOS_Wiki:News}}
|-
[[NixOS_Wiki:News{{!}}... all news articles &rarr;]]
|
}}
[[{{ns:4}}:News|… all news articles &rarr;]]
    </div>
|-
</div>
|}
</translate>
|-
|}

Latest revision as of 16:28, 15 January 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

 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 →