Forge Home


Puppet module for OpenStack Horizon


10,961 latest version

3.1 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 5.1.0 (latest)
  • 5.0.0
released Jun 17th 2015
This version is compatible with:
  • Puppet Enterprise 3.x
  • Puppet 3.x
  • , , ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'stackforge-horizon', '5.1.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add stackforge-horizon
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install stackforge-horizon --version 5.1.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



stackforge/horizon — version 5.1.0 Jun 17th 2015


5.1.0 - 2014.2 - Juno

Table of Contents

  1. Overview - What is the horizon module?
  2. Module Description - What does the module do?
  3. Setup - The basics of getting started with horizon
  4. Implementation - An under-the-hood peek at what the module is doing
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module
  7. Contributors - Those with commits
  8. Release Notes - Notes on the most recent updates to the module


The horizon module is a part of Stackforge, an effort by the Openstack infrastructure team to provide continuous integration testing and code review for Openstack and Openstack community projects not part of the core software. The module its self is used to flexibly configure and manage the dashboard service for Openstack.

Module Description

The horizon module is a thorough attempt to make Puppet capable of managing the entirety of horizon. Horizon is a fairly classic django application, which results in a fairly simply Puppet module.

This module is tested in combination with other modules needed to build and leverage an entire Openstack software stack. These modules can be found, all pulled together in the openstack module.


What the horizon module affects

  • horizon, the dashboard service for Openstack.

Installing horizon

example% puppet module install puppetlabs/horizon

Beginning with horizon

To utilize the horizon module's functionality you will need to declare multiple resources but you'll find that doing so is much less complicated than the other OpenStack component modules. The following is a modified excerpt from the openstack module. We recommend you consult and understand the openstack module and the core openstack documentation.

Define a horizon dashboard

class { 'memcached':
  listen_ip => '',
  tcp_port  => '11211',
  udp_port  => '11211',

class { '::horizon':
  cache_server_ip       => '',
  cache_server_port     => '11211',
  secret_key            => '12345',
  swift                 => false,
  django_debug          => 'True',
  api_result_limit      => '2000',



Horizon is a simple module using the combination of a package, template, and the file_line type. Most all the configuration lives inside the included local_settings template and the file_line type is for selectively inserting needed lines into configuration files that aren't explicitly managed by the horizon module.


  • Only supports Apache using mod_wsgi.


Developer documentation for the entire puppet-openstack project.


Release Notes


  • spec: pin rspec-puppet to 1.0.1
  • Sort policy files in
  • Pin puppetlabs-concat to 1.2.1 in fixtures
  • Add support for the configuration of OPENSTACK_CINDER_FEATURES
  • Update .gitreview file for project rename


  • Stable Juno release
  • Fixed the default value of compress_offline parameter
  • Always manages
  • Added parameters to configure policy files in horizon class
  • Fixed Apache config file default
  • Added parameter django_session_engine to horizon class
  • Stops setting wsgi_socket_prefix since the apache module takes care of it
  • Adds workaround for puppet's handling of undef for setting the vhost bind address
  • Changes cache_server_ip in horizon class to accept arrays
  • Switched the default log level to INFO from DEBUG
  • Fixed the default MSSQL port in security group rules


  • Added parameters to configure ALLOWED_HOSTS in settings_local.y and ServerAlias in apache, no longer requiring these values to be the fqdn
  • Fixed removal of vhost conf file
  • Added support for secure cookies


  • Added option to set temporary upload directory for images.
  • Ensure ssl wsgi_process_group is the same as wsgi_daemon_process.
  • Pined major gems.


  • Stable Icehouse release.
  • Added support to pass extra parameters to vhost.
  • Added support to ensure online cache is present and can be refreshed.
  • Added support to disable configuration of Apache.
  • Fixed log ownership and WSGIProcess* settings for Red Hat releases.
  • Fixed overriding of policy files in local settings.
  • Fixed SSL bugs.
  • Improved WSGI configuration.


  • Added option parameterize OPENSTACK_NEUTRON_NETWORK settings.


  • Adds COMPRESS_OFFLINE option to local_settings to fix broken Ubuntu installation.


  • Major release for OpenStack Havana.
  • Updated user and group for Debian family OSes.
  • Updated policy files for RedHat family OSes.
  • Enabled SSL support with cert/key.
  • Improved default logging configuration.
  • Fixed bug to set LOGOUT_URL properly.
  • Introduced new parameters: keystone_url, help_url, endpoint type.
  • Fixed user/group regression for Debian.
  • Changed keystonedefault_role to _member.


  • Fixed apache 0.9.0 incompatability.
  • Various lint fixes.


  • Updated
  • Pinned Apache module version.
  • Various lint fixes.


  • Upstream is now part of stackforge.
  • httpd config now managed on every platform.
  • Provides option to enable Horizon's display of block device mount points.