Loading page...


  • Vagrant 1.2+, Virtualbox
  • ChefDK 0.8.1
  • git
  • Java 1.7+
  • Minimum Memory: 8 GB; Recommended: 16 GB

Install Vagrant/Virtualbox

For VirtualBox installation follow the instructions on the website depending on your OS.

To install Vagrant download the binary distribution that matches your OS.

Install Chef Development Kit

Go to Chef Development Kit (chef-dk) and download the appropriate binary for your platform. For Ubuntu 16.04 LTS or newer, install it locally from the command line:

sudo dpkg -i chefdk_0.7.0-1_amd64.deb

To validate Chef is working, at your command line write:

chef-solo --version
berks --version

Installation of Hopsworks with Vagrant

We provide you with a Vagrant recipe which creates a virtual machine, installs and configures all of our platform's services including Hops, HopsWorks, MySQL Cluster NDB, etc

Checkout the recipe from our GitHub repository

git clone https://github.com/hopshadoop/hopsworks-chef.git

Then navigate to the previously cloned project. The script 'run-vagrant.sh' will take care of the rest. It will automatically download the dependent Chef cookbooks

and build the VM. The whole process is done on the background but at any point you can check the progress by tailing the file 'nohup.out'

You may modify the specifications of the VM along with the services installed by editing the file 'Vagrantfile' in hopsworks-chef directory.

cd hopsworks-chef


You can later suspend or destroy your vagrant instance with 'vagrant suspend', 'vagrant resume' or 'vagrant destroy' and 'vagrant up'.

Use Hopsworks

Upon succeful completion of the installation you can use Hopsworks by pointing your browser at http://localhost:8080/hopsworks

The default username and password for the admin user is:

username: admin@kth.se
password: admin

In order to connect to your VM:

cd hopsworks-chef

vagrant ssh


If you already have services running on this machine, you may have port clashes. You can edit the Vagrantfile to fix these. Change the mapped ports, such as '8080', to a free port on your host, e.g., 58088.

We will be happy to hear from you and solve your issues. Check our contact channels.