1
0
Fork 0
mirror of https://github.com/NixOS/nix.dev.git synced 2024-10-18 14:32:43 -04:00
nix.dev/source/tutorials/install-nix.rst
Jörg Thalheim 9ca2a9a3f6 add short hacking tutorial for nixpkgs with docker
This example is intentionally a bit more verbose as docker might be used
by upstream authors to test package in nixpkgs without having to install
nix.
2021-09-30 09:12:31 +02:00

86 lines
1.9 KiB
ReStructuredText

.. _install-nix:
Install Nix
===========
Linux
-----
Install Nix on via the recommended `multi-user installation <https://nixos.org/manual/nix/stable/#chap-installation>`_:
.. code:: bash
sh <(curl -L https://nixos.org/nix/install) --daemon
.. note::
For security you may want to `verify the installation script`_ using GPG signatures.
macOS
-----
Install Nix on via the recommended `multi-user installation <https://nixos.org/manual/nix/stable/#chap-installation>`_:
.. code:: bash
sh <(curl -L https://nixos.org/nix/install) --darwin-use-unencrypted-nix-store-volume --daemon
.. note::
For security you may want to `verify the installation script`_ using GPG signatures.
Windows (WSL2)
--------------
Install Nix on via the recommended `single-user installation <https://nixos.org/manual/nix/stable/#chap-installation>`_:
.. code:: bash
sh <(curl -L https://nixos.org/nix/install) --no-daemon
.. note::
For security you may want to `verify the installation script`_ using GPG signatures.
Docker
------
Start a Docker shell with Nix:
.. code:: bash
$ docker run -it nixos/nix
Or start a Docker shell with Nix exposing a ``workdir`` directory:
.. code:: bash
$ mkdir workdir
$ docker run -it -v $(pwd)/workdir:/workdir nixos/nix
The ``workdir`` example from above can be also used to start hacking on nixpkgs:
.. code:: bash
$ git clone git@github.com:NixOS/nixpkgs
$ docker run -it -v $(pwd)/nixpkgs:/nixpkgs nixos/nix
docker> nix-build -I nixpkgs=/nixpkgs -A hello
docker> find ./result # this symlink points to the build package
Verify installation
-------------------
Check that the installation by opening **a new terminal** and typing:
.. code:: bash
$ nix-env --version
nix-env (Nix) 2.3.15
.. _verify the installation script: https://nixos.org/download.html#nix-verify-installation