NixOS/ja - Revision history

Amai-ICE: リンク先をのミスを修正

2026-01-21T18:46:19Z

リンク先をのミスを修正

← Older revision		Revision as of 18:46, 21 January 2026
Line 17:		Line 17:

	詳細なインストールガイドは[https://nixos.org/nixos/manual/index.html#ch-installation NixOSマニュアルの「Installation」の章(英語)]を参照して下さい。		詳細なインストールガイドは[https://nixos.org/nixos/manual/index.html#ch-installation NixOSマニュアルの「Installation」の章(英語)]を参照して下さい。
	このWikiでは[[Special:MyLanguage/NixOS\|デスクトップとしてのNixOS]]など、代替の手順や補足的なガイドを掲載しています。		このWikiでは[[Special:MyLanguage/NixOS as a desktop\|デスクトップとしてのNixOS]]など、代替の手順や補足的なガイドを掲載しています。

	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		ほとんどのユーザーは[https://nixos.org/download/#nixos-iso いずれかのISOイメージ]を使用してNixOSをインストールすることになります。
	~~Most users will install NixOS via~~ [https://nixos.org/download/#nixos-iso ~~one of the ISO images.~~] Both "graphical" and "minimal" ISO variants are available for each supported architecture; the "graphical" images are suitable for users intending to install a desktop environment, and the "minimal" images are suitable for users intending to install NixOS in a server role or desiring a smaller ISO image. The ISO images are hybrid images which can be burnt to optical media or copied raw to a USB drive and booted as-is. See the installation guide for details.		サポート済みの各アーキテクチャ向けにGraphical版とMinimal版の2つのISOが提供されています。
	~~</div>~~		Graphical版はデスクトップ環境の構築を予定しているユーザーに適しており、Minimal版はNixOSをサーバー用途として運用したいユーザーやより軽量なISOを使いたいユーザーに適しています。
			ISOはすべてハイブリッドISO形式となっているため、光学メディアに書き込むことも、USBメモリにRAW形式で書き込んで起動することも可能です。詳細についてはインストールガイドを参照して下さい。

	<div lang="en" dir="ltr" class="mw-content-ltr">		<div lang="en" dir="ltr" class="mw-content-ltr">

Amai-ICE: Created page with "詳細なインストールガイドは[https://nixos.org/nixos/manual/index.html#ch-installation NixOSマニュアルの「Installation」の章(英語)]を参照して下さい。このWikiではデスクトップとしてのNixOSなど、代替の手順や補足的なガイドを掲載しています。"

2026-01-21T17:45:10Z

Created page with "詳細なインストールガイドは[https://nixos.org/nixos/manual/index.html#ch-installation NixOSマニュアルの「Installation」の章(英語)]を参照して下さい。このWikiではデスクトップとしてのNixOSなど、代替の手順や補足的なガイドを掲載しています。"

← Older revision		Revision as of 17:45, 21 January 2026
Line 16:		Line 16:
	</div>		</div>

	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		詳細なインストールガイドは[https://nixos.org/nixos/manual/index.html#ch-installation NixOSマニュアルの「Installation」の章(英語)]を参照して下さい。
	~~For a full installation guide, see the~~ [https://nixos.org/nixos/manual/index.html#ch-installation ~~Installation chapter of the NixOS manual~~]~~. This wiki also includes alternative or supplemental guides, such as~~ [[Special:MyLanguage/NixOS ~~as a desktop~~\|~~NixOS as a desktop~~]].		このWikiでは[[Special:MyLanguage/NixOS\|デスクトップとしてのNixOS]]など、代替の手順や補足的なガイドを掲載しています。
	~~</div>~~

	<div lang="en" dir="ltr" class="mw-content-ltr">		<div lang="en" dir="ltr" class="mw-content-ltr">

Amai-ICE: Created page with "Nixでは[https://ja.wikipedia.org/wiki/%E5%AE%9F%E8%A1%8C%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB バイナリ]キャッシュを利用しているため、Debianのようなバイナリ指向ディストリビューションと、Gentooのような[https://ja.wikipedia.org/wiki/%E3%82%BD%E3%83%BC%E3%82%B9%E3%82%B3%E3%83%BC%E3%83%89 ソース]指向のディストリビューションの要素を併せ持った、独自の方式を提供しています。OSの根幹をな..."

2026-01-21T17:16:38Z

Created page with "Nixでは[https://ja.wikipedia.org/wiki/%E5%AE%9F%E8%A1%8C%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB バイナリ]キャッシュを利用しているため、Debianのようなバイナリ指向ディストリビューションと、Gentooのような[https://ja.wikipedia.org/wiki/%E3%82%BD%E3%83%BC%E3%82%B9%E3%82%B3%E3%83%BC%E3%83%89 ソース]指向のディストリビューションの要素を併せ持った、独自の方式を提供しています。OSの根幹をな..."

← Older revision		Revision as of 17:16, 21 January 2026
Line 4:		Line 4:

	[https://nixos.org/ NixOS]は[[Special:MyLanguage/Nix\|Nix]]パッケージマネージャーとビルドシステムをベースにしたLinuxディストリビューションです。システム全体の[https://ja.wikipedia.org/wiki/%E5%AE%A3%E8%A8%80%E5%9E%8B%E3%83%97%E3%83%AD%E3%82%B0%E3%83%A9%E3%83%9F%E3%83%B3%E3%82%B0 宣言的]な[https://ja.wikipedia.org/wiki/%E6%A7%8B%E6%88%90%E7%AE%A1%E7%90%86 構成管理]、[https://ja.wikipedia.org/wiki/%E4%B8%8D%E5%8F%AF%E5%88%86%E6%93%8D%E4%BD%9C アトミック]な更新とロールバックに加え、[https://ja.wikipedia.org/wiki/%E5%91%BD%E4%BB%A4%E5%9E%8B%E3%83%97%E3%83%AD%E3%82%B0%E3%83%A9%E3%83%9F%E3%83%B3%E3%82%B0 命令形]のパッケージ/ユーザー管理が実現できます。		[https://nixos.org/ NixOS]は[[Special:MyLanguage/Nix\|Nix]]パッケージマネージャーとビルドシステムをベースにしたLinuxディストリビューションです。システム全体の[https://ja.wikipedia.org/wiki/%E5%AE%A3%E8%A8%80%E5%9E%8B%E3%83%97%E3%83%AD%E3%82%B0%E3%83%A9%E3%83%9F%E3%83%B3%E3%82%B0 宣言的]な[https://ja.wikipedia.org/wiki/%E6%A7%8B%E6%88%90%E7%AE%A1%E7%90%86 構成管理]、[https://ja.wikipedia.org/wiki/%E4%B8%8D%E5%8F%AF%E5%88%86%E6%93%8D%E4%BD%9C アトミック]な更新とロールバックに加え、[https://ja.wikipedia.org/wiki/%E5%91%BD%E4%BB%A4%E5%9E%8B%E3%83%97%E3%83%AD%E3%82%B0%E3%83%A9%E3%83%9F%E3%83%B3%E3%82%B0 命令形]のパッケージ/ユーザー管理が実現できます。
	NixOSでは[https://ja.wikipedia.org/wiki/Linux%E3%82%AB%E3%83%BC%E3%83%8D%E3%83%AB カーネル]、インストールする[https://ja.wikipedia.org/wiki/%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E7%AE%A1%E7%90%86%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0 パッケージ]、コンフィグファイルなど、システムを構成するすべての要素が[[Special:MyLanguage/Nix Expression Language\|Nix式]]と呼ばれる[https://en.wikipedia.org/wiki/Pure_function\| 純粋関数(英語)]によって構成されます。		NixOSでは[https://ja.wikipedia.org/wiki/Linux%E3%82%AB%E3%83%BC%E3%83%8D%E3%83%AB カーネル]、インストールする[https://ja.wikipedia.org/wiki/%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E7%AE%A1%E7%90%86%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0 パッケージ]、コンフィグファイルなど、システムを構成するすべての要素が[[Special:MyLanguage/Nix Expression Language\|Nix式]]と呼ばれる[https://en.wikipedia.org/wiki/Pure_function 純粋関数(英語)]によって構成されます。

	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		Nixでは[https://ja.wikipedia.org/wiki/%E5%AE%9F%E8%A1%8C%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB バイナリ]キャッシュを利用しているため、Debianのようなバイナリ指向ディストリビューションと、Gentooのような[https://ja.wikipedia.org/wiki/%E3%82%BD%E3%83%BC%E3%82%B9%E3%82%B3%E3%83%BC%E3%83%89 ソース]指向のディストリビューションの要素を併せ持った、独自の方式を提供しています。OSの根幹をなす一般的なパッケージにはバイナリをそのまま使用することができ、ビルド済みのバイナリが提供されていない独自のパッケージやモジュールについては、自動的にソースからビルドして使用します。
	~~Since Nix uses~~ [https://en.wikipedia.org/wiki/~~Executable binary~~] ~~caching, this provides a unique compromise between the binary-oriented approach used by distributions such as Debian and the~~ [https://en.wikipedia.org/wiki/~~Source_code source~~]-oriented approach used by distributions such as Gentoo. Binaries can be used for standard components, and custom-built packages and modules can be used automatically when a pre-built binary is not available.
	~~</div>~~

	<div lang="en" dir="ltr" class="mw-content-ltr">		<div lang="en" dir="ltr" class="mw-content-ltr">

Amai-ICE: "Wikipedia:Pure function"が存在しないため、直リンクに変更します。

2026-01-21T16:58:58Z

"Wikipedia:Pure function"が存在しないため、直リンクに変更します。

← Older revision		Revision as of 16:58, 21 January 2026
Line 3:		Line 3:
	{{Expansion\|reason=新規ユーザーが最初に読む記事の一つなので、もっとわかりやすい紹介文にするべきです。そのため、この記事の内容を簡略化し、より複雑な話題は他の記事に移動する必要があります。}}		{{Expansion\|reason=新規ユーザーが最初に読む記事の一つなので、もっとわかりやすい紹介文にするべきです。そのため、この記事の内容を簡略化し、より複雑な話題は他の記事に移動する必要があります。}}

	~~<div lang="en" dir="ltr" class="mw-content-ltr">~~		[https://nixos.org/ NixOS]は[[Special:MyLanguage/Nix\|Nix]]パッケージマネージャーとビルドシステムをベースにしたLinuxディストリビューションです。システム全体の[https://ja.wikipedia.org/wiki/%E5%AE%A3%E8%A8%80%E5%9E%8B%E3%83%97%E3%83%AD%E3%82%B0%E3%83%A9%E3%83%9F%E3%83%B3%E3%82%B0 宣言的]な[https://ja.wikipedia.org/wiki/%E6%A7%8B%E6%88%90%E7%AE%A1%E7%90%86 構成管理]、[https://ja.wikipedia.org/wiki/%E4%B8%8D%E5%8F%AF%E5%88%86%E6%93%8D%E4%BD%9C アトミック]な更新とロールバックに加え、[https://ja.wikipedia.org/wiki/%E5%91%BD%E4%BB%A4%E5%9E%8B%E3%83%97%E3%83%AD%E3%82%B0%E3%83%A9%E3%83%9F%E3%83%B3%E3%82%B0 命令形]のパッケージ/ユーザー管理が実現できます。
	[https://nixos.org/ NixOS] ~~is a Linux distribution based on the~~ [[Special:MyLanguage/Nix\|Nix]] ~~package manager and build system. It supports~~ [https://en.wikipedia.org/wiki/~~Declarative_programming declarative~~] ~~system-wide~~ [https://en.wikipedia.org/wiki/~~Configuration_management configuration management~~] ~~as well as~~ [https://en.wikipedia.org/wiki/~~Atomicity_(database_systems) atomic~~] ~~upgrades and rollbacks, although it can additionally support~~ [https://en.wikipedia.org/wiki/~~Imperative_programming imperative~~] ~~package and user management. In NixOS, all components of the distribution — including the~~ [https://en.wikipedia.org/wiki/~~Linux_kernel kernel~~]~~, installed~~ [https://en.wikipedia.org/wiki/~~Package_manager packages~~] ~~and system configuration files — are built by~~ [[Special:MyLanguage/Nix\|~~Nix~~]] ~~from~~ [~~[Wikipedia~~:~~Pure function\|pure functions]] called [[Special:MyLanguage~~/~~Nix Expression Language~~\|~~Nix expressions]~~].		NixOSでは[https://ja.wikipedia.org/wiki/Linux%E3%82%AB%E3%83%BC%E3%83%8D%E3%83%AB カーネル]、インストールする[https://ja.wikipedia.org/wiki/%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E7%AE%A1%E7%90%86%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0 パッケージ]、コンフィグファイルなど、システムを構成するすべての要素が[[Special:MyLanguage/Nix Expression Language\|Nix式]]と呼ばれる[https://en.wikipedia.org/wiki/Pure_function\| 純粋関数(英語)]によって構成されます。
	~~</div>~~

	<div lang="en" dir="ltr" class="mw-content-ltr">		<div lang="en" dir="ltr" class="mw-content-ltr">

Amai-ICE: Created page with "NixOS"

2026-01-20T23:38:29Z

Created page with "NixOS"

New page

<languages/>
{{Navbox Nix}}
{{Expansion|reason=新規ユーザーが最初に読む記事の一つなので、もっとわかりやすい紹介文にするべきです。そのため、この記事の内容を簡略化し、より複雑な話題は他の記事に移動する必要があります。}}

<div lang="en" dir="ltr" class="mw-content-ltr">
[https://nixos.org/ NixOS] is a Linux distribution based on the [[Special:MyLanguage/Nix|Nix]] package manager and build system. It supports [https://en.wikipedia.org/wiki/Declarative_programming declarative] system-wide [https://en.wikipedia.org/wiki/Configuration_management configuration management] as well as [https://en.wikipedia.org/wiki/Atomicity_(database_systems) atomic] upgrades and rollbacks, although it can additionally support [https://en.wikipedia.org/wiki/Imperative_programming imperative] package and user management. In NixOS, all components of the distribution — including the [https://en.wikipedia.org/wiki/Linux_kernel kernel], installed [https://en.wikipedia.org/wiki/Package_manager packages] and system configuration files — are built by [[Special:MyLanguage/Nix|Nix]] from [[Wikipedia:Pure function|pure functions]] called [[Special:MyLanguage/Nix Expression Language|Nix expressions]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Since Nix uses [https://en.wikipedia.org/wiki/Executable binary] caching, this provides a unique compromise between the binary-oriented approach used by distributions such as Debian and the [https://en.wikipedia.org/wiki/Source_code source]-oriented approach used by distributions such as Gentoo. Binaries can be used for standard components, and custom-built packages and modules can be used automatically when a pre-built binary is not available.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Stable NixOS releases are delivered twice a year (around the end of May and the end of November). NixOS was created by [https://edolstra.github.io/ Eelco Dolstra] and [https://en.wikipedia.org/wiki/Armijn_Hemel Armijn Hemel], and initially released in 2003. It is community developed and maintained under the stewardship of the [[Special:MyLanguage/Nix_Community#NixOS_Foundation|NixOS Foundation]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Installation ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
For a full installation guide, see the [https://nixos.org/nixos/manual/index.html#ch-installation Installation chapter of the NixOS manual]. This wiki also includes alternative or supplemental guides, such as [[Special:MyLanguage/NixOS as a desktop|NixOS as a desktop]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Most users will install NixOS via [https://nixos.org/download/#nixos-iso one of the ISO images.] Both "graphical" and "minimal" ISO variants are available for each supported architecture; the "graphical" images are suitable for users intending to install a desktop environment, and the "minimal" images are suitable for users intending to install NixOS in a server role or desiring a smaller ISO image. The ISO images are hybrid images which can be burnt to optical media or copied raw to a USB drive and booted as-is. See the installation guide for details.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
In addition to the ISO images, the [https://nixos.org/download/#nixos-iso download page] provides a number of alternative methods for installing NixOS. These include:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* Virtual appliances in OVA format (compatible with VirtualBox);
* Amazon EC2 AMIs;
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Additionally, many existing Linux installations can be converted into NixOS installations using [https://github.com/elitak/nixos-infect nixos-infect] or [https://github.com/jeaye/nixos-in-place nixos-in-place]; this is particularly useful for installing NixOS on hosting providers which do not natively support NixOS.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== System architectures ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
NixOS provides out of the box support for most x86_64 devices, and generic ARM64 devices.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== 32-bit x86 architectures ====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Support for 32-bit x86 architectures (i.e. <code>i686</code>) has been declining. While most packages should still compile and run, their cache availability is significantly reduced<ref>https://discourse.nixos.org/t/limited-cache-availability-for-i686-32-bits-x86-architecture/37626</ref>. The 32-bit x86 ISO is no longer offered as a ready-built image, but it may still be built manually.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== 64-bit x86 architectures ====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Most <code>x86_64</code> devices should run NixOS without issues.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== 32-bit ARM architectures ====
</div>

{{Main|NixOS on ARM}}
<div lang="en" dir="ltr" class="mw-content-ltr">
NixOS isn't officially supported on ARM32 devices (e.g. <code>armv6</code> and <code>armv7l</code>), however, for some of these devices, there may be community support.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== 64-bit ARM architectures ====
</div>

{{Main|NixOS on ARM}}
<div lang="en" dir="ltr" class="mw-content-ltr">
As long as a device supports the generic systemd boot process, NixOS should run out of the box. However, specific devices with proprietary bootloaders may have issues running it.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== MIPS architectures ====
</div>

{{Main|NixOS on MIPS}}
<div lang="en" dir="ltr" class="mw-content-ltr">
There used to be limited support for MIPS architectures in NixOS, and remnants of this support may still be found in Nixpkgs. However, there is no official support.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== RISC-V architectures ====
</div>

{{Main|RISC-V}}

<div lang="en" dir="ltr" class="mw-content-ltr">
NixOS does not provide official support for RISC-V devices. However, several devices may benefit from community support.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Usage ==
</div>

<span id="declarative-configuration"></span>
<div lang="en" dir="ltr" class="mw-content-ltr">
=== Declarative Configuration ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
One of NixOS's defining features is its declarative configuration model, where the entire system state — including installed packages, system services, and settings — is described in configuration files. The primary file is typically located at <code>/etc/nixos/configuration.nix</code>.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Changes to the configuration are applied atomically using <code>nixos-rebuild switch</code>, ensuring reproducibility and the ability to roll back to previous states. Most users track their configuration files in a version control system, enabling consistent and portable system setups. These shortcomings are often rectified after-the-fact if at all by configuration management solutions such as Puppet, Ansible or Chef. These tools reconcile system configuration with a description of the expected state. However, these tools are not integrated into the operating system design and are simply layered on top, and OS configuration may still vary where an aspect of OS configuration has not been specified in the description of expected state.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Unlike conventional distributions, where system configuration is often scattered across manually edited files, NixOS integrates configuration management directly into the operating system. This eliminates configuration drift and makes NixOS particularly well-suited for automated, reproducible deployments.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
For more details and examples on NixOS configurations, see [[Special:MyLanguage/NixOS system configuration|NixOS system configuration]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Imperative Operations ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
While NixOS is typically configured declaratively as much as possible, these are a few domains where imperative operations are still necessary; these include user environment management and channel management.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== User Environments ====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
In addition to declarative system configuration, NixOS users can utilize Nix's imperative <code>nix-env</code> command to install packages at the user level, without changing the system state. See the [[Special:MyLanguage/Nix#User Environments| user environments section of the Nix article]] for more information.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==== Channels ====
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
In the [[Special:MyLanguage/Nix ecosystem|Nix ecosystem]], [[Special:MyLanguage/Channel branches|channels]] are a mechanism for distributing collections of [[Special:MyLanguage/Nixpkgs|Nix packages]] and [[Special:MyLanguage/NixOS|NixOS]] module definitions. A channel represents a curated, versioned set of package definitions and system configurations, typically corresponding to a particular release or the latest available development state.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
When using channels, your system or [[Special:MyLanguage/User Environment|user environment]] pulls package definitions and options from a URL pointing to a specific snapshot of the Nix Packages collection (Nixpkgs) and associated NixOS modules.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
For more information on using and configuring nix channels, refer to [[Special:MyLanguage/channel branches|channel branches]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Internals ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Comparison with traditional Linux Distributions ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
''Main Article: [[Special:MyLanguage/Nix vs. Linux Standard Base|Nix vs. Linux Standard Base]]''
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The main difference between NixOS and other Linux distributions is that NixOS does not follow the [https://en.wikipedia.org/wiki/Linux_Standard_Base Linux Standard Base] file system structure. On LSB-compliant systems software is stored under <code>/{,usr}/{bin,lib,share}</code> and configuration is generally stored in <code>/etc</code>. Software binaries are available in the user environment if they are placed in one of the LSB's <code>/bin</code> directories. When a program references dynamic libraries it will search for the required libraries in the LSB folders (<code>/lib</code>, <code>/usr/lib</code>).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
In NixOS however <code>/lib</code> and <code>/usr/lib</code> do not exist. Instead all system libraries, binaries, kernels, firmware and configuration files are placed in the [[Special:MyLanguage/Nix#Nix store|Nix store]]. The files and directories in <code>/nix/store</code> are named by hashes of the information describing the built data. All of the files and directories placed in the Nix store are immutable. <code>/bin</code> and <code>/usr/bin</code> are almost absent: they contain only <code>/bin/sh</code> and <code>/usr/bin/env</code> respectively, to provide minimal compatibility with existing scripts using shebang lines. User-level environments are implemented using a large number of symbolic links to all required packages and auxiliary files. These environments are called [[Special:MyLanguage/Nix#Profiles|profiles]] and are stored in <code>/nix/var/nix/profiles</code>, each user having their own profiles. Structuring the system in this way is how NixOS obtains its key advantages over conventional Linux distributions, such as atomicity and rollback support.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Usage of the Nix store ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
A lot of confusion for newcomers arises from the fact that configuration is stored in the read-only <code>/nix/store</code> tree along with all the installed packages. This fact makes it impossible to manually edit system configuration; all configuration changes must be performed by editing the <code>/etc/nixos/configuration.nix</code> file and executing <code>nixos-rebuild switch</code>. NixOS provides the [[Special:MyLanguage/NixOS_modules|module system]] for editing all required configurations. Users should first use [https://search.nixos.org/options the option search tool] to check if the option they need exists before attempting to manually add files or configuration via low-level NixOS features like activation scripts.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The system purity makes it possible to keep system configuration in a central place, without the need to edit multiple files. This configuration can be distributed or version controlled as desired. It also provides for determinism; if you provide the same inputs, the same version of Nixpkgs and the same <code>/etc/nixos/configuration.nix</code> you will get the exact same system state.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Modules ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The [[Special:MyLanguage/NixOS modules|NixOS module system]] as defined in [[Special:MyLanguage/Nixpkgs|Nixpkgs]] provides the means necessary to customize the configuration of the OS. It is used to enable and customize services such as nginx, enable firmware and customize the kernel.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
All module configuration is generally performed by adding options to <code>/etc/nixos/configuration.nix</code>. Most of the examples in the wiki show how this file can be used to configure the OS.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The NixOS module system implements a typing system which allows typechecking of option settings. It also enables options defined in multiple places to be merged automatically. This allows you to spread your configuration over multiple files, and the options you set across all of those files will be merged together:
</div>

{{file|/etc/nixos/configuration.nix|nix|<nowiki>
{
imports = [
./basic-webserver.nix
./blog.nix
];
}
</nowiki>}}
{{file|/etc/nixos/basic-webserver.nix|nix|<nowiki>
{
services.nginx.enable = true;
services.nginx.virtualHosts."example.com" = {
root = "/var/www/example.com";
};
}
</nowiki>}}
{{file|/etc/nixos/blog.nix|nix|<nowiki>
{
services.nginx.virtualHosts."blog.example.com" = {
root = "/var/www/blog.example.com";
};
}
</nowiki>}}

<div lang="en" dir="ltr" class="mw-content-ltr">
See the [https://nixos.org/nixos/manual/index.html#sec-writing-modules Modules section of the NixOS Manual] for more details.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Generations ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Every time the system state is rebuilt using <code>nixos-rebuild switch</code>, a new generation is created. You can revert to the previous generation at any time, which is useful if a configuration change (or system update) turns out to be detrimental.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can roll back via:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
<syntaxHighlight lang=shell>
$ nix-env --rollback # roll back a user environment
$ nixos-rebuild switch --rollback # roll back a system environment
</syntaxHighlight>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
NixOS also places entries for previous generations in the bootloader menu, so as a last resort you can always revert to a previous configuration by rebooting. To set the currently booted generation as the default run
</div>

<syntaxHighlight lang=shell>
$ /run/current-system/bin/switch-to-configuration boot
</syntaxHighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
Because NixOS keeps previous generations of system state available in case rollback is desired, old package versions aren't deleted from your system immediately after an update. You can delete old generations manually:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
<syntaxHighlight lang=shell>
# delete generations older than 30 days
$ nix-collect-garbage --delete-older-than 30d
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
# delete ALL previous generations - you can no longer rollback after running this
$ nix-collect-garbage -d
</syntaxHighlight>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
List generations:
<syntaxHighlight lang=shell>
# as root
$ nix-env --list-generations --profile /nix/var/nix/profiles/system
</syntaxHighlight>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Switch generations:
<syntaxHighlight lang=shell>
# as root switch to generation 204
$ nix-env --profile /nix/var/nix/profiles/system --switch-generation 204
</syntaxHighlight>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
delete broken generation(s):
<syntaxHighlight lang=shell>
# as root delete broken generations 205 and 206
$ nix-env --profile /nix/var/nix/profiles/system --delete-generations 205 206
</syntaxHighlight>
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can configure automatic garbage collection by setting the [https://search.nixos.org/options?query=nix.gc nix.gc] options in <code>/etc/nixos/configuration.nix</code>. This is recommended, as it keeps the size of the Nix store down.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== See also ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* [[Special:MyLanguage/NixOS modules|NixOS modules]], a library for modular [[Special:MyLanguage/Overview of the Nix Expression Language#Expressions|Nix expressions]] which powers [[#declarative-configuration|the declarative configuration of NixOS]].
* [[Special:MyLanguage/NixOS VM tests|NixOS VM tests]], a library for creating reproducible infrastructure tests, based on [[Special:MyLanguage/Nixpkgs|Nixpkgs]], [[Special:MyLanguage/NixOS|NixOS]], QEMU and Perl.
* [https://github.com/ryan4yin/nixos-and-flakes-book NixOS & Flakes Book] (Ryan4yin, 2023) - 🛠️ ❤️ An unofficial NixOS & Flakes book for beginners.
</div>

[[Category:Pedias]]
[[Category:NixOS]]
[[Category:Nix{{#translation:}}]]