Various helpers for django on webfaction deploy
Python Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



Collection of tools to run django on webfaction more seamless


  • Install with pip or easy install (pip install django-webfaction)


Console utility

Django webfaction contains webfactionctl utility that can be used to control your webfaction services from command-line.

  1. Setting up

    1.1. You can save username and password in config to avoid entering them on each command,

    to do this just run configure command providing username and password:

    webfactionctl -u username -p password configure

    and now you can run other commands without specifying login/password.

    1.2. If you use multiple accounts (e.g. you manage your client accounts) you can save them in

    config with -a key. Just run:

    webfactionctl -u username2 -p password2 -a ac2 configure

    and now if you call commands with -a ac2 they will use username2 account:

    webfactionctl -a ac2 list_machines
  2. You get access to basic commands like a list machines/apps/databases/ips/.. and crate apps and databases. For example to get list of your current dbs just run:

    webfactionctl list_dbs
  3. You can get extended info of your machines with current RAM usage, apps and processes with state command:

    $ webfactionctl state
    Query machines list...
    Query apps list...
    Query machine state detail: Web210 Web217 Web223 Web317 Web327
    | ram_usage | operating_system |  name  |      location      | app_count | process_count | id  |
    | 209708    | Centos5-32bit    | Web210 | Europe (Amsterdam) | 19        | 20            | 376 |
    | 43112     | Centos5-32bit    | Web217 | Europe (Amsterdam) | 2         | 7             | 386 |
    | 175352    | Centos5-32bit    | Web223 | Europe (Amsterdam) | 12        | 17            | 395 |
    | 8220      | Centos6-64bit    | Web317 | Europe (Amsterdam) | 6         | 7             | 445 |
    | 66092     | Centos6-64bit    | Web327 | Europe (Amsterdam) | 2         | 9             | 462 |

Django deployment wizard

With webfactionctl stup_django_project you can run django deployment wizard that:

  1. Prepare server by installing pip, virtualenv, gunicorn, django-webfaction globally for your account.
  2. Create main app for your project
  3. Setup virtualenv for your main project
  4. Prepare gunicorn contorl script for your project
  5. Create static app for your project
  6. Prepare settings_local for your project

Sending mail from local sendmail asynchronous

There is a fail in webfaction deployment, when there is no sendmail server running on localhost, only smtp server in US. For apps runned in Europe sending a mail from or running local sendmail process takes >1.2 seconds that definately require asynchronous system.

To use asychronous message sending system just add this line to your django settings file:

EMAIL_BACKEND = 'webfaction.backends.EmailBackend'

Accessing REMOTE_ADDR from django

When a Django application’s Apache instance proxies requests to Django, the REMOTE_ADDR header is not set with the clients’s IP address. Adding this webfaction.middleware.WebFactionFixes to your MIDDLEWARE_CLASSES replace REMOTE_ADDR with correct client's IP.

If you use classic method to modify deployed settings by putting:

    from settings_local import *
except ImportError:

at the end of file, you can put this code to settings_local: