Installing Vumi with VirtualBox and VagrantΒΆ

The easiest way to try out Vumi is by using VirtualBox and Vagrant:

  1. Install VirtualBox

  2. Install Vagrant, make sure you follow the OS specific instructions.

  3. Clone Vumi with git clone https://github.com/praekelt/vumi.git

  4. Execute cd vumi

  5. Execute vagrant up, this will take some time to complete as it:
    1. Downloads a 480MB Ubuntu 10.04 server VM
    2. Downloads ~ 40MB worth of Python packages
    3. Downloads ~ 100MB worth of packages with apt-get
  6. Shell into the machine via vagrant ssh, you’ll find the Vumi installation in /var/praekelt/vumi.

  7. Follow the instructions at Forwarding SMSs from an SMPP bind to a URL to setup your first Vumi application.

Note

Ubuntu 10.04 only provides version 1.3.5 of RubyGems while Vagrant requires version 1.3.6. You’ll need to get an upstream version or install from source as per the OS specific instructions.

Note

Ubuntu doesn’t put vagrant on your $PATH, you’ll need to manually symlink it with sudo ln -s /var/lib/gems/1.8/bin/vagrant /usr/bin/

Project Versions

This Page