Setting Up Your Environment for Wallaroo in Vagrant

To get you up and running quickly with Wallaroo, we have provided a Vagrantfile which includes Wallaroo and related tools needed to run and modify a few example applications. We should warn that this Vagrantfile was created with the intent of getting users started quickly with Wallaroo and is not intended to be suitable for production. Wallaroo in Vagrant runs on Ubuntu Linux Xenial.

Set up Environment for the Wallaroo Tutorial

Linux Ubuntu and MacOS

If you haven't already done so, create a directory called ~/wallaroo-tutorial and navigate there by running:

cd ~/
mkdir ~/wallaroo-tutorial
cd ~/wallaroo-tutorial

This will be our base directory in what follows. Download the Wallaroo sources (this will create a subdirectory called wallaroo-0.5.3):

curl -L -o wallaroo-0.5.3.tar.gz ''
mkdir wallaroo-0.5.3
tar -C wallaroo-0.5.3 --strip-components=1 -xzf wallaroo-0.5.3.tar.gz
rm wallaroo-0.5.3.tar.gz
cd wallaroo-0.5.3

Windows via Powershell

Note: This section of the guide assumes you are using Powershell.

Download and install git from Git for Windows and install it.

If you haven't already done so, create a directory called ~/wallaroo-tutorial and navigate there by running:

cd ~/
mkdir ~/wallaroo-tutorial
cd ~/wallaroo-tutorial

This will be our base directory in what follows. If you haven't already cloned the Wallaroo repo, do so now (this will create a subdirectory called wallaroo-0.5.3):

git clone wallaroo-0.5.3
cd wallaroo-0.5.3
git checkout 0.5.3

Installing VirtualBox

The Wallaroo Vagrant environment is dependent on the default provider,VirtualBox. To install VirtualBox, download a installer or package for your OS here. Linux users can also use apt-get as documented below.


sudo apt-get install virtualbox

Installing Vagrant

Linux Ubuntu, MacOS, and Windows

Download links for the appropriate installer or package for each supported OS can be found on the Vagrant downloads page.

Provision the Vagrant Box

Provisioning should take about 10 to 15 minutes. When it finishes, you will have a complete Wallaroo development environment. You won’t have to go through the provisioning process again unless you destroy the Wallaroo environment by running vagrant destroy.

To provision, run the following commands:

cd ~/wallaroo-tutorial/wallaroo-0.5.3/vagrant
vagrant up

What's Included in the Wallaroo Vagrant Box

  • Machida: runs Wallaroo Python applications.

  • Giles Sender: supplies data to Wallaroo applications over TCP.

  • Giles Receiver: receives data from Wallaroo over TCP.

  • Cluster Shutdown tool: notifies the cluster to shut down cleanly.

  • Metrics UI: receives and displays metrics for running Wallaroo applications.

  • Wallaroo Source Code: full Wallaroo source code is provided, including Python example applications.

Shutdown the Vagrant Box

You can shut down the Vagrant Box by running the following on your host machine:

cd ~/wallaroo-tutorial/wallaroo-0.5.3/vagrant
vagrant halt

Restart the Vagrant Box

If you need to restart the Vagrant Box you can run the following command from the same directory:

vagrant up


Register today and receive a Wallaroo T-shirt and a one-hour phone consultation with Sean, our V.P. of Engineering, to discuss your streaming data questions. Not sure if you have a streaming data problem? Not sure how to go about architecting a streaming data system? Looking to improve an existing system? Not sure how Wallaroo can help? Sean has extensive experience and is happy to help you work through your questions.

Please register here:

Your email address will only be used to facilitate the above.


Awesome! All set. Time to try running your first Wallaroo application in Vagrant.

results matching ""

    No results matching ""