Currently we have use Fabric, a tool for streamlining administration tasks, to deploy Ganeti Web Manager.

Before installing Ganeti Web Manager, make sure you have all the required Dependencies installed.


  1. Download and unpack the latest release, currently this is 0.10.1.

  2. Change to the project directory.

    cd ganeti_webmgr
  3. Run Fabric to automatically create a python virtual environment and install required dependencies. This may take a few minutes.

    # Deploy a production environment
    fab deploy

    Changed in version 0.10: fab prod deploy is now fab deploy. fab dev deploy is still the same.


    If you would like a more noisy output, adding v, as in fab v deploy, will provide more verbosity.

  4. While in the project root, copy the default settings file to


Minimum Configuration

Getting Ganeti Web Manager up and running requires a minimum configuration of a database server. If you don’t have a database server available, and are fine using SQLite, you can skip this step.

  1. Edit and change the database backend to your preferred database along with filling any any relevant details relating to your database setup.

    'default': {
        # Add 'postgresql_psycopg2', 'postgresql', 'mysql',
        # 'sqlite3' or 'oracle'.
        'ENGINE': 'django.db.backends.',
        # Or path to database file if using sqlite3.
        'NAME': 'ganeti.db',
        # Not used with sqlite3.
        'USER':     '',
        # Not used with sqlite3.
        'PASSWORD': '',
        # Set to empty string for localhost. Not used with sqlite3.
        'HOST':     '',
        # Set to empty string for default. Not used with sqlite3.
        'PORT':     '',


  1. Activate the Python Virtualenv:

    source venv/bin/activate
  2. Initialize Database:


    # Create new tables and migrate all apps using southdb
    ./ syncdb --migrate



    This assumes your doing a fresh install of Ganeti Web Manager on a new Postgres database.

    ./ syncdb --all
    ./ migrate --fake
  3. Build the search indexes

    ./ rebuild_index


    Running ./ update_index on a regular basis ensures that the search indexes stay up-to-date when models change in Ganeti Web Manager.

Next Steps

Congradulations! Ganeti Web Manager is now installed and initialized. Next, you’ll want to look into Configuring and Deployment, if you are going to be setting up a production instance. Otherwise, if you just want to play around with Ganeti Web Manager, or are developing, take a look at Testing.

Project Versions

Table Of Contents

Previous topic

Ganeti Web Manager

Next topic


This Page