Chef Cookbook for OpenStack Horizon
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Issues have been disabled for this repository.
Any issues with this cookbook should be raised here:

Please title the issue as follows:

[horizon]: <short description of problem>

In the issue description, please include a longer description of the issue, along with any relevant log/command/error output.
If logfiles are extremely long, please place the relevant portion into the issue description, and link to a gist containing the entire logfile

Please see the contribution guidelines for more information about contributing to this cookbook.


Installs the Openstack dashboard (codename: horizon) from packages.


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


  • CentOS >= 6.4
  • Ubuntu >= 12.04


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
  • installs and configures the openstack dashboard package, sets up the horizon database schema/user, and installs an appropriate apache config/site file
  • if ["horizon"]["theme"] = "Rackspace", will also install the Rackspace stylesheet, and grab the necessary branded jpegs
  • 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['horizon_user'] - horizon system user

  • horizon["rax_logo"] - Change default horizon logo to rax logo (true || false)

  • horizon["site_branding"] - Set the site branding/title

  • 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"]["cert"] - name to use when creating the ssl certificate

  • horizon["ssl"]["key"] - name to use when creating the ssl key

  • horizon["ssl"]["cert_override"] - location for custom Cert file

  • horizon["ssl"]["key_override"] - location for custom Key file

  • horizon["services"]["dash"]["scheme"] - defaults to http

  • horizon["services"]["dash"]["network"] - osops_networks network name which service operates on

  • horizon["services"]["dash"]["port"] - port to bind service to

  • horizon["services"]["dash"]["path"] - URI to use

  • horizon["services"]["dash_ssl"]["scheme"] - defaults to https

  • horizon["services"]["dash_ssl"]["network"] - osops_networks network name which service operates on

  • horizon["services"]["dash_ssl"]["port"] - port to bind service to

  • horizon["services"]["dash_ssl"]["path"] - URI to use

  • `horizon["horizon_user"] - Set the name of the use that Horizon will use, Normally "Horizon"

  • horizon["swift"]["enabled"] - enable if swift endpoint is available

  • horizon["theme"] - which theme to use for the dashboard. Supports "default" or "Rackspace"

  • horizon["platform"] - Hash of platform specific package/service names and options

  • horizon["endpoint_type"] - The endpoint type to use from the Keystone service catalog


  • default_stylesheets.html.erb - default stylesheet
  • dash-site.erb - the apache config file for the dashboard vhost
  • - config file for the dashboard application
  • ports.conf.erb - Apache ports.conf file
  • rs_stylesheets.html.erb - Rackspace stylesheet

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 Thompson (
Author:: Andy McCrae ( Author:: Kevin Carter ( Author:: Zack Feldstein (

Copyright 2012-2013, Rackspace US, 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.