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


roundcube (2) Versions 0.2.0

Installs/Configures Roundcube Webmail.

cookbook 'roundcube', '~> 0.2.0', :supermarket
cookbook 'roundcube', '~> 0.2.0'
knife supermarket install roundcube
knife supermarket download roundcube
Quality 17%

Roundcube Webmail Cookbook

Roundcube Cookbook
Build Status
Code Climate

A Chef cookbook for Roundcube Webmail, a PHP-based webmail application.



Database Setup

This cookbook purposely does not provide any functionality to setup and configure the database component of Roundcube. It is recommended that a different host is used as the database server.

Create a database and import the initial SQl, see

MySQL Quick Setup

Grant privileges
GRANT ALL ON *.* to roundcube@localhost IDENTIFIED BY 's3cure_as';

Or, all hosts:

GRANT ALL ON *.* to roundcube@'%' IDENTIFIED BY 's3cure_as';


Supported Platforms

  • Debian/Ubuntu

Contribution for other platforms welcome (submit a pull request).


  • node['roundcube']['version'] - Roundcube Version string
  • node['roundcube']['download_url'] - URL to fetch the Roundcube tarball from
  • node['roundcube']['download_checksum'] - The checksum of the Roundcube tarball
  • node['roundcube']['install_dir'] - The destination directory to extract Roundcube to (minus the trailing /roundcube)
  • node['roundcube']['default_host'] - The IMAP server host for Roundcube to interface
  • node['roundcube']['support_url'] - The support URL to display for the Roundcube service
  • node['roundcube']['product_name'] - The product name to display for the Roundcube service
  • node['roundcube']['skin'] - The name of the skin to use for Roundcube's appearance
  • node['roundcube']['listen_port'] - The listen port to configure with Roundcube's web server
  • node['roundcube']['server_name'] - The server_name to configure with Roundcube's web server
  • node['roundcube']['database']['user'] - Username to grant access privileges for database
  • node['roundcube']['database']['password'] - Database password for the roundcube database user
  • node['roundcube']['database']['schema'] - Name of the Roundcube database
  • node['roundcube']['smtp']['server'] - The hostname or IP of the SMTP server for Roundcube to interface with for sending mails
  • node['roundcube']['smtp']['port'] - The port of the SMTP server for sending mails
  • node['roundcube']['smtp']['user'] = The SMTP username
  • node['roundcube']['smtp']['password'] = The SMTP password



The default recipe will update the apt package list initially, then install PHP & MySQL client and lastly install and configure Roundcube.


Installs Roundcube as defined by node attributes using ark.


Configures Roundcube only.


Installs and configures NGINX including needed dependencies and a vhost for Roundcube.


A dry recipe that provides a configuration file for an NGINX Roundcube vhost only. The NGINX service is notified to restart.


The default recipe will install and configure Roundcube intefacing GMail for both IMAP and SMTP; no web server is configured - it is recommended to also add the roundcube::nginx recipe to the run_list (Apache HTTPd support TODO or contrib welcome).

When utilizing the nginx recipe, the php-fpm cookbook is used to configure PHP-FPM which by default provides a pool named 'www' with the socket residing in /var/run/php-fpm-www.sock.

Note: this cookbook does not configure a database server for Roundcube, this should be done independently (see prerequisites above).


For further prototyping Roundcube on a server node:


For Roundcube itself, see

License & Authors

Copyright 2014 Chris Fordham

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.

roundcube CHANGELOG

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


  • [your_name] - Initial release of roundcube

Check the Markdown Syntax Guide for help with Markdown.

The Github Flavored Markdown page describes the differences between markdown on github and standard markdown.

Collaborator Number Metric

0.2.0 failed this metric

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

Contributing File Metric

0.2.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

Foodcritic Metric

0.2.0 failed this metric

FC064: Ensure issues_url is set in metadata: roundcube/metadata.rb:1
FC065: Ensure source_url is set in metadata: roundcube/metadata.rb:1
FC066: Ensure chef_version is set in metadata: roundcube/metadata.rb:1
FC069: Ensure standardized license defined in metadata: roundcube/metadata.rb:1
FC072: Metadata should not contain "attribute" keyword: roundcube/metadata.rb:1
FC121: Cookbook depends on cookbook made obsolete by Chef 14: roundcube/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric

0.2.0 passed this metric

Testing File Metric

0.2.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

0.2.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