The easiest way to try out Vumi is by using VirtualBox and Vagrant:
Install VirtualBox
Install Vagrant, make sure you follow the OS specific instructions.
Clone Vumi with git clone https://github.com/praekelt/vumi.git
Execute cd vumi
- Execute vagrant up, this will take some time to complete as it:
- Downloads a 480MB Ubuntu 10.04 server VM
- Downloads ~ 40MB worth of Python packages
- Downloads ~ 100MB worth of packages with apt-get
Shell into the machine via vagrant ssh, you’ll find the Vumi installation in /var/praekelt/vumi.
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/