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


guacamole (2) Versions 0.1.1

Installs and configures Apache Guacamole, a clientless remote desktop gateway

cookbook 'guacamole', '~> 0.1.1'
cookbook 'guacamole', '~> 0.1.1', :supermarket
knife supermarket install guacamole
knife supermarket download guacamole
Quality 63%


This is my first attempt at writing a Chef cookbook. As I was playing around with AWS, I was looking for a remote desktop client that I could use to connect to my EC2 instances through a web browser as certain locations that I work at do not allow access through any other ports apart from 80 and 443. That was when I came across the <a href="">Apache Guacamole</a> project.

It seemed like a very nice project that was exactly what I needed but the documentation was only partially complete as it did not include documentation for the Java servlet containers. As such, I wrote this cookbook to deploy both the Guacamole Java servlet as well as the container, Tomcat in this case.

This cookbook will install all pre-requisites for Guacamole, download its source tarball and compile them. It will also modify the hosts file on the server, so please be aware of this!

This cook book is an initial version and is still a little messy, but it works! Don't deploy this into any production systems without first testing and understanding the steps involved!

<H2>Limitations</H2> This cookbook will only work on Ubuntu. I have only tested it on Ubuntu 14.04 using an AWS EC2 Ubuntu AMI using Chef 12. I have also only tested this with the latest version of Guacamole, 0.9.9 at this point in time. It will also only use the file based authentication method.

<H2>Other requirements</H2> There are two attributes for the user login in attributes/default.rb. By default, admin for both and you may want to change this before deploying the cookbook.

You may also want to modify the template user-mapping.xml template to include the servers you want to RDP or ssh into.

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

Collaborator Number Metric

0.1.1 failed this metric

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

Contributing File Metric

0.1.1 passed this metric

Foodcritic Metric

0.1.1 failed this metric

FC064: Ensure issues_url is set in metadata: guacamole/metadata.rb:1
FC066: Ensure chef_version is set in metadata: guacamole/metadata.rb:1
FC069: Ensure standardized license defined in metadata: guacamole/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric

0.1.1 passed this metric

Publish Metric

0.1.1 passed this metric

Supported Platforms Metric

0.1.1 passed this metric

Testing File Metric

0.1.1 passed this metric

Version Tag Metric

0.1.1 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