nixos-rebuild: document cross compilation subtlety

2 years ago · 66a0358a15
parent 8061905942
commit 66a0358a15
1 changed files with 8 additions and 0 deletions
--- a/nixos/doc/manual/man-nixos-rebuild.xml
+++ b/nixos/doc/manual/man-nixos-rebuild.xml
@ -548,6 +548,14 @@
      (<replaceable>user@host</replaceable>). You can also set ssh options by
      defining the <envar>NIX_SSHOPTS</envar> environment variable.
     </para>
+
+     <para>
+      Note that <command>nixos-rebuild</command> honors the
+      <literal>nixpkgs.crossSystem</literal> setting of the given configuration
+      but disregards the true architecture of the target host. Hence the
+      <literal>nixpkgs.crossSystem</literal> setting has to match the target
+      platform or else activation will fail.
+     </para>
    </listitem>
   </varlistentry>