Running bosh-lite on vSphere Hypervisor Free Edition

When I was searching for a platform to run my personal blog, I made a list of requirements for this platform:

  1. The application should run on Cloud Foundry. In fact, I want to install Ghost using Dr. Nic’s tutorial on Deploying Ghost blog on Cloud Foundry
  2. I want to run Cloud Foundry on my own hardware so I know how it works under the hood (and because I don’t want to pay anyone to run it).
  3. There should be no licensing costs (again – pay as little as possible).
  4. Installing and administering OpenStack seems like overkill for this project.

It turns out this was a fairly restrictive list. Requirement 2 ruled out AWS and Pivotal Web Services. Requirement 3 ruled out vCenter (plus BOSH just doesn’t work with bare ESXi anyway). Requirement 4 is fairly obvious.

Then I got to thinking:

bosh-lite is a great way to get BOSH and Cloud Foundry running quickly so you can dig in. It works with VirtualBox, VMWare Fusion, and AWS. It does this by using a pre-baked stemcell that these platforms just boot up and run.

vSphere Hypervisor (a.k.a. ESXi) is an easy to use and robust platform for running virtual machines. It’s easy to install, runs on consumer-grade hardware, and requires very little maintenance.

VirtualBox has the ability to take an existing image and convert its back-end virtual disk to various formats – including an ESXi VMDK file.

Given these facts, we can actually get bosh-lite to run on ESXi Free in a few easy steps:

  1. Follow the instructions in the [bosh-lite]( README to get bosh-lite running in VirtualBox – right up to the point where you run “vagrant up”.
  2. Log into the virtual machine and shut it down.
    [email protected]:~$vagrant ssh
    [email protected]:~$sudo shutdown -h now
  3. Clone the virtual hard disk, converting it into a fixed ESXi VMDK:
    sudo vboxmanage clonehd /data/jbudnack/VirtualBox\ VMs/bosh-lite_default_1401468204242_17042/boshlite-virtualbox-ubuntu1204ds-disk1.vmdk /data/jbudnack/VirtualBox\ VMs/cloned/bosh-lite-esxi.vmdk --format=VMDK --variant=Fixed,ESX
  4. On Your ESXi box, enable SSH:
    ![ESXi SSH](
  5. Using SFTP, upload the VMDK file to one of the datastores on your ESXi box.
    [email protected]:/data/jbudnack/VirtualBox VMs/cloned$ sftp [email protected]
    Connected to
    sftp> cd /vmfs/volumes/ENTERPRISE\ 750\ L_DS1/
    sftp> mput *.vmdk
  6. Create a new Virtual Machine, using the newly uploaded file as the back-end disk. **Important**: Ensure that this Virtual Machine has 2 virtual NICs. Also, you may want to put the 2nd adapter on its own virtual switch.
    ![ESXi VM](
  7. Start the virtual machine. Log into its console as vagrant (password: vagrant)
  8. Configure the network cards as follows in /etc/network/interfaces:
    # This file describes the network interfaces available on your system
    # and how to activate them. For more information, see interfaces(5).
    # The loopback network interface
    auto lo
    iface lo inet loopback
    auto eth0
    iface eth0 inet static
    # The primary network interface
    pre-up sleep 2
    # The contents below are automatically generated by Vagrant. Do not modify.
    auto eth1
    iface eth1 inet static
    address  #DO NOT CHANGE THIS IP.
  9. Restart the virtual machine. Once it is finished rebooting, try targeting your new bosh-lite vm:
    [email protected]:/data/jbudnack/VirtualBox VMs/cloned$ bosh target
    Target already set to `Bosh Lite Director'
    [email protected]:/data/jbudnack/VirtualBox VMs/cloned$ bosh login
    Your username: admin
    Enter password: *****
    Logged in as `admin'
    [email protected]:/data/jbudnack/VirtualBox VMs/cloned$ bosh status
      Name       Bosh Lite Director
      Version    1.2200.0 (f71e2276)
      User       admin
      UUID       1283c62e-8e7b-43c2-8f97-f42bf8aba812
      CPI        warden
      dns        disabled
      compiled_package_cache enabled (provider: local)
      snapshots  disabled
      not set
  10. And there you go! If you plan on using this for a while, you might want to change the “vagrant” user’s password, as well as the password of your director. You may also want to take this opportunity to snapshot this VM, in case you ever want to roll back to a clean bosh-lite instance.

    Spread the word

    twitter icon facebook icon linkedin icon