Skip to content


Subversion checkout URL

You can clone with
Download ZIP
branch: master

This branch is 6 commits behind opscode-cookbooks:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


This cookbook installs the OpenStack Dashboard service Horizon as part of the OpenStack Essex reference deployment Chef for OpenStack. The contains documentation for using this cookbook in the context of a full OpenStack deployment. Horizon is installed from packages.


Chef 0.10.0 or higher required (for Chef environment use).


  • Ubuntu-12.04
  • Fedora-17


The following cookbooks are dependencies:

  • apache2
  • database
  • mysql
  • osops-utils



-includes recipe server


-includes recipes apache2, apache2:mod_wsgi, apache2:mod_rewrite, apache2:mod_ssl, mysql:client -installs and configures the openstack dashboard package, sets up the horizon database schema/user, and installs an appropriate apache config/site file -uses chef search to discover details of where the database (default mysql) and keystone api are installed so we don't need to explicitly set them in our attributes file for this cookbook


  • horizon["db"]["name"] - name of horizon database
  • horizon["db"]["username"] - username for horizon database access
  • horizon["db"]["password"] - password for horizon database access

  • horizon["use_ssl"] - toggle for using ssl with dashboard (default true)

  • horizon["ssl"]["dir"] - directory where ssl certs are stored on this system
  • horizon["ssl"]["cert"] - name to use when creating the ssl certificate
  • horizon["ssl"]["key"] - name to use when creating the ssl key

  • horizon["dash_path"] - base path for dashboard files (document root)

  • horizon["wsgi_path"] - path for wsgi dir


  • dash-site.erb - the apache config file for the dashboard vhost
  • - config file for the dashboard application

License and Author

Author:: Justin Shepherd ( Author:: Jason Cannavale ( Author:: Ron Pedde ( Author:: Joseph Breu ( Author:: William Kelly ( Author:: Darren Birkett ( Author:: Evan Callicoat ( Author:: Matt Ray (

Copyright 2012, Rackspace US, Inc. Copyright 2012, Opscode, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Something went wrong with that request. Please try again.