doc/install_on_virtualbox.md
2019-08-11 10:33:37 +02:00

2.8 KiB

Install YunoHost on VitualBox

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.
The current installation using our Virtualbox / x86 ISO is broken and will fail for now... We are investigating the issue [here](https://github.com/YunoHost/issues/issues/1382). In the meantime, a workaround is to use the official Debian 9.x (not 10 !) image and install YunoHost on top of it as explained [here](https://yunohost.org/#/install_on_debian)
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.

2. Change network settings

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