<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</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>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>