| 
									
										
										
										
											2019-10-28 11:46:27 +01:00
										 |  |  |  | <preface xmlns="http://docbook.org/ns/docbook" | 
					
						
							|  |  |  |  |          xmlns:xlink="http://www.w3.org/1999/xlink" | 
					
						
							|  |  |  |  |          xml:id="preface"> | 
					
						
							|  |  |  |  |  <title>Preface</title> | 
					
						
							|  |  |  |  |  <para> | 
					
						
							|  |  |  |  |   This manual describes how to install, use and extend NixOS, a Linux | 
					
						
							|  |  |  |  |   distribution based on the purely functional package management system | 
					
						
							| 
									
										
										
										
											2019-10-28 12:15:35 +01:00
										 |  |  |  |   <link xlink:href="https://nixos.org/nix">Nix</link>, that is composed | 
					
						
							|  |  |  |  |   using modules and packages defined in the | 
					
						
							|  |  |  |  |   <link xlink:href="https://nixos.org/nixpkgs">Nixpkgs</link> project. | 
					
						
							|  |  |  |  |  </para> | 
					
						
							|  |  |  |  |  <para> | 
					
						
							|  |  |  |  |   Additional information regarding the Nix package manager and the Nixpkgs | 
					
						
							|  |  |  |  |   project can be found in respectively the | 
					
						
							|  |  |  |  |   <link xlink:href="https://nixos.org/nix/manual">Nix manual</link> and the | 
					
						
							|  |  |  |  |   <link xlink:href="https://nixos.org/nixpkgs/manual">Nixpkgs manual</link>. | 
					
						
							| 
									
										
										
										
											2019-10-28 11:46:27 +01:00
										 |  |  |  |  </para> | 
					
						
							|  |  |  |  |  <para> | 
					
						
							|  |  |  |  |   If you encounter problems, please report them on the | 
					
						
							|  |  |  |  |   <literal | 
					
						
							|  |  |  |  |    xlink:href="https://discourse.nixos.org">Discourse</literal> or | 
					
						
							|  |  |  |  |   on the <link | 
					
						
							|  |  |  |  |    xlink:href="irc://irc.freenode.net/#nixos"> | 
					
						
							|  |  |  |  |   <literal>#nixos</literal> channel on Freenode</link>. Bugs should be | 
					
						
							|  |  |  |  |   reported in | 
					
						
							|  |  |  |  |   <link | 
					
						
							|  |  |  |  |    xlink:href="https://github.com/NixOS/nixpkgs/issues">NixOS’ | 
					
						
							|  |  |  |  |   GitHub issue tracker</link>. | 
					
						
							|  |  |  |  |  </para> | 
					
						
							|  |  |  |  |  <note> | 
					
						
							|  |  |  |  |   <para> | 
					
						
							|  |  |  |  |    Commands prefixed with <literal>#</literal> have to be run as root, either | 
					
						
							|  |  |  |  |    requiring to login as root user or temporarily switching to it using | 
					
						
							|  |  |  |  |    <literal>sudo</literal> for example. | 
					
						
							|  |  |  |  |   </para> | 
					
						
							|  |  |  |  |  </note> | 
					
						
							|  |  |  |  | </preface> |