<olclass="chapter"><liclass="chapter-item expanded affix "><ahref="requirements.html">System Requirements</a></li><liclass="chapter-item expanded affix "><ahref="quickstart.html">Quickstart</a></li><liclass="chapter-item expanded affix "><ahref="howtos/INDEX.html">How to Guide</a></li><liclass="chapter-item expanded "><ahref="howtos/no-os.html"><strongaria-hidden="true">1.</strong> Installing on a machine with no operating system</a></li><liclass="chapter-item expanded "><ahref="howtos/custom-kexec.html"><strongaria-hidden="true">2.</strong> Using your own kexec image</a></li><liclass="chapter-item expanded "><ahref="howtos/secrets.html"><strongaria-hidden="true">3.</strong> Secrets and full disk encryption</a></li><liclass="chapter-item expanded "><ahref="howtos/use-without-flakes.html"><strongaria-hidden="true">4.</strong> Use without flakes</a></li><liclass="chapter-item expanded "><ahref="howtos/terraform.html"><strongaria-hidden="true">5.</strong> Terraform</a></li><liclass="chapter-item expanded "><ahref="howtos/nix-path.html"><strongaria-hidden="true">6.</strong> Nix-channels / NIX_PATH</a></li><liclass="chapter-item expanded "><ahref="howtos/ipv6.html"><strongaria-hidden="true">7.</strong> IPv6-only targets</a></li><liclass="chapter-item expanded affix "><ahref="reference.html"class="active">Reference</a></li></ol>
<labelid="sidebar-toggle"class="icon-button"for="sidebar-toggle-anchor"title="Toggle Table of Contents"aria-label="Toggle Table of Contents"aria-controls="sidebar">
<inputtype="search"id="searchbar"name="searchbar"placeholder="Search this book ..."aria-controls="searchresults-outer"aria-describedby="searchresults-header">
<tr><td>1</td><td>Failure unpacking initrd</td><td>You don't have enough RAM to hold <code>kexec</code></td></tr>
<tr><td>2</td><td>Flake <flake_url>does not provide attirbute</td><td>The configuration name you specified in your flake URI is not defined as a NixOS configuration in your flake eg if your URI was mydir#myconfig, then myconfig should be included in the flake as <code>nixosConfigurations.myconfig</code></td></tr>
<tr><td>3</td><td>Please specify the name of the NixOS configuration to be installed, as a URI fragment in the flake-uri.</td><td>As for error #2</td></tr>
<tr><td>4</td><td>Retrieving host facts via ssh failed. Check with --debug for the root cause, unless you have done so already</td><td>TODO: Explain</td></tr>
<tr><td>5</td><td>ssh-host must be set</td><td><ip_address>has not been supplied</td></tr>
<tr><td>6</td><td><disko_script> and <nixos_system> must be existing store-paths</td><td>This occurs if the -s switch has been used to specify the disko script and store path correctly, and the scripts cannot be found at the given URI</td></tr>
<tr><td>7</td><td>flake must be set</td><td>This occurs if both the -flake option (use a flake) and the -s option (specify paths directly) have been omitted. Either one or the other must be specified.</td></tr>
<tr><td>8</td><td>no tar command found, but required to unpack kexec tarball</td><td>The destination machine does not have a <code>tar</code>command available. This is needed to unpack the <code>kexec</code>.</td></tr>
<tr><td>9</td><td>no setsid command found, but required to run the kexec script under a new session</td><td>The destination machine does not have the <code>setsid</code>command available</td></tr>
<tr><td>10</td><td>This script requires Linux as the operating system, but got <operatingsystem></td><td>The destination machine is not running Linux</td></tr>
<tr><td>11</td><td>The default kexec image only support x86_64 cpus. Checkout https://github.com/nix-community/nixos-anywhere/#using-your-own-kexec-image for more information.</td><td>By default, <code>nixos-anywhere</code>uses its own <code>kexec</code>image, which will only run onx86_64 CPUs. For other CPU types, you can use your own <code>kexec</code>image instead. Refer to the <ahref="./howtos#using-your-own-kexec-image">How To Guide</a>for instructions.</td></tr>
<tr><td>12</td><td>Please specify the name of the NixOS configuration to be installed, as a URI fragment in the flake-uri.</td><td>This is a <code>disko</code>error. As for Error #2</td></tr>
<tr><td>13</td><td>mode must be either create, mount or zap_create_mount</td><td>This is a <code>disko</code>error. The <code>disko</code>switches have not been used correctly. This could happen if you supplied your own <code>disko</code>script using the -s option</td></tr>
<tr><td>14</td><td>disko config must be an existing file or flake must be set</td><td>This is a <code>disko</code>error. This will happen if the <code>disko.devices</code>entry in your flake doesn't match the name of a file in the same location as your flake.</td></tr>