Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

..
Octocat-spinner-32 dashboard
Octocat-spinner-32 local
Octocat-spinner-32 Makefile
Octocat-spinner-32 README
Octocat-spinner-32 manage.py
Octocat-spinner-32 setup.py
README
===================
OpenStack Dashboard
===================

The OpenStack Dashboard is a reference implementation of a Django site that
uses the Horizon project to provide web based interactions with the various
OpenStack projects.


Getting Started
===============

For local development, first create a virtualenv for the project.
In the Horizon ``tools`` directory there is a script to create one for you:

  $ python tools/install_venv.py

Alternatively, the ``run_tests.sh`` script will also install the environment
for you and then run the full test suite to verify everything is installed
and functioning correctly.

Now that the virtualenv is created, you need to configure your local
environment.  To do this, create a ``local_settings.py`` file in the ``local/``
directory.  There is a ``local_settings.py.example`` file there that may be
used as a template.

If all is well you should now able to run the development server locally:

  $ tools/with_venv.sh openstack-dashboard/manage.py runserver

or, as a shortcut::

  $ ./run_tests.sh --runserver

Settings Up OpenStack
=====================

The recommended tool for installing and configuring the core OpenStack
components is `Devstack`_. Refer to their documentation for getting
Nova, Keystone, Glance, etc. up and running.

.. _Devstack: http://devstack.org/
Something went wrong with that request. Please try again.