mirror of
https://github.com/nix-community/nixos-anywhere.git
synced 2024-09-11 08:35:24 +03:00
deploy: 9c3de7d78d
This commit is contained in:
parent
cd0881c565
commit
fe2d644b3f
@ -1,2 +1,2 @@
|
||||
cp -r /nix/store/4gxjah5hrlya0k7bs7ds27h9yvcjnrj5-source/* .
|
||||
cp -r /nix/store/brphj9r0yk4d5ynqgfxb0dr6i2rmkb5g-source/* .
|
||||
/nix/store/gf0d0bykf1d1apzdgnlb5881nh0wm9fw-mdbook-0.4.35/bin/mdbook build --dest-dir "$out"
|
||||
|
6
env-vars
6
env-vars
@ -3,10 +3,10 @@ declare -x HOME="/homeless-shelter"
|
||||
declare -x HOST_PATH="/nix/store/bblyj5b3ii8n6v4ra0nb37cmi3lf8rz9-coreutils-9.3/bin:/nix/store/l974pi8a5yqjrjlzmg6apk0jwjv81yqw-findutils-4.9.0/bin:/nix/store/8q25nyfirzsng6p57yp8hsaldqqbc7dg-diffutils-3.10/bin:/nix/store/9c5qm297qnvwcf7j0gm01qrslbiqz8rs-gnused-4.9/bin:/nix/store/rx2wig5yhpbwhnqxdy4z7qivj9ln7fab-gnugrep-3.11/bin:/nix/store/7wfya2k95zib8jl0jk5hnbn856sqcgfk-gawk-5.2.2/bin:/nix/store/xpidksbd07in3nd4sjx79ybwwy81b338-gnutar-1.35/bin:/nix/store/202iqv4bd7lh6f7fpy48p7q4d96lqdp7-gzip-1.13/bin:/nix/store/ik7jardq92dxw3fnz3vmlcgi9c8dwwdq-bzip2-1.0.8-bin/bin:/nix/store/v4iswb5kwj33l46dyh2zqh0nkxxlr3mz-gnumake-4.4.1/bin:/nix/store/q1c2flcykgr4wwg5a6h450hxbk4ch589-bash-5.2-p15/bin:/nix/store/cbj1ph7zi009m53hxs90idl1f5i9i941-patch-2.7.6/bin:/nix/store/76z4cjs7jj45ixk12yy6k5z2q2djk2jb-xz-5.4.4-bin/bin:/nix/store/qmfxld7qhk8qxlkx1cm4bkplg1gh6jgj-file-5.45/bin"
|
||||
declare -x NIX_BUILD_CORES="4"
|
||||
declare -x NIX_BUILD_TOP="/build"
|
||||
declare -x NIX_CFLAGS_COMPILE=" -frandom-seed=j6233fgr77"
|
||||
declare -x NIX_CFLAGS_COMPILE=" -frandom-seed=ilb1icqi7f"
|
||||
declare -x NIX_ENFORCE_NO_NATIVE="1"
|
||||
declare -x NIX_ENFORCE_PURITY="1"
|
||||
declare -x NIX_LDFLAGS="-rpath /nix/store/j6233fgr773gc7y15l9d9cxk7298rkpf-nixos-anywhere-docs/lib "
|
||||
declare -x NIX_LDFLAGS="-rpath /nix/store/ilb1icqi7f6nqhxqwiwv8zfx5zkrpcw8-nixos-anywhere-docs/lib "
|
||||
declare -x NIX_LOG_FD="2"
|
||||
declare -x NIX_SSL_CERT_FILE="/no-cert-file.crt"
|
||||
declare -x NIX_STORE="/nix/store"
|
||||
@ -46,7 +46,7 @@ declare -x enableParallelInstalling="1"
|
||||
declare -x mesonFlags=""
|
||||
declare -x name="nixos-anywhere-docs"
|
||||
declare -x nativeBuildInputs=""
|
||||
declare -x out="/nix/store/j6233fgr773gc7y15l9d9cxk7298rkpf-nixos-anywhere-docs"
|
||||
declare -x out="/nix/store/ilb1icqi7f6nqhxqwiwv8zfx5zkrpcw8-nixos-anywhere-docs"
|
||||
declare -x outputs="out"
|
||||
declare -x passAsFile="buildCommand"
|
||||
declare -x patches=""
|
||||
|
@ -173,7 +173,7 @@
|
||||
<main>
|
||||
<h1 id="how-to-guide-nixos-anywhere"><a class="header" href="#how-to-guide-nixos-anywhere">How To Guide: nixos-anywhere</a></h1>
|
||||
<p><strong><em>Install NixOS everywhere via ssh</em></strong></p>
|
||||
<img title="" src="https://raw.githubusercontent.com/numtide/nixos-anywhere/main/docs/logo.png" alt="" width="129">
|
||||
<img title="" src="https://raw.githubusercontent.com/nix-community/nixos-anywhere/main/docs/logo.png" alt="" width="129">
|
||||
<p><a href="./INDEX.html">Documentation Index</a></p>
|
||||
<h2 id="contents"><a class="header" href="#contents">Contents</a></h2>
|
||||
<p><a href="./no-os.html">Installing on a machine with no operating system</a></p>
|
||||
|
@ -181,7 +181,7 @@ and <code>aarch64</code>, since they don't have a pre-build image.</p>
|
||||
image file. The image will be uploaded prior to execution.</p>
|
||||
<p>Here's an example command that demonstrates how to use a custom kexec image with
|
||||
<code>nixos-anywhere</code>:</p>
|
||||
<pre><code>nix run github:numtide/nixos-anywhere -- \
|
||||
<pre><code>nix run github:nix-community/nixos-anywhere -- \
|
||||
--kexec "$(nix build --print-out-paths github:nix-community/nixos-images#packages.aarch64-linux.kexec-installer-nixos-unstable-noninteractive)/nixos-kexec-installer-noninteractive-aarch64-linux.tar.gz" \
|
||||
--flake 'github:your-user/your-repo#your-system' \
|
||||
root@yourip
|
||||
|
@ -220,7 +220,7 @@ SSH command (replace the IP address with your own):</p>
|
||||
<pre><code>ssh -v nixos@fec0::5054:ff:fe12:3456
|
||||
</code></pre>
|
||||
<p>You can then use the IP address to run <code>nixos-anywhere</code> like this:</p>
|
||||
<pre><code>nix run github:numtide/nixos-anywhere -- --flake '.#myconfig' nixos@fec0::5054:ff:fe12:3456
|
||||
<pre><code>nix run github:nix-community/nixos-anywhere -- --flake '.#myconfig' nixos@fec0::5054:ff:fe12:3456
|
||||
</code></pre>
|
||||
<p>This example assumes a flake in the curent directory containing a configuration
|
||||
named <code>myconfig</code>.</p>
|
||||
|
@ -185,7 +185,7 @@ provider.</p>
|
||||
<p>You can add this expression the <code>packages</code> list in your devshell in flake.nix or
|
||||
in shell.nix.</p>
|
||||
<p>Checkout out the
|
||||
<a href="https://github.com/numtide/nixos-anywhere/tree/main/terraform">module reference</a>
|
||||
<a href="https://github.com/nix-community/nixos-anywhere/tree/main/terraform">module reference</a>
|
||||
for examples and module parameter on how to use the modules.</p>
|
||||
|
||||
</main>
|
||||
|
@ -173,7 +173,7 @@
|
||||
<main>
|
||||
<h1 id="system-requirements-nixos-anywhere"><a class="header" href="#system-requirements-nixos-anywhere">System Requirements: nixos-anywhere</a></h1>
|
||||
<p><strong><em>Install NixOS everywhere via ssh</em></strong></p>
|
||||
<img src="https://raw.githubusercontent.com/numtide/nixos-anywhere/main/docs/logo.png" width="150" height="150">
|
||||
<img src="https://raw.githubusercontent.com/nix-community/nixos-anywhere/main/docs/logo.png" width="150" height="150">
|
||||
<p><a href="./INDEX.html">Documentation Index</a></p>
|
||||
<h2 id="requirements"><a class="header" href="#requirements">Requirements</a></h2>
|
||||
<h3 id="source-machine"><a class="header" href="#source-machine">Source Machine:</a></h3>
|
||||
|
36
print.html
36
print.html
@ -174,7 +174,7 @@
|
||||
<main>
|
||||
<h1 id="system-requirements-nixos-anywhere"><a class="header" href="#system-requirements-nixos-anywhere">System Requirements: nixos-anywhere</a></h1>
|
||||
<p><strong><em>Install NixOS everywhere via ssh</em></strong></p>
|
||||
<img src="https://raw.githubusercontent.com/numtide/nixos-anywhere/main/docs/logo.png" width="150" height="150">
|
||||
<img src="https://raw.githubusercontent.com/nix-community/nixos-anywhere/main/docs/logo.png" width="150" height="150">
|
||||
<p><a href="./INDEX.html">Documentation Index</a></p>
|
||||
<h2 id="requirements"><a class="header" href="#requirements">Requirements</a></h2>
|
||||
<h3 id="source-machine"><a class="header" href="#source-machine">Source Machine:</a></h3>
|
||||
@ -228,7 +228,7 @@ manually.</li>
|
||||
</ol>
|
||||
<div style="break-before: page; page-break-before: always;"></div><h1 id="quickstart-guide-nixos-anywhere"><a class="header" href="#quickstart-guide-nixos-anywhere">Quickstart Guide: nixos-anywhere</a></h1>
|
||||
<p><strong><em>Install NixOS everywhere via ssh</em></strong></p>
|
||||
<img src="https://raw.githubusercontent.com/numtide/nixos-anywhere/main/docs/logo.png" width="150" height="150">
|
||||
<img src="https://raw.githubusercontent.com/nix-community/nixos-anywhere/main/docs/logo.png" width="150" height="150">
|
||||
<p><a href="./INDEX.html">Documentation Index</a></p>
|
||||
<h2 id="introduction"><a class="header" href="#introduction">Introduction</a></h2>
|
||||
<p>This guide documents a simple installation of NixOS using <strong>nixos-anywhere</strong> on
|
||||
@ -247,7 +247,7 @@ created on the new server.</li>
|
||||
the privilege to either login directly as root or to use password-less sudo.</li>
|
||||
</ul>
|
||||
<p><strong>nixos-anywhere</strong> doesn’t need to be installed. You can run it directly from
|
||||
<a href="https://github.com/numtide/nixos-anywhere">Numtide's repository on Github.</a></p>
|
||||
<a href="https://github.com/nix-community/nixos-anywhere">Numtide's repository on Github.</a></p>
|
||||
<p>Details of the flake, the disk configuration and the CLI command are discussed
|
||||
below.</p>
|
||||
<h2 id="steps-required-to-run-nixos-anywhere"><a class="header" href="#steps-required-to-run-nixos-anywhere">Steps required to run nixos-anywhere</a></h2>
|
||||
@ -260,7 +260,7 @@ below.</p>
|
||||
<li>
|
||||
<p><strong>Initialize a Flake</strong>:</p>
|
||||
<p>The easiest way to start is to copy our
|
||||
<a href="https://github.com/numtide/nixos-anywhere-examples/blob/main/flake.nix">example flake.nix</a>
|
||||
<a href="https://github.com/nix-community/nixos-anywhere-examples/blob/main/flake.nix">example flake.nix</a>
|
||||
into a new directory. This example is tailored for a virtual machine setup
|
||||
similar to one on <a href="https://www.hetzner.com/cloud">Hetzner Cloud</a>, so you
|
||||
might need to adapt it for your setup.</p>
|
||||
@ -292,7 +292,7 @@ to include them in your flake.</p>
|
||||
<li>
|
||||
<p><strong>Find SSH Key Line</strong>:<br />
|
||||
if you cloned
|
||||
<a href="https://github.com/numtide/nixos-anywhere-examples/blob/main/configuration.nix">our nixos-anywhere-example</a>
|
||||
<a href="https://github.com/nix-community/nixos-anywhere-examples/blob/main/configuration.nix">our nixos-anywhere-example</a>
|
||||
you will also replace the SSH key like this: In your configuration, locate
|
||||
the line that reads:</p>
|
||||
<pre><code class="language-bash"># change this to your ssh key
|
||||
@ -306,7 +306,7 @@ not be able to log into the target machine post-installation without it.</p>
|
||||
used to specify the disk layout to the <strong>disko</strong> tool, which nixos-anywhere
|
||||
uses to partition, format and mount the disks. Again, for a simple
|
||||
installation you can paste the contents from the example
|
||||
<a href="https://github.com/numtide/nixos-anywhere-examples/blob/main/disk-config.nix">here</a>.
|
||||
<a href="https://github.com/nix-community/nixos-anywhere-examples/blob/main/disk-config.nix">here</a>.
|
||||
This configures a standard GPT (GUID Partition Table) partition compatible
|
||||
with both EFI and BIOS systems, and mounts the disk as <code>/dev/sda</code>. If this
|
||||
doesn’t meet your requirements, choose an example that suits your disk layout
|
||||
@ -340,10 +340,10 @@ containing <code>flake.nix</code> and <code>disk-config.nix</code></p>
|
||||
<p><code><configuration name></code> must match the name that immediately follows the
|
||||
text <code>nixosConfigurations.</code> in the flake, as indicated by the comment in
|
||||
the
|
||||
<a href="https://github.com/numtide/nixos-anywhere-examples/blob/main/flake.nix">example</a>).</p>
|
||||
<a href="https://github.com/nix-community/nixos-anywhere-examples/blob/main/flake.nix">example</a>).</p>
|
||||
</li>
|
||||
</ul>
|
||||
<pre><code>nix run github:numtide/nixos-anywhere -- --flake <path to configuration>#<configuration name> --vm-test
|
||||
<pre><code>nix run github:nix-community/nixos-anywhere -- --flake <path to configuration>#<configuration name> --vm-test
|
||||
</code></pre>
|
||||
</li>
|
||||
<li>
|
||||
@ -358,16 +358,16 @@ containing <code>flake.nix</code> and <code>disk-config.nix</code></p>
|
||||
<p><code><configuration name></code> must match the name that immediately follows the
|
||||
text <code>nixosConfigurations.</code> in the flake, as indicated by the comment in
|
||||
the
|
||||
<a href="https://github.com/numtide/nixos-anywhere-examples/blob/main/flake.nix">example</a>).</p>
|
||||
<a href="https://github.com/nix-community/nixos-anywhere-examples/blob/main/flake.nix">example</a>).</p>
|
||||
</li>
|
||||
<li>
|
||||
<p><code><ip address></code> is the IP address of the target machine.</p>
|
||||
<pre><code>nix run github:numtide/nixos-anywhere -- --flake <path to configuration>#<configuration name> root@<ip address>
|
||||
<pre><code>nix run github:nix-community/nixos-anywhere -- --flake <path to configuration>#<configuration name> root@<ip address>
|
||||
</code></pre>
|
||||
<p>The command would look like this if you had created your files in a
|
||||
directory named <code>/home/mydir/test</code> and the IP address of your target
|
||||
machine is <code>37.27.18.135</code>:</p>
|
||||
<pre><code>nix run github:numtide/nixos-anywhere -- --flake /home/mydir/test#hetzner-cloud root@37.27.18.135
|
||||
<pre><code>nix run github:nix-community/nixos-anywhere -- --flake /home/mydir/test#hetzner-cloud root@37.27.18.135
|
||||
</code></pre>
|
||||
<p><strong>nixos-anywhere</strong> will then run, showing various output messages at each
|
||||
stage. It may take some time to complete, depending on Internet speeds. It
|
||||
@ -429,7 +429,7 @@ information and explanation of known error messages, refer to the
|
||||
</ol>
|
||||
<div style="break-before: page; page-break-before: always;"></div><h1 id="how-to-guide-nixos-anywhere"><a class="header" href="#how-to-guide-nixos-anywhere">How To Guide: nixos-anywhere</a></h1>
|
||||
<p><strong><em>Install NixOS everywhere via ssh</em></strong></p>
|
||||
<img title="" src="https://raw.githubusercontent.com/numtide/nixos-anywhere/main/docs/logo.png" alt="" width="129">
|
||||
<img title="" src="https://raw.githubusercontent.com/nix-community/nixos-anywhere/main/docs/logo.png" alt="" width="129">
|
||||
<p><a href="howtos/./INDEX.html">Documentation Index</a></p>
|
||||
<h2 id="contents"><a class="header" href="#contents">Contents</a></h2>
|
||||
<p><a href="howtos/./no-os.html">Installing on a machine with no operating system</a></p>
|
||||
@ -488,7 +488,7 @@ SSH command (replace the IP address with your own):</p>
|
||||
<pre><code>ssh -v nixos@fec0::5054:ff:fe12:3456
|
||||
</code></pre>
|
||||
<p>You can then use the IP address to run <code>nixos-anywhere</code> like this:</p>
|
||||
<pre><code>nix run github:numtide/nixos-anywhere -- --flake '.#myconfig' nixos@fec0::5054:ff:fe12:3456
|
||||
<pre><code>nix run github:nix-community/nixos-anywhere -- --flake '.#myconfig' nixos@fec0::5054:ff:fe12:3456
|
||||
</code></pre>
|
||||
<p>This example assumes a flake in the curent directory containing a configuration
|
||||
named <code>myconfig</code>.</p>
|
||||
@ -502,7 +502,7 @@ and <code>aarch64</code>, since they don't have a pre-build image.</p>
|
||||
image file. The image will be uploaded prior to execution.</p>
|
||||
<p>Here's an example command that demonstrates how to use a custom kexec image with
|
||||
<code>nixos-anywhere</code>:</p>
|
||||
<pre><code>nix run github:numtide/nixos-anywhere -- \
|
||||
<pre><code>nix run github:nix-community/nixos-anywhere -- \
|
||||
--kexec "$(nix build --print-out-paths github:nix-community/nixos-images#packages.aarch64-linux.kexec-installer-nixos-unstable-noninteractive)/nixos-kexec-installer-noninteractive-aarch64-linux.tar.gz" \
|
||||
--flake 'github:your-user/your-repo#your-system' \
|
||||
root@yourip
|
||||
@ -633,7 +633,7 @@ provider.</p>
|
||||
<p>You can add this expression the <code>packages</code> list in your devshell in flake.nix or
|
||||
in shell.nix.</p>
|
||||
<p>Checkout out the
|
||||
<a href="https://github.com/numtide/nixos-anywhere/tree/main/terraform">module reference</a>
|
||||
<a href="https://github.com/nix-community/nixos-anywhere/tree/main/terraform">module reference</a>
|
||||
for examples and module parameter on how to use the modules.</p>
|
||||
<div style="break-before: page; page-break-before: always;"></div><h1 id="nix-channels--nix_path"><a class="header" href="#nix-channels--nix_path">Nix-channels / <code>NIX_PATH</code></a></h1>
|
||||
<p>nixos-anywhere does not install channels onto the new system by default to save
|
||||
@ -693,7 +693,7 @@ possible to use an ipv6 proxy for github content like that:</p>
|
||||
<p>This tarball will be than uploaded via sftp to the target.</p>
|
||||
<div style="break-before: page; page-break-before: always;"></div><h1 id="reference-manual-nixos-anywhere"><a class="header" href="#reference-manual-nixos-anywhere">Reference Manual: nixos-anywhere</a></h1>
|
||||
<p><strong><em>Install NixOS everywhere via ssh</em></strong></p>
|
||||
<img title="" src="https://raw.githubusercontent.com/numtide/nixos-anywhere/main/docs/logo.png" alt="" width="141">
|
||||
<img title="" src="https://raw.githubusercontent.com/nix-community/nixos-anywhere/main/docs/logo.png" alt="" width="141">
|
||||
<p><a href="./INDEX.html">Documentation Index</a></p>
|
||||
<p>TODO: Populate this guide properly</p>
|
||||
<h2 id="contents-1"><a class="header" href="#contents-1">Contents</a></h2>
|
||||
@ -753,7 +753,7 @@ Options:
|
||||
<p>TODO: Add additional error messages and meanings. Fill in missing explanations</p>
|
||||
<p>This section lists known error messages and their explanations. Some
|
||||
explanations may refer to the following CLI syntax:</p>
|
||||
<p><code>nix run github:numtide/nixos-anywhere -- --flake <path to configuration>#<configuration name> root@<ip address></code></p>
|
||||
<p><code>nix run github:nix-community/nixos-anywhere -- --flake <path to configuration>#<configuration name> root@<ip address></code></p>
|
||||
<p>This list is not comprehensive. It's possible you may encounter errors that
|
||||
originate from the underlying operating system. These should be documented in
|
||||
the relevant operating system manual.</p>
|
||||
@ -769,7 +769,7 @@ the relevant operating system manual.</p>
|
||||
<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 <operating system></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/numtide/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 on x86_64 CPUs. For other CPU types, you can use your own <code>kexec</code> image instead. Refer to the <a href="./howtos#using-your-own-kexec-image">How To Guide</a> for instructions.</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 on x86_64 CPUs. For other CPU types, you can use your own <code>kexec</code> image instead. Refer to the <a href="./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></td><td>For example, to use the output diskoConfigurations.foo from the flake.nix, append "#foo" to the flake-uri.</td><td></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>
|
||||
|
@ -173,7 +173,7 @@
|
||||
<main>
|
||||
<h1 id="quickstart-guide-nixos-anywhere"><a class="header" href="#quickstart-guide-nixos-anywhere">Quickstart Guide: nixos-anywhere</a></h1>
|
||||
<p><strong><em>Install NixOS everywhere via ssh</em></strong></p>
|
||||
<img src="https://raw.githubusercontent.com/numtide/nixos-anywhere/main/docs/logo.png" width="150" height="150">
|
||||
<img src="https://raw.githubusercontent.com/nix-community/nixos-anywhere/main/docs/logo.png" width="150" height="150">
|
||||
<p><a href="./INDEX.html">Documentation Index</a></p>
|
||||
<h2 id="introduction"><a class="header" href="#introduction">Introduction</a></h2>
|
||||
<p>This guide documents a simple installation of NixOS using <strong>nixos-anywhere</strong> on
|
||||
@ -192,7 +192,7 @@ created on the new server.</li>
|
||||
the privilege to either login directly as root or to use password-less sudo.</li>
|
||||
</ul>
|
||||
<p><strong>nixos-anywhere</strong> doesn’t need to be installed. You can run it directly from
|
||||
<a href="https://github.com/numtide/nixos-anywhere">Numtide's repository on Github.</a></p>
|
||||
<a href="https://github.com/nix-community/nixos-anywhere">Numtide's repository on Github.</a></p>
|
||||
<p>Details of the flake, the disk configuration and the CLI command are discussed
|
||||
below.</p>
|
||||
<h2 id="steps-required-to-run-nixos-anywhere"><a class="header" href="#steps-required-to-run-nixos-anywhere">Steps required to run nixos-anywhere</a></h2>
|
||||
@ -205,7 +205,7 @@ below.</p>
|
||||
<li>
|
||||
<p><strong>Initialize a Flake</strong>:</p>
|
||||
<p>The easiest way to start is to copy our
|
||||
<a href="https://github.com/numtide/nixos-anywhere-examples/blob/main/flake.nix">example flake.nix</a>
|
||||
<a href="https://github.com/nix-community/nixos-anywhere-examples/blob/main/flake.nix">example flake.nix</a>
|
||||
into a new directory. This example is tailored for a virtual machine setup
|
||||
similar to one on <a href="https://www.hetzner.com/cloud">Hetzner Cloud</a>, so you
|
||||
might need to adapt it for your setup.</p>
|
||||
@ -237,7 +237,7 @@ to include them in your flake.</p>
|
||||
<li>
|
||||
<p><strong>Find SSH Key Line</strong>:<br />
|
||||
if you cloned
|
||||
<a href="https://github.com/numtide/nixos-anywhere-examples/blob/main/configuration.nix">our nixos-anywhere-example</a>
|
||||
<a href="https://github.com/nix-community/nixos-anywhere-examples/blob/main/configuration.nix">our nixos-anywhere-example</a>
|
||||
you will also replace the SSH key like this: In your configuration, locate
|
||||
the line that reads:</p>
|
||||
<pre><code class="language-bash"># change this to your ssh key
|
||||
@ -251,7 +251,7 @@ not be able to log into the target machine post-installation without it.</p>
|
||||
used to specify the disk layout to the <strong>disko</strong> tool, which nixos-anywhere
|
||||
uses to partition, format and mount the disks. Again, for a simple
|
||||
installation you can paste the contents from the example
|
||||
<a href="https://github.com/numtide/nixos-anywhere-examples/blob/main/disk-config.nix">here</a>.
|
||||
<a href="https://github.com/nix-community/nixos-anywhere-examples/blob/main/disk-config.nix">here</a>.
|
||||
This configures a standard GPT (GUID Partition Table) partition compatible
|
||||
with both EFI and BIOS systems, and mounts the disk as <code>/dev/sda</code>. If this
|
||||
doesn’t meet your requirements, choose an example that suits your disk layout
|
||||
@ -285,10 +285,10 @@ containing <code>flake.nix</code> and <code>disk-config.nix</code></p>
|
||||
<p><code><configuration name></code> must match the name that immediately follows the
|
||||
text <code>nixosConfigurations.</code> in the flake, as indicated by the comment in
|
||||
the
|
||||
<a href="https://github.com/numtide/nixos-anywhere-examples/blob/main/flake.nix">example</a>).</p>
|
||||
<a href="https://github.com/nix-community/nixos-anywhere-examples/blob/main/flake.nix">example</a>).</p>
|
||||
</li>
|
||||
</ul>
|
||||
<pre><code>nix run github:numtide/nixos-anywhere -- --flake <path to configuration>#<configuration name> --vm-test
|
||||
<pre><code>nix run github:nix-community/nixos-anywhere -- --flake <path to configuration>#<configuration name> --vm-test
|
||||
</code></pre>
|
||||
</li>
|
||||
<li>
|
||||
@ -303,16 +303,16 @@ containing <code>flake.nix</code> and <code>disk-config.nix</code></p>
|
||||
<p><code><configuration name></code> must match the name that immediately follows the
|
||||
text <code>nixosConfigurations.</code> in the flake, as indicated by the comment in
|
||||
the
|
||||
<a href="https://github.com/numtide/nixos-anywhere-examples/blob/main/flake.nix">example</a>).</p>
|
||||
<a href="https://github.com/nix-community/nixos-anywhere-examples/blob/main/flake.nix">example</a>).</p>
|
||||
</li>
|
||||
<li>
|
||||
<p><code><ip address></code> is the IP address of the target machine.</p>
|
||||
<pre><code>nix run github:numtide/nixos-anywhere -- --flake <path to configuration>#<configuration name> root@<ip address>
|
||||
<pre><code>nix run github:nix-community/nixos-anywhere -- --flake <path to configuration>#<configuration name> root@<ip address>
|
||||
</code></pre>
|
||||
<p>The command would look like this if you had created your files in a
|
||||
directory named <code>/home/mydir/test</code> and the IP address of your target
|
||||
machine is <code>37.27.18.135</code>:</p>
|
||||
<pre><code>nix run github:numtide/nixos-anywhere -- --flake /home/mydir/test#hetzner-cloud root@37.27.18.135
|
||||
<pre><code>nix run github:nix-community/nixos-anywhere -- --flake /home/mydir/test#hetzner-cloud root@37.27.18.135
|
||||
</code></pre>
|
||||
<p><strong>nixos-anywhere</strong> will then run, showing various output messages at each
|
||||
stage. It may take some time to complete, depending on Internet speeds. It
|
||||
|
@ -173,7 +173,7 @@
|
||||
<main>
|
||||
<h1 id="reference-manual-nixos-anywhere"><a class="header" href="#reference-manual-nixos-anywhere">Reference Manual: nixos-anywhere</a></h1>
|
||||
<p><strong><em>Install NixOS everywhere via ssh</em></strong></p>
|
||||
<img title="" src="https://raw.githubusercontent.com/numtide/nixos-anywhere/main/docs/logo.png" alt="" width="141">
|
||||
<img title="" src="https://raw.githubusercontent.com/nix-community/nixos-anywhere/main/docs/logo.png" alt="" width="141">
|
||||
<p><a href="./INDEX.html">Documentation Index</a></p>
|
||||
<p>TODO: Populate this guide properly</p>
|
||||
<h2 id="contents"><a class="header" href="#contents">Contents</a></h2>
|
||||
@ -233,7 +233,7 @@ Options:
|
||||
<p>TODO: Add additional error messages and meanings. Fill in missing explanations</p>
|
||||
<p>This section lists known error messages and their explanations. Some
|
||||
explanations may refer to the following CLI syntax:</p>
|
||||
<p><code>nix run github:numtide/nixos-anywhere -- --flake <path to configuration>#<configuration name> root@<ip address></code></p>
|
||||
<p><code>nix run github:nix-community/nixos-anywhere -- --flake <path to configuration>#<configuration name> root@<ip address></code></p>
|
||||
<p>This list is not comprehensive. It's possible you may encounter errors that
|
||||
originate from the underlying operating system. These should be documented in
|
||||
the relevant operating system manual.</p>
|
||||
@ -249,7 +249,7 @@ the relevant operating system manual.</p>
|
||||
<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 <operating system></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/numtide/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 on x86_64 CPUs. For other CPU types, you can use your own <code>kexec</code> image instead. Refer to the <a href="./howtos#using-your-own-kexec-image">How To Guide</a> for instructions.</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 on x86_64 CPUs. For other CPU types, you can use your own <code>kexec</code> image instead. Refer to the <a href="./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></td><td>For example, to use the output diskoConfigurations.foo from the flake.nix, append "#foo" to the flake-uri.</td><td></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>
|
||||
|
@ -173,7 +173,7 @@
|
||||
<main>
|
||||
<h1 id="system-requirements-nixos-anywhere"><a class="header" href="#system-requirements-nixos-anywhere">System Requirements: nixos-anywhere</a></h1>
|
||||
<p><strong><em>Install NixOS everywhere via ssh</em></strong></p>
|
||||
<img src="https://raw.githubusercontent.com/numtide/nixos-anywhere/main/docs/logo.png" width="150" height="150">
|
||||
<img src="https://raw.githubusercontent.com/nix-community/nixos-anywhere/main/docs/logo.png" width="150" height="150">
|
||||
<p><a href="./INDEX.html">Documentation Index</a></p>
|
||||
<h2 id="requirements"><a class="header" href="#requirements">Requirements</a></h2>
|
||||
<h3 id="source-machine"><a class="header" href="#source-machine">Source Machine:</a></h3>
|
||||
|
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
Loading…
Reference in New Issue
Block a user