Horizon is a Django-based project aimed at providing a complete OpenStack Dashboard along with an extensible framework for building new dashboards from reusable components. The openstack_dashboard module is a reference implementation of a Django site that uses the horizon app to provide web-based interactions with the various OpenStack projects.

• Release management: https://launchpad.net/horizon
• Blueprints and feature specifications: https://blueprints.launchpad.net/horizon
• Issue tracking: https://bugs.launchpad.net/horizon

See doc/source/topics/install.rst about how to install Horizon in your OpenStack setup. It describes the example steps and has pointers for more detailed settings and configurations.

It is also available at https://docs.openstack.org/developer/horizon/topics/install.html.

doc/source/quickstart.rst or https://docs.openstack.org/developer/horizon/quickstart.html describes how to setup Horizon development environment and start development.

This documentation is written by contributors, for contributors.

The source is maintained in the doc/source directory using reStructuredText and built by Sphinx

• Building Automatically:

  $ ./run_tests.sh --docs
  

• Building Manually:

  $ tools/with_venv.sh sphinx-build doc/source doc/build/html
  

Results are in the doc/build/html directory