diff options
Diffstat (limited to 'nixos/doc/manual/installation/installing-virtualbox-guest.xml')
-rw-r--r-- | nixos/doc/manual/installation/installing-virtualbox-guest.xml | 100 |
1 files changed, 59 insertions, 41 deletions
diff --git a/nixos/doc/manual/installation/installing-virtualbox-guest.xml b/nixos/doc/manual/installation/installing-virtualbox-guest.xml index 2b31b7ed315..da78b480f5a 100644 --- a/nixos/doc/manual/installation/installing-virtualbox-guest.xml +++ b/nixos/doc/manual/installation/installing-virtualbox-guest.xml @@ -3,63 +3,82 @@ xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0" xml:id="sec-instaling-virtualbox-guest"> + <title>Installing in a VirtualBox guest</title> -<title>Installing in a VirtualBox guest</title> -<para> + <para> Installing NixOS into a VirtualBox guest is convenient for users who want to try NixOS without installing it on bare metal. If you want to use a pre-made - VirtualBox appliance, it is available at <link - xlink:href="https://nixos.org/nixos/download.html">the downloads page</link>. - If you want to set up a VirtualBox guest manually, follow these instructions: -</para> - -<orderedlist> - - <listitem><para>Add a New Machine in VirtualBox with OS Type "Linux / Other - Linux"</para></listitem> - - <listitem><para>Base Memory Size: 768 MB or higher.</para></listitem> - - <listitem><para>New Hard Disk of 8 GB or higher.</para></listitem> - - <listitem><para>Mount the CD-ROM with the NixOS ISO (by clicking on - CD/DVD-ROM)</para></listitem> - - <listitem><para>Click on Settings / System / Processor and enable - PAE/NX</para></listitem> - - <listitem><para>Click on Settings / System / Acceleration and enable - "VT-x/AMD-V" acceleration</para></listitem> - - <listitem><para>Save the settings, start the virtual machine, and continue - installation like normal</para></listitem> - -</orderedlist> - -<para> - There are a few modifications you should make in configuration.nix. - Enable booting: -</para> + VirtualBox appliance, it is available at + <link + xlink:href="https://nixos.org/nixos/download.html">the downloads + page</link>. If you want to set up a VirtualBox guest manually, follow these + instructions: + </para> + + <orderedlist> + <listitem> + <para> + Add a New Machine in VirtualBox with OS Type "Linux / Other Linux" + </para> + </listitem> + <listitem> + <para> + Base Memory Size: 768 MB or higher. + </para> + </listitem> + <listitem> + <para> + New Hard Disk of 8 GB or higher. + </para> + </listitem> + <listitem> + <para> + Mount the CD-ROM with the NixOS ISO (by clicking on CD/DVD-ROM) + </para> + </listitem> + <listitem> + <para> + Click on Settings / System / Processor and enable PAE/NX + </para> + </listitem> + <listitem> + <para> + Click on Settings / System / Acceleration and enable "VT-x/AMD-V" + acceleration + </para> + </listitem> + <listitem> + <para> + Save the settings, start the virtual machine, and continue installation + like normal + </para> + </listitem> + </orderedlist> + + <para> + There are a few modifications you should make in configuration.nix. Enable + booting: + </para> <programlisting> <xref linkend="opt-boot.loader.grub.device"/> = "/dev/sda"; </programlisting> -<para> + <para> Also remove the fsck that runs at startup. It will always fail to run, stopping your boot until you press <literal>*</literal>. -</para> + </para> <programlisting> <xref linkend="opt-boot.initrd.checkJournalingFS"/> = false; </programlisting> -<para> + <para> Shared folders can be given a name and a path in the host system in the VirtualBox settings (Machine / Settings / Shared Folders, then click on the "Add" icon). Add the following to the <literal>/etc/nixos/configuration.nix</literal> to auto-mount them: -</para> + </para> <programlisting> { config, pkgs, ...} : @@ -74,8 +93,7 @@ } </programlisting> -<para> + <para> The folder will be available directly under the root directory. -</para> - + </para> </section> |