doc/pages/01.administrate/02.install/07.virtualbox/install_on_virtualbox.md
2021-02-06 22:41:01 +01:00

2.1 KiB

title template taxonomy routes
Install YunoHost on VitualBox docs
category
docs
default
/install_on_virtualbox

Find other ways to install YunoHost here.

Requirements

  • An x86 computer with VirtualBox installed and enough RAM capacity to be able to run a small virtual machine.
  • The latest stable YunoHost ISO image, available here.
N.B. : Installing YunoHost in a VirtualBox is usually intended for testing. To run an actual server on the long-term, you usually need a dedicated physical machine (old computer, ARM board...) or a VPS online.

1. Create a new virtual machine


  • It's okay if you can only have 32-bit versions, just be sure that you downloaded the 32-bit image previously.
  • 256MB RAM is the minimum required, but at least 512MB is recommended (1Go or more if you can).
  • 8GB storage is the minimum required for the system, add whatever is necessary for your apps.

2. Change network settings

NB: You must carry out this step. If not, the install will fail.

Go to Settings > Network:


  • Select Bridged adapter

  • Select your interface's name:

    wlan0 if you are connected wirelessly, else eth0.


3. Boot up the virtual machine

Start the virtual machine


You will have to select your ISO image here, then you should see the YunoHost's boot screen.


If you encounter the error "VT-x is not available", you need probably need to enable Virtualization in the BIOS of your computer.



  • Select Graphical install

  • Select your language, your location, your keyboard layout and let the installer do the rest :-)


4. Proceed to post-installation

After the reboot, the system should ask you to proceed with the post-installation

Post-install documentation