Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Branch: master
Pull request Compare This branch is 6938 commits behind openstack:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

..
Failed to load latest commit information.
dashboard
local
Makefile
README
manage.py
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.