OpenStack Horizon Puppet Module
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Takashi Kajinami 391cb5be77 Remove redundant example for POLICY_FILES 1 week ago
doc Switch to newer openstackdocstheme and reno versions 7 months ago
manifests Remove the profile_support setting from OPENSTACK_NEUTRON_NETWORK 2 weeks ago
releasenotes add support for SECURE_PROXY_ADDR_HEADER 3 weeks ago
spec Remove the profile_support setting from OPENSTACK_NEUTRON_NETWORK 2 weeks ago
templates Remove redundant example for POLICY_FILES 1 week ago
.gitignore Dissuade .gitignore references to personal tools 2 years ago
.gitreview OpenDev Migration Patch 1 year ago
.sync.yml Initial msync run for all Puppet OpenStack modules 5 years ago
.zuul.yaml Build containers for single consumer job 2 months ago Release 8.0.0 4 years ago
CONTRIBUTING.rst [ussuri][goal] Add CONTRIBUTING.rst 8 months ago
Gemfile Use openstack_spec_helper from zuul checkout 4 months ago
LICENSE Update LICENSE 2 years ago Add Puppet Litmus 4 months ago
Rakefile Use puppet-openstack_spec_helper for Rakefile & spec_helper_acceptance 5 years ago
bindep.txt modulesync: sync and add nodepool-bionic for beaker 2 years ago
metadata.json Prepare Wallaby M1 1 month ago
setup.cfg Change openstack-dev to openstack-discuss 2 years ago Add basic structure for ReNo 4 years ago
tox.ini Replace deprecated UPPER_CONSTRAINTS_FILE variable 2 months ago

Team and repository tags

Team and repository tags


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. Release Notes - Release notes for the project
  8. Contributors - Those with commits
  9. Repository - The project source code repository


The horizon module is a part of OpenStack, an effort by the OpenStack infrastructure team to provide continuous integration testing and code review for OpenStack and OpenStack community projects as 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.


What the horizon module affects

  • Horizon, the dashboard service for OpenStack.

Installing horizon

puppet module install openstack/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. We recommend you consult and understand 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',
  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