django-fab-deploy documentation

django-fab-deploy is a collection of fabric scripts for deploying and managing django projects on Debian/Ubuntu servers.

Design goals

  • Provide (heroku,,, ...)-like experience using your own VPS/server;
  • servers should be configured in most standard and obvious way: invent as little as possible;
  • developer should be able to customize deployment;
  • it should be possible to integrate django-fab-deploy into existing projects;
  • try to be a library, not a framework; parts of django-fab-deploy should be usable separately.

Tech overview

  • django projects are isolated with virtualenv and (optionally) linux and db users;
  • python requirements are managed using pip;
  • server interactions are automated and repeatable (the tool is fabric);
  • several projects can be deployed on the same VPS;
  • one project can be deployed on several servers.

Server software:

  • First-class support: Debian Squeeze, Ubuntu 10.04 LTS;
  • also supported: Debian Lenny, Ubuntu 10.10;
  • the project is deployed with Apache + mod_wsgi for backend and nginx in front as a reverse proxy;
  • DB: MySQL and PostgreSQL (+PostGIS) support is provided out of box;
  • VCS: hg and git support is provided out of box + it is possible not to store project into VCS.

Make sure you’ve read the following document if you are upgrading from previous versions of django-fab-deploy:

Bug tracker

If you have any suggestions, bug reports or annoyances please report them to the issue tracker at


Development of django-fab-deploy happens at Bitbucket:

You are highly encouraged to participate in the development of django-fab-deploy. If you don’t like Bitbucket or Mercurial (for some reason) you’re welcome to send regular patches.


Licensed under a MIT license.

Indices and tables