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

The activemq cookbook has been deprecated

Author provided reason for deprecation:

The activemq cookbook has been deprecated and is no longer being maintained by its authors. Use of the activemq cookbook is no longer recommended.


activemq (23) Versions 4.1.0

Installs activemq and sets it up as service

cookbook 'activemq', '~> 4.1.0', :supermarket
cookbook 'activemq', '~> 4.1.0'
knife supermarket install activemq
knife supermarket download activemq
Quality 17%

activemq Cookbook

Build Status Cookbook Version

Provides resources for installing Apache ActiveMQ and managing the Apache ActiveMQ service for use in wrapper cookbooks. Installs from tarballs from the website by default.



  • Debian/Ubuntu
  • RHEL/CentOS/Scientific/Amazon/Oracle


  • Chef 12.5+


  • java


  • node['activemq']['mirror'] - download URL up to the activemq/apache-activemq directory.
  • node['activemq']['version'] - version to install.
  • node['activemq']['home'] - directory to deploy to (/opt by default)
  • node['activemq']['wrapper']['max_memory'] - maximum amount of memory to use for activemq.
  • node['activemq']['wrapper']['useDedicatedTaskRunner'] - whether to use the dedicated task runner
  • node['activemq']['enable_stomp'] - Flag that decides whether or not to use stomp. Note: This is only used when use_default_config attribute is true.
  • node['activemq']['use_default_config'] - Flag that allows the option to use a basic configuration file
  • node['activemq']['install_java'] - Whether or not to use the Java community cookbook to install Java. Defaults to true.
  • node['activemq']['enabled'] - Whether or not the ActiveMQ service should be started. Defaults to true.


Due to the complexity of configuring ActiveMQ it's not possible to create a single solution that solves everyone's potential desired configuration. Instead this cookbook provides resources for installing and managing the ActiveMQ service, which are best used in your own wrapper cookbook. The best way to understand how this could be used is to look at the docs_example test recipe located at test/cookbooks/test/recipes/docs_example.rb



The activemq_install resource installs an instance of the Apache ActiveMQ binary direct from Apache's mirror site. As distro packages are not used we can easily deploy per-instance installations and any version available on the Apache archive site can be installed.


  • instance_name, String
  • version, String. The version to install. Default: '5.12.0'
  • home, String. The top level directory to install software. Default: '/opt'
  • install_path, String. The full level path to install software.
  • tarball_base_path, String. The base path to the location containing the binary package of ActiveMQ. Default: 'http://archive.apache. org/dist/activemq/'
  • checksum_base_path, String, The base path to the location containing the checksum file. default: ''
  • exclude_docs, [true, false], default: true
  • exclude_examples, [true, false], default: true
  • exclude_webapp_demo, [true, false], default: true
  • tarball_uri, String
  • activemq_user, String user to run activemq
  • activemq_group, String group to run activemq


# Install hello instance of activemq
activemq_install 'hello' do
  version '5.12.0'

License & Authors

Author: Cookbook Engineering Team (

Copyright: 2008-2017, Chef Software, 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,
See the License for the specific language governing permissions and
limitations under the License.

Dependent cookbooks

java ~> 1.13

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

activemq Cookbook CHANGELOG

This file is used to list changes made in each version of the activemq cookbook.

4.1.0 (2017-05-06)

  • Require Chef 12.7+ to workaround action_class bug

4.0.3 (2017-04-25)

  • Update recipe to 5.14.4
  • Update integration test to include check for activemq
  • Update documentation for the activemq_install resource.

4.0.2 (2017-04-04)

  • Set 5.14.4 as the default ActiveMQ version
  • Fix issues with action class on Chef 12.5/12.6

4.0.1 (2017-03-21)

  • Test with local delivery and not Rake
  • Update Apache 2.0 license string
  • Add all suse platform strings to the metadata

4.0.0 (2017-02-27)

  • Move templates to the root dir since Chef 12 allows this`
  • Remove platform check that isn’t necessary anymore
  • Fix a deprecation warning in the test cookbook
  • Require 12.5+ and remove compat_resource dependency

3.0.1 (2016-12-22)

  • Require compat_resource
  • Remove LWRP-isms from the custom resource
  • Cookstyle fixes

3.0.0 (2016-09-19)

  • Require Chef 12.1 or later
  • Switch testing in Travis to kitchen-dokken for integration testing and our Rakefile with cookstyle, foodcritic, and chefspec for linting/unit testing
  • Switched integration testing from Serverspec to Inspec
  • Add activemq_install custom resource. This is currently experimental, but will eventually be the only install method

v2.0.4 (2015-12-03)

  • Add a new attribute for setting transport protocols: default['activemq']['transport_protocols']

v2.0.3 (2015-11-02)

  • Install tar for minimal rhel installs that might not have it
  • Test in Travis with kitchen-docker so each commit triggers a full integration test
  • Update the development and testing gems in the Gemfile

v2.0.2 (2015-09-24)

  • Add new attributes for controlling the SSL settings

    • default['activemq']['wrapper']['keystore_password']
    • default['activemq']['wrapper']['truststore_password']
    • default['activemq']['wrapper']['keystore_path']
    • default['activemq']['wrapper']['truststore_path']

v2.0.1 (2015-09-11)

  • Update metadata for the move from opscode-cookbooks to chef-cookbooks
  • Resolve rubocop warnings in the Rakefile and Rake tasks
  • Remove incorrect development documentation in the readme
  • Update the author to be the Cookbook Engineering Team
  • Add additional development gems for rake and cloud testing

v2.0.0 (2015-09-07)

  • Default to ActiveMQ version 5.12.0
  • Updated to the latest out of the box ActiveMQ config XML file so that newer installs could be successfully started. This is a 100% breaking change for older ActiveMQ installs.
  • Added new attribute to decide if the service should be started or not: node['activemq']['enabled']. Defaults to true, but can be used with wrapper cookbooks that need to install additional configs before starting ActiveMQ
  • Added new attribute to decide if Java should be installed or not: node['activemq']['install_java']. Defaults to true
  • Fixed wrapper.conf to only template if node['activemq']['use_default_config'] is set
  • Updated Berksfile to 3.0 format
  • Update Kitchen CI config with additional platforms and the attributes necessary for a clean converge
  • Update Travis CI to test on Ruby 2/2.1/2.2 and to use the containe infrastructure and bundler caching for faster tests
  • Removed yum as a dependency in the Berksfile since it's not actually used anywhere
  • Added the new contributing and testing docs
  • Add a maintainers file
  • Updated all development dependencies in the Gemfile
  • Clarified that Chef 11+ is required in the readme
  • Added Travis and Supermarket badges in the readme
  • Added scientific oracle, and amazon to the metdata file
  • Add source_url and issues_url metadata to the metadata file
  • Added minimal Chefspec to test recipe convergence
  • Updated .gitignore and added a chefignore file
  • Fix serverspec tests to run with the the latest serverspec release


  • Adding global amq distribution service switch

v1.3.4 (Development)

v1.3.3 (2015-04-03)

  • Metadata includes issues_url and source_url

v1.3.2 (2014-04-23)

  • [COOK-4557] activemq cookbook default mirror url is broken



  • COOK-3309 - Fix service (re)start command
  • COOK-2846 - Add support for openSUSE
  • COOK-2845 - Support differing versions of wrapper.conf


New Feature


  • [COOK-2816] - update version to 5.8.0
  • [COOK-2817] - resolve foodcritic warning


  • [COOK-800] - activemq cookbook should install 5.5.1 by default
  • [COOK-872] - activemq home directory isn't explicitly created

Collaborator Number Metric

4.1.0 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric

4.1.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Cookstyle Metric

4.1.0 failed this metric

Chef/Deprecations/FoodcriticFile: Do not include the `.foodcritic` config file for the deprecated Foodcritic cookbook linter. ( activemq/.foodcritic: 1
Chef/Deprecations/ResourceWithoutUnifiedTrue: Set `unified_mode true` in Chef Infra Client 15.3+ custom resources to ensure they work correctly in Chef Infra Client 18 (April 2022) when Unified Mode becomes the default. ( activemq/resources/install.rb: 1
Chef/Modernize/ConditionalUsingTest: Use ::File.exist?('/foo/bar') instead of the slower 'test -f /foo/bar' which requires shelling out ( activemq/recipes/default.rb: 81
Chef/Modernize/DefinesChefSpecMatchers: ChefSpec matchers are now auto generated by ChefSpec 7.1+ and do not need to be defined in a cookbook ( activemq/libraries/matchers.rb: 22

Run with Cookstyle Version 7.32.1 with cops Chef/Deprecations,Chef/Correctness,Chef/Sharing,Chef/RedundantCode,Chef/Modernize,Chef/Security,InSpec/Deprecations

No Binaries Metric

4.1.0 passed this metric

Testing File Metric

4.1.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Version Tag Metric

4.1.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must include a tag that matches this cookbook version number