Installing Vumi with VirtualBox and Vagrant¶
Clone Vumi with
git clone https://github.com/praekelt/vumi.git
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
Follow the instructions at Forwarding SMSs from an SMPP bind to a URL to setup your first Vumi application.
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.
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/
Installation on a Debian/Ubuntu system¶
If you don’t have/want Vagrant for some reason (or perhaps are doing a production deployment), you can follow the instructions below:
- Install protobuf-compiler python-dev build-essential python-pip libffi-dev. You can do this with apt-get or aptitude.
- If you’re installing vumi as an unprivileged user, run the command pip install –user vumi. Alternatively run pip install vumi to do a system/virtualenv install (as is appropriate in your environment).
These instructions were tested on an Ubuntu 12.04 instance as well as a Debian 7 instance.