Beginner’s Guide: How to Install Home Assistant on the Oracle Virtual Box

In this post we’re going to take a look at the easiest way to evaluate Home Assistant on a PC. In the end, you will get a fully operational copy of Home Assistant ( flavor), which can be accessed via browser in your home network.

After this article was published, the official Home Assistant installation page was updated with brief description of the steps given below. You may find it here.

If you’re on Windows, you may also want to check portable version of Home Assistant which does not require any mess with virtual machines, images and other tricky things. It is even more convinient for evaluation since it is up and ready once you download and run it.


  • Home Assistant (HA) - is a top ten’s fastest-growing open-source project (as of 2019) of home automation system written on Python language. It carries on a huge number of components to integrate with the most if not all devices and services on the market
  • Guest - a Virtual Machine with Home Assistant installed
  • Host - a computer with Microsoft Windows/Linux/macOS, with Oracle VirtualBox installed - the framework consisting of a few Docker containers which make it easier to install and upgrade Home Assistant and allows you to install tenths of addons literally in a mouse click.

The screenshots below were taken from macOS version of Oracle VirtualBox, though it should work the same way in other operating systems like Windows or Linux.

Step 1: Install Oracle VirtualBox and use an official image

First of all, we need to download an installation package for your OS here and install it. Then go to Home Assistant site and pick up an official VM image, the one you want is VDI.

Create a new VM (guest) in Oracle VirtualBox, specify Linux 64 bit as “OS Type” and allocate 2-4 Gb of RAM for better performance.


Choose your downloaded VM image in the guest’s storage settings:


Finish the creation wizard, but don’t start your guest yet.

Step 2: Set up the virtual machine

To access Home Assistant UI, we have to adjust the network settings of our guest. Open the Settings and change Network settings so that the guest uses Bridged Adapter instead of NAT:


Another important setting is to Enable EFI in the System tab. Without it your guest will not be able to boot:


Step 3: Run it

Start your guest and open the following URL in your browser: http://xx.xx.xx.xx:8123, where хх.xx.xx.xx is the IP address, assigned to your guest. If you don’t know it, the easiest way is to check the list of devices in your home router/access point settings. If your hardware is not up-to-date, the first boot process may take a few minutes as it includes download and install of recent image from the net.

Using command line

After step 3 you should already be able to access you Home Assistant WEB UI. The following operations are not required and should be performed only if you know why you would need command line access, e.g. for additional control over your HA instance.

It is worth mentioning that this will not provide you with full access to the host OS command line. Instead, this is command line toolset which is running inside a container.

In order to access it, open the guest console and hit Enter to see the welcome prompt:

Welcome to HassOS
hassio login:

Type root and press Enter to login to the


Try to type help to get the list of available commands. You may also edit the configuration file of your Home Assistant instance by the following command:

nano /config/configuration.yaml

To leave the editor, Ctrl+x hotkey can be used.

Our coments are powered by remark42, self-hosted, privacy-focused open source comment engine, which doesn't spy on users.

Since we know nothing about you, consider subscribing to the comments' Telegram channel to keep track of comments on this site.