Create ISO image

The Hotrod CLI (command line interface) offers an easy way to create Bbox ISOs:

    hotrod portal bbox-iso [OPTIONS] --bbox-type <bbox-type> --hotrod-server <hotrod-server>

    -h, --help       Prints help information
    -V, --version    Prints version information

        --address <address>                Bbox CIDR (ipv4)
        --bbox-type <bbox-type>            Bbox type [possible values: vm, ng, up]
        --dns-server <dns-server>          DNS server
        --gateway <gateway>
        --hotrod-server <hotrod-server>    Server address, to which the Bbox installed from this ISO will connect
        --iso-server <iso-server>          ISO server [default:]
        --label <label>                    ISO label, to help determine name of ISO
        --ntp-server <ntp-server>          NTP server

Creation of the ISO should not take longer than a minute, but the download will take as long as your network allows (1.1 GB ISO image).

  • Write the ISO to a USB stick

  • Connect the stick to the Bbox, reboot, enter BIOS (press Delete key during boot-up), and set the stick to be the first boot device, and exit the BIOS.

  • On reboot, select Advanced options, then select Automated install. The installation should be complete by the time that Bbox shuts down. This should take less than 7 minutes (for the bbox-up) and over 10 minutes (for the bbox-ng).

You can also use the --bbox-type vm to create an ISO for a VirtualBox ISO.

Bbox for production

  • Boot the Bbox, with network cable disconnected
  • Connect the serial cable/monitor to the bbox and wait until the Hotrod URL/IP address is displayed
  • Shut down, affix the correct labels, and ship

Creating a VM on VMware ESXi

  • After login to VMware ESXi, click Create/Register VM
  • Choose the VM name, select linux as Guest OS family, and select latest ubuntu as Guest OS version.
  • Select the datastore in which to store the configuration and disk files.
  • Then click on Client Device and choose Datastore ISO file
  • Then browse to the ISO you uploaded.
  • Then navigate to the vm you created and power it up.
  • After 15 minutes the vm will halt/exit... you will need to power it up again.

Creating a VM on VirtualBox

  • If you need more than one network interface enabled, ensure to attach just 2, and just leave the other 2 enabled.
  • Import the ISO to VirtualBbox and start building the virtual Bbox.