How to set up Camio Box in Oracle VirtualBox

Camio provides an image of the Camio Box software that can be run inside of Oracle VirtualBox. Virtual Machines made from this image will act just like a physical Camio Box on your local network.

What you need

To start, you'll need the free and open-source Oracle VirtualBox software installed on your computer. 

1. Install VirtualBox

    1. Go to this link:
    2. Download the version of VirtualBox for your specific operating system.
    3. Follow the steps listed on the downloads page to install VirtualBox onto your computer.

2. Download the Camio Box VirtualBox Appliance

    1. Download the file from
    2. Unzip the downloaded file to extract the camio-box-os-virtualbox-2019-02-27.ova file.
      OVA files are VirtualBox Appliance files that contain an image of a virtual machine that can load into any VirtualBox environment.
      Note - On some machines (like OS X), the default Archive Utility will automatically unpack camio-box-os-virtualbox-2019-02-27.ova file into two files:

      That's fine. Just use the .ovf file in place of the .ova file in the steps below.

3. Get a MAC address for your Virtual Camio Box

Copy the MAC address shown on this page:
Note: If you're running multiple Virtual Machines, then you can get additional MAC addresses by appending a number at the end of the URL above (e.g. /box/register/box_vm_mac2).

4. Create the Camio Box Virtual Machine

    1. Open the VirtualBox program.
    2. Choose 'File' > 'Import Appliance'
    3. Use the file selector to select the camio-box-os-virtualbox-2019-02-27.ova file that you unzipped previously. (or, select the camio-box-os-virtualbox-2019-02-27.ovf file if you see that instead)
    4. Click the 'Import' button when you see a window pop up with information about the virtual machine you are creating. You can customize the virtual machine settings later.



5. Set the MAC address and Networking for your VM

You should now be on the main VirtualBox window and there should be an entry in the left column that says 'CamioBox VM'. To set the MAC address of your VM:

    1. Click on the 'CamioBox VM' entry to highlight it.
    2. Click on the 'Settings' button at the top of the page.
    3. Click on the 'Network' tab.
    4. Select the 'Bridged Adapter' with the correct 'Name' that varies by OS:
      Linux: This is normally either 'eth0', or 'enp1s0'. Use the 'ifconfig' terminal tool to find your primary networking interface.
      OS X: This is normally 'en0'. You can use the 'ifconfig' terminal tool to find the primary networking interface.
    5. Expand the 'Advanced' section.
    6. In the 'MAC Address' text-box, enter the MAC address that you copied from the prior step.
    7. Click 'Ok' at the bottom of the 'Settings' window to save your changes.

6. Start your Camio Box Virtual Machine

    1. On the main VirtualBox window, highlight the 'Camio Box VM' entry.
    2. At the top of the main window, click the 'Start' button.
    3. A window will pop up showing a Unix terminal and boot diagnostics for the device. Ignore the login prompt, since the Box VM runs without login.

Once the virtual machine has finished booting, it's ready to be registered to your Camio account.

7. Register your Camio Box:

    1. Go to
    2. Enter a name for your Camio Box.
    3. Click 'Register' and wait for confirmation of registration success to appear on that page.

Congratulations! You have now registered your virtual Camio Box. Go to the page to connect cameras on your network to your Camio account. 


You can of course customize the amount of resources dedicated to your Camio Box virtual machine. For more information see this help article : How do I tune my Camio Box VM to match the number of connected video streams?.

Known Issues:

There is an issue with VirtualBox on some combinations of host-hardware and networking-hardware that prevents bridged-networking from working. If your Camio Box fails to register itself, or if it hangs on boot while "Raising Network Interfaces", it may be useful to set up a regular Ubuntu 16.04 virtual machine and see if you can get bridged networking to work. This will help us diagnose if it's a VirtualBox issue or a Camio Box issue.




Have more questions? Submit a request


  • Avatar
    Luiz Carlos Jr

    I need the username and password to login on Camio Box in Oracle VirtualBox but i don't have this information, please can you tell me what it is?

  • Avatar
    John Allard

    The login credentials to the Camio Box VM are not publicly available. All interaction with the VM is done through the page.

  • Avatar
    Luiz Carlos Jr

    How can I register the virtual camio without login ?

  • Avatar
    John Allard

    To register the Virtual Box you need to

    1. Get a MAC address for your VM from
    2. Set the MAC address of your VM to the MAC address returned from step 1.
    3. Turn on the VM and let it boot
    4. Go back to, enter a name for your Camio Box, and click "register". If the VM has the MAC address set correctly, it will register itself and you will see a confirmation on the /box/register page that the registration was successful.

  • Avatar
    Hiền Nguyễn Quốc

    Hi, can you help, I can't start camio box vm on mac os.
    It says: Failed to open a session for the virtual machine CamioBox VM.
    Kernel driver not installed (rc=-1908)

  • Avatar
    Rajesh K


    I have a virtual machine hosted in Google cloud (Ubuntu). It has nested virtualization enabled.
    I am trying to host the camiobox vm into the Ubuntu environment (I have Oracle Virtual box running in it and hosted the camio ovf/vmdk). I have assigned the Mac ID as per the Camiobox requirements in the virtual machine and able to start the VM without any issues. but, the vm is not getting connected with camio cloud for box enrollment. All the network bridges settings are active and uses Ubuntu's eth0 network interface for bridging. So, could you help me in setting the Camio VM environment in a nested virtualization environment and make it communicate with the camio cloud?