diff options
author | obadz <obadz-git@obadz.com> | 2016-07-24 14:45:24 +0100 |
---|---|---|
committer | obadz <obadz-git@obadz.com> | 2016-08-04 16:22:25 +0100 |
commit | 037d9c6cab17a5dc28ed01c6b96c74e55cee57bc (patch) | |
tree | e284b9452ed21d41982f39b916f7158972df0f30 /nixos/doc/manual/man-nixos-install.xml | |
parent | 4eef7a4ecf28859c93b647d032e5ee5fe0731256 (diff) | |
download | nixpkgs-037d9c6cab17a5dc28ed01c6b96c74e55cee57bc.tar nixpkgs-037d9c6cab17a5dc28ed01c6b96c74e55cee57bc.tar.gz nixpkgs-037d9c6cab17a5dc28ed01c6b96c74e55cee57bc.tar.bz2 nixpkgs-037d9c6cab17a5dc28ed01c6b96c74e55cee57bc.tar.lz nixpkgs-037d9c6cab17a5dc28ed01c6b96c74e55cee57bc.tar.xz nixpkgs-037d9c6cab17a5dc28ed01c6b96c74e55cee57bc.tar.zst nixpkgs-037d9c6cab17a5dc28ed01c6b96c74e55cee57bc.zip |
nixos-install: add options --closure, --no-channel-copy, --no-root-passwd, and --no-bootloader
Closes #17236 nix-build -A tests.installer.simple '<nixos/release.nix>' succeeds ✓
Diffstat (limited to 'nixos/doc/manual/man-nixos-install.xml')
-rw-r--r-- | nixos/doc/manual/man-nixos-install.xml | 33 |
1 files changed, 30 insertions, 3 deletions
diff --git a/nixos/doc/manual/man-nixos-install.xml b/nixos/doc/manual/man-nixos-install.xml index 7ad1be1ec10..15c603256ca 100644 --- a/nixos/doc/manual/man-nixos-install.xml +++ b/nixos/doc/manual/man-nixos-install.xml @@ -26,6 +26,19 @@ <replaceable>root</replaceable> </arg> <arg> + <arg choice='plain'><option>--closure</option></arg> + <replaceable>closure</replaceable> + </arg> + <arg> + <arg choice='plain'><option>--no-channel-copy</option></arg> + </arg> + <arg> + <arg choice='plain'><option>--no-root-passwd</option></arg> + </arg> + <arg> + <arg choice='plain'><option>--no-bootloader</option></arg> + </arg> + <arg> <group choice='req'> <arg choice='plain'><option>--max-jobs</option></arg> <arg choice='plain'><option>-j</option></arg> @@ -71,12 +84,13 @@ the following steps: <filename>/mnt/etc/nixos/configuration.nix</filename>.</para></listitem> <listitem><para>It installs the GRUB boot loader on the device - specified in the option <option>boot.loader.grub.device</option>, + specified in the option <option>boot.loader.grub.device</option> + (unless <option>--no-bootloader</option> is specified), and generates a GRUB configuration file that boots into the NixOS configuration just installed.</para></listitem> - <listitem><para>It prompts you for a password for the root - account.</para></listitem> + <listitem><para>It prompts you for a password for the root account + (unless <option>--no-root-passwd</option> is specified).</para></listitem> </itemizedlist> @@ -104,6 +118,19 @@ it.</para> </varlistentry> <varlistentry> + <term><option>--closure</option></term> + <listitem> + <para>If this option is provided, <command>nixos-install</command> will install the specified closure + rather than attempt to build one from <filename>/mnt/etc/nixos/configuration.nix</filename>.</para> + + <para>The closure must be an appropriately configured NixOS system, with boot loader and partition + configuration that fits the target host. Such a closure is typically obtained with a command such as + <command>nix-build -I nixos-config=./configuration.nix '<nixos>' -A system --no-out-link</command> + </para> + </listitem> + </varlistentry> + + <varlistentry> <term><option>-I</option></term> <listitem> <para>Add a path to the Nix expression search path. This option may be given multiple times. |