=================== 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/