Savanna UI Dev Environment SetupΒΆ

These installation steps suite for two purposes:
  • to setup dev environment
  • to setup isolated Dashboard for Savanna

Note that the host where you’re going to perform installation has to be able to connected to all OpenStack endpoints. You can list all available endpoints using the following command:

$ keystone endpoint-list
  1. Install prerequisites
$ sudo apt-get update
$ sudo apt-get install git-core python-dev gcc python-setuptools python-virtualenv node-less libssl-dev

On Ubuntu 12.10 and higher you have to install the following lib as well:

$ sudo apt-get install nodejs-legacy

2. Checkout Horizon from git and switch to your version of OpenStack (stable/grizzly or stable/folsom). Here is an example for grizzly:

$ git clone -b stable/grizzly
Then install virtual environment:
$ python tools/
  1. Create file:
$ cp openstack_dashboard/local/ openstack_dashboard/local/
  1. Open file openstack_dashboard/local/ and uncomment strings:
from horizon.utils import secret_key
SECRET_KEY = secret_key.generate_or_read_....

and set right value for variables:

OPENSTACK_HOST = "ip of your controller"
SAVANNA_URL = "url for savanna (e.g. "http://localhost:8386/v1.1")"

If you are using Neutron instead of Nova Network:

  1. Clone savanna-dashboard sources from
$ git clone
  1. Export SAVANNA_DASHBOARD_HOME environment variable with path to savanna-dashboard folder. E.g.:
$ export SAVANNA_DASHBOARD_HOME=$(pwd)/savanna-dashboard
  1. Install savanna-dashboard module to horizon’s venv. Go to horizon folder and execute:
$ .venv/bin/pip install $SAVANNA_DASHBOARD_HOME
  1. Create a symlink to savanna-dashboard source
$ ln -s $SAVANNA_DASHBOARD_HOME/savannadashboard .venv/lib/python2.7/site-packages/savannadashboard
  1. In openstack_dashboard/ add savanna to
    'dashboards': ('nova', 'syspanel', 'settings', 'savanna'),

and add savannadashboard to

  1. Start horizon
$ tools/ python runserver

This will start horizon in debug mode. That means the logs will be written to console, and if any exceptions happen, you will see the stack-trace rendered as a web-page.

The debug could be disabled by changing DEBUG=True to False in In that case Horizon should be started slightly differently, otherwise it will not serve static files:

$ tools/  python runserver --insecure

It is not recommended to use horizon in this mode for production.

  1. Applying changes

If you have changed any *.py files in $SAVANNA_DASHBOARD_HOME directory, horizon will notice that and reload automatically. However changes made to non-python files may not be noticed, so you have to restart horizon again manually, as described in step 10.

Previous topic

Savanna UI Dev Environment Setup

Next topic

Quickstart guide

This Page