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


guacamole (2) Versions 0.1.0

Installs and configures Apache Guacamole, a clientless remote desktop gateway

cookbook 'guacamole', '= 0.1.0', :supermarket
cookbook 'guacamole', '= 0.1.0'
knife supermarket install guacamole
knife supermarket download guacamole
Quality 0%


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!

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.0 failed this metric

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

Foodcritic Metric

0.1.0 failed this metric

FC033: Missing template: /tmp/4b35420bf285d0f822e4392f/guacamole/recipes/default.rb:8
FC033: Missing template: /tmp/4b35420bf285d0f822e4392f/guacamole/recipes/default.rb:85
FC033: Missing template: /tmp/4b35420bf285d0f822e4392f/guacamole/recipes/default.rb:89
FC033: Missing template: /tmp/4b35420bf285d0f822e4392f/guacamole/recipes/default.rb:93
FC064: Ensure issues_url is set in metadata: /tmp/4b35420bf285d0f822e4392f/guacamole/metadata.rb:1
FC065: Ensure source_url is set in metadata: /tmp/4b35420bf285d0f822e4392f/guacamole/metadata.rb:1