137 lines
3.4 KiB
XML
137 lines
3.4 KiB
XML
<chapter xmlns="http://docbook.org/ns/docbook"
|
||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||
version="5.0"
|
||
xml:id="chap-quick-start">
|
||
|
||
<title>Quick Start</title>
|
||
|
||
<para>This chapter is for impatient people who don't like reading
|
||
documentation. For more in-depth information you are kindly referred
|
||
to subsequent chapters.</para>
|
||
|
||
<procedure>
|
||
|
||
<step><para>Install single-user Nix by running the following:
|
||
|
||
<screen>
|
||
$ curl https://nixos.org/nix/install | sh
|
||
</screen>
|
||
|
||
This will install Nix in <filename>/nix</filename>. The install script
|
||
will create <filename>/nix</filename> using <command>sudo</command>,
|
||
so make sure you have sufficient rights. (For other installation
|
||
methods, see <xref linkend="chap-installation"/>.)</para></step>
|
||
|
||
<step><para>See what installable packages are currently available
|
||
in the channel:
|
||
|
||
<screen>
|
||
$ nix-env -qa
|
||
docbook-xml-4.3
|
||
docbook-xml-4.5
|
||
firefox-33.0.2
|
||
hello-2.9
|
||
libxslt-1.1.28
|
||
<replaceable>...</replaceable></screen>
|
||
|
||
</para></step>
|
||
|
||
<step><para>Install some packages from the channel:
|
||
|
||
<screen>
|
||
$ nix-env -i hello <replaceable>...</replaceable> </screen>
|
||
|
||
This should download pre-built packages; it should not build them
|
||
locally (if it does, something went wrong).</para></step>
|
||
|
||
<step><para>Test that they work:
|
||
|
||
<screen>
|
||
$ which hello
|
||
/home/eelco/.nix-profile/bin/hello
|
||
$ hello
|
||
Hello, world!
|
||
</screen>
|
||
|
||
</para></step>
|
||
|
||
<step><para>Uninstall a package:
|
||
|
||
<screen>
|
||
$ nix-env -e hello</screen>
|
||
|
||
</para></step>
|
||
|
||
<step><para>You can also test a package without installing it:
|
||
|
||
<screen>
|
||
$ nix-shell -p hello
|
||
</screen>
|
||
|
||
This builds or downloads GNU Hello and its dependencies, then drops
|
||
you into a Bash shell where the <command>hello</command> command is
|
||
present, all without affecting your normal environment:
|
||
|
||
<screen>
|
||
[nix-shell:~]$ hello
|
||
Hello, world!
|
||
|
||
[nix-shell:~]$ exit
|
||
|
||
$ hello
|
||
hello: command not found
|
||
</screen>
|
||
|
||
</para></step>
|
||
|
||
<step><para>To keep up-to-date with the channel, do:
|
||
|
||
<screen>
|
||
$ nix-channel --update nixpkgs
|
||
$ nix-env -u '*'</screen>
|
||
|
||
The latter command will upgrade each installed package for which there
|
||
is a “newer” version (as determined by comparing the version
|
||
numbers).</para></step>
|
||
|
||
<!--
|
||
<step><para>You can also install specific packages directly from
|
||
your web browser. For instance, you can go to <link
|
||
xlink:href="http://hydra.nixos.org/jobset/nixpkgs/trunk/channel/latest"
|
||
/> and click on any link for the individual packages for your
|
||
platform. Associate <literal>application/nix-package</literal> with
|
||
the program <command>nix-install-package</command>. A window should
|
||
appear asking you whether it’s okay to install the package. Say
|
||
<literal>Y</literal>. The package and all its dependencies will be
|
||
installed.</para></step>
|
||
-->
|
||
|
||
<step><para>If you're unhappy with the result of a
|
||
<command>nix-env</command> action (e.g., an upgraded package turned
|
||
out not to work properly), you can go back:
|
||
|
||
<screen>
|
||
$ nix-env --rollback</screen>
|
||
|
||
</para></step>
|
||
|
||
<step><para>You should periodically run the Nix garbage collector
|
||
to get rid of unused packages, since uninstalls or upgrades don't
|
||
actually delete them:
|
||
|
||
<screen>
|
||
$ nix-collect-garbage -d</screen>
|
||
|
||
<!--
|
||
The first command deletes old “generations” of your profile (making
|
||
rollbacks impossible, but also making the packages in those old
|
||
generations available for garbage collection), while the second
|
||
command actually deletes them.-->
|
||
|
||
</para></step>
|
||
|
||
</procedure>
|
||
|
||
</chapter>
|