Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

VirtualBox control and documentation mechanism

Project Description
drifter is a simplified control for virtualboxes that doesn’t require the vm to be packaged in a specific and ill documented format. Which allows use to create your environment with Virtualbox and then drift will take care of bringing them up and shutting them down.

Why drifter?

If you are currently using Vagrant or straight-up virtualbox and you are happy, then there is nothing for you to see here. However, if you are annoyed with how difficult it is to convert a virtualbox vm into a vbox usable by Vagrant, then Drifter might just be for you.

In general, I like the idea of Vagrant, but I have specific problems with the following:

  • Security concerns with what is being downloaded from an untrusted source
  • The limited vm’s available from that source, Specifically the *BSDs and Windows
  • Vagrant’s intentional inability to auto create a vbox from a virtualbox image

drifter’s answer

  • Drifter currently supports virtualbox vms. You build it, drifter will control it.
  • Drifter currently has 5 commands: list, add, remove, up and down. Easy to remember, easy to script.
  • Drifter’s configuration, Drifterfile, is in YAML not some language specific module. On top of that, you don’t even need to edit it directly. Use add and remove to create and make changes, but it’s still yaml so diff’ing is unsurprising.
  • Drifter lets you document your environment and store that documentation with your source.
  • Drifter fires up your vms in order and shuts them down in reverse order.


In a virtual environment..

$ hg clone ssh://

$ pip install –editable .

$ drifter –help

Then you can edit the source and run drifter cmd



  • bug fixes for removing a non-existent VM from Drifterfile
  • tests


  • updated documentation links


  • Initial Release
Release History

Release History

This version
History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
drifter-0.0.3.tar.gz (8.8 kB) Copy SHA256 Checksum SHA256 Source Apr 24, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting