Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status


kibana (9) Versions 0.2.0

Installs/Configures kibana, the logstash UI

cookbook 'kibana', '= 0.2.0', :supermarket
cookbook 'kibana', '= 0.2.0'
knife supermarket install kibana
knife supermarket download kibana
Quality 100%


Build Status

A cookbook that installs Kibana.

Kibana requires ElasticSearch index to be configured to work as per logstash requirements.


  • Chef 11+


  • Ubuntu 12.04, 14.04.
  • CentOS 6 (does not include a startup script)


  • build-essential
  • ark
  • apache2 (>= 2.0) (Suggested but not required)
  • authbind (Suggested but not required)
  • apt (Suggested but not required)
  • nginx (Suggested but not required)


  • node['kibana']['version'] - Kibana version. Defaults to 3.
  • node['kibana']['kibana3_version'] - Kibana3 exact version. Defaults to 3.0.0.
  • node['kibana']['kibana4_version'] - Kibana4 exact version. Defaults to 4.2.0.
  • node['kibana']['base_dir'] - The base directory of kibana. Defaults to /opt/kibana.
  • node['kibana']['user'] - The user under which Kibana is installed. Defaults to kibana.
  • node['kibana']['group'] - The group under which Kibana is installed. Defaults to kibana.
  • node['kibana']['install_method'] - Install method. Can be source or release. Defaults to release.
  • node['kibana']['url'] - Url of tarball. Defaults to{node['kibana']['kibana3_version']}.tar.gz.
  • node['kibana']['checksum'] - Checksum of the tarball. Defaults to df25bc0cc02385edcac446ef8cbd83b896cdc910a0fa1b0a7bd2a958164593a8.
  • node['kibana']['kibana4_checksum'] - Checksum of the tarball. Defaults to 67d586e43a35652adeb6780eaa785d3d785ce60cc74fbf3b6a9a53b753c8f985.
  • node['kibana']['git']['url'] - The URL to Kibana repository. Defaults to
  • node['kibana']['git']['reference'] - The git reference in the Kibana repository. Defaults to 'v' + node['kibana']['kibana3_version'].
  • node['kibana']['rubyversion'] - The version of Ruby and Gems to use for Kibana. Defaults to 1.9.1.
  • node['kibana']['interface'] - The interface on which to bind. Defaults to
  • node['kibana']['port'] - The port on which to bind. Defaults to 5601.
  • node['kibana']['elasticsearch']['hosts'] - An Array of the elasticsearch service hosts. Defaults to [''].
  • node['kibana']['elasticsearch']['port'] - The port of the elasticsearch http service. Defaults to 9200.
  • node['kibana']['default_fields'] - The which fields are shown by default. Defaults to ["@message"].
  • node['kibana']['default_operator'] - The operator used if no explicit operator is specified. Defaults to OR.
  • node['kibana']['config']['cookbook'] - The cookbook from which config.js template is taken. Defaults to nil.
  • node['kibana']['config']['source'] - The template from which config.js is generated from. Defaults to nil.
  • node['kibana']['highlighted_field'] - Fields specifiers which default to @message (may need to be changed for newer logstash). Defaults to @message.
  • node['kibana']['primary_field'] - Defaults to @message.
  • node['kibana']['default_index'] - Defaults to @message.
  • node['kibana']['apache']['host'] - The host to create apache vhost for. Defaults to node['fqdn'].
  • node['kibana']['apache']['interface'] - The interface on which to bind apache. Defaults to node['ipaddress'].
  • node['kibana']['apache']['basic_auth'] - Enable http auth for Apache. Defaults to off.
  • node['kibana']['apache']['basic_auth_username'] - Apache http auth username. Defaults to admin.
  • node['kibana']['apache']['basic_auth_password'] - Apache http auth password. Defaults to PLEASEchangeme.
  • node['kibana']['apache']['port'] - The port on which to bind apache. Defaults to 80.
  • node['kibana']['apache']['proxy'] - Boolean switch to enable apache search query proxy. Defaults to false.
  • node['kibana']['nginx']['port'] - The port on which to bind nginx. Defaults to 80.
  • node['kibana']['nginx']['listen_http'] - The port on which to bind nginx. Defaults to 80.
  • node['kibana']['nginx']['listen_https'] - The HTTPS port on which to bind nginx. Defaults to 443.
  • node['kibana']['nginx']['client_max_body'] - Defaults to 50M.
  • node['kibana']['nginx']['ssl'] - Boolean switch to enable SSL configuration. Defaults to false.
  • node['kibana']['nginx']['proxy'] - Boolean switch to enable nginx search query proxy. Defaults to false.
  • node['kibana']['nginx']['auth'] - Boolean switch to enable auth basic. Defaults to false.
  • node['kibana']['auth_file'] - The path to auth basic file. Defaults to /etc/nginx/htpasswd.users.
  • node['kibana']['nginx']['ssl_certificate'] - The path to the SSL certificate file. Defaults to nil.
  • node['kibana']['nginx']['ssl_certificate_key'] - The path to the SSL certificate key. Defaults to nil.
  • node['kibana']['nginx']['ssl_protocols'] - The SSL protocols. Defaults to TLSv1 TLSv1.1 TLSv1.2.
  • node['kibana']['nginx']['ssl_ciphers'] - The SSL ciphers. Defaults to ECDHE-RSA-RC4-SHA:ECDHE-RSA-AES128-SHA:AES256-CGM-SHA256:ECDHE-RSA-AES256-SHA256:RC4:HIGH:!aNULL:!MD5:-LOW:-SSLv2:-EXP.
  • node['kibana']['nginx']['ssl_session_cache'] - The SSL session cache. Defaults to shared:SSL:10m.
  • node['kibana']['nginx']['ssl_session_timeout'] - The SSL session timeout. Defaults to 10m.
  • node['kibana']['nginx']['server_name'] - The virtualhost server name. Defaults to kibana.


  • kibana::apache - Setup vhost for apache that rewrites to Kibana.
  • kibana::default - Install Kibana.
  • kibana::kibana3
  • kibana::kibana4
  • kibana::nginx


Setup vhost for apache that rewrites to Kibana.


Install Kibana.

License and Maintainer

Maintainer:: Peter Donald (

License:: Apache 2.0


  • Added stove support (@drenalin23)
  • Added better startup script support for CentOS6 and CentOS7 (@drenalin23)
  • Add systemd startup support for Ubuntu 16.04 (@drenalin23)
  • updates to integration tests, travis matrix, and rubocop fixes (@drenalin23)
  • change kibana service default action to enable and start (@g.fediere and @drenalin23)
  • updates to better support recent versions of the upstream apache2 cookbook (@drenalin23)
  • add logging options for Kibana4 (@sT331h0rs3)
  • add package install method for deb (@cyberflow)
  • [possibly breaking] Switch to chef_nginx cookbook as default (@drenalin23)


  • removed support for kibana2 ( use 0.1.10 release if Kibana2 is needed )
  • added serverspec tests. Submitted by Dmitry and Scott (cyberflow and drenalin23).
  • added chefspec unit tests. Submitted by Scott (drenalin23).


  • Support proxying elasticsearch through apache. Submitted by Dmitry (cyberflow).
  • Replace depends with suggest for the apache cookbook as it is not needed when using nginx. Submitted by Bryan Casey.
  • Correct apache configuration to work with apache < 2.4. Submitted by Olivier Dolbeau (odolbeau).
  • Add support kibana 4.X
  • Fix some bugs


  • nginx support. Submitted by Gregoire Seux and Jonathon W. Marshall.
  • Add initial support for centos. Submitted by Gregoire Seux.
  • Support configuration of the default operator, default fields, highlighted_field, primary_field and default_index. Submitted by Joseph Anthony Pasquale Holsten.
  • Add test-ktichen support for 12.04
  • Re-order default attributes file for future changes


  • Make Elasticsearch Kibana config an array by default - this will make it easier to supply multiple ES nodes by simply overriding node['kibana']['elasticsearch']['host'] attribute


  • add additional logic to decide which apt package to install based on the version of ruby specified. 1.8, 1.9.1, 1.9.3 are supported. (doublerr)
  • Update README to reflect above (doublerr)
  • Add Berkshelf support (doublerr)


  • include build-essential recipe to ensure bundle install works. Reported by Max Stepanov.
  • Stop declaring the apache template twice.
  • Use https rather than the git protocol to define the kibana repository as many enterprises firewall out the git protocol.
  • Adjusting command to ensure the proper version of ruby is used to execute Kibana in the init script. gems are installed for ruby1.9.1, so the daemon startup command will force using ruby1.9.1 too now, but 1.9.1 is an attribute so that it can be changed in one place as necessary. (nschelly)
  • Fixed permissions for KibanaConfig.rb so that the kibana user can read it. Used to be root:root, now uses the :user and :group attributes (nschelly)


  • Prefer new notification syntax.


  • Initial release

Collaborator Number Metric

0.2.0 passed this metric

Foodcritic Metric

0.2.0 passed this metric