From bffb1cf14160f5fdb6f9afbd96b6c083391a2460 Mon Sep 17 00:00:00 2001 From: Sebastien Bourdeauducq Date: Tue, 5 Mar 2019 21:23:04 +0800 Subject: [PATCH] manual: suggest faster and less memory-intensive nix-env command Simple "nix-env -i" is slow and runs out of memory on old computers. https://github.com/NixOS/nix/issues/421 --- doc/manual/installing.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/manual/installing.rst b/doc/manual/installing.rst index b11d122ff..6c539414b 100644 --- a/doc/manual/installing.rst +++ b/doc/manual/installing.rst @@ -37,7 +37,7 @@ Nix won't install packages without verifying their cryptographic signature. Add substituters = https://cache.nixos.org https://nixbld.m-labs.hk trusted-public-keys = cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY= nixbld.m-labs.hk-1:5aSRVA5b320xbNvu30tqxVPXpld73bhtOeH6uAjRyHc= -The easiest way to obtain ARTIQ is then to install it into the user environment with ``$ nix-env -i python3.6-artiq``. This provides a minimal installation of ARTIQ where the usual commands (``artiq_master``, ``artiq_dashboard``, ``artiq_run``, etc.) are available. +The easiest way to obtain ARTIQ is then to install it into the user environment with ``$ nix-env -f "" -iA artiq``. This provides a minimal installation of ARTIQ where the usual commands (``artiq_master``, ``artiq_dashboard``, ``artiq_run``, etc.) are available. This installation is however quite limited, as Nix creates a dedicated Python environment for the ARTIQ commands alone. This means that other useful Python packages that you may want (pandas, matplotlib, ...) are not available to them, and this restriction also applies to the M-Labs packages containing board binaries, which means that ``artiq_flash`` will not automatically find them.