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


transmission (33) Versions 2.2.0

Installs and configures transmission

cookbook 'transmission', '= 2.2.0', :supermarket
cookbook 'transmission', '= 2.2.0'
knife supermarket install transmission
knife supermarket download transmission
Quality 100%

transmission Cookbook

Build Status Cookbook Version

Installs the Transmission BitTorrent Client and includes a transmission_torrent_file LWRP.



  • Debian/Ubuntu
  • RHEL/CentOS/Scientific/Amazon/Oracle 7+
  • Fedora

Note: Package installs are only availabe on Ubuntu/Debian. Source installs are possible on all platforms


  • Chef 11+


  • build-essential - for compiling the source.
  • openssl - for generating a secure password.


  • node["transmission"]["peer_port"] - The port Transmission listens on for peering, default 51413.
  • node["transmission"]["rpc_bind_address"] - Where to listen for RPC connections, default
  • node["transmission"]["rpc_port"] - The port Transmission listens on for remote services, default 9091.
  • node["transmission"]["rpc_username"] - The username required to access remote services, default transmission.
  • node["transmission"]["rpc_password"] - The ssha1 encrypted password, default generated by secure_password.
  • node["transmission"]["home"] - Transmission's home directory, default /var/lib/transmission-daemon.
  • node["transmission"]["config_dir"] - Transmission's config directory, default /var/lib/transmission-daemon/info.
  • node["transmission"]["download_dir"] - Directory to move complete files to, default /var/lib/transmission-daemon/downloads.
  • node["transmission"]["incomplete_dir"] - Directory to keep incomplete files in, default /var/lib/transmission-daemon/incomplete.
  • node["transmission"]["incomplete_dir_enabled"] - Whether the incomplete file directory is used, default false.
  • node["transmission"]["speed_limit_down"] - The KB/s limit for downloading files, default 100.
  • node["transmission"]["speed_limit_down_enabled"] - Whether the download limit is used, default false.
  • node["transmission"]["speed_limit_up"] - The KB/s limit for uploading files, default 100.
  • node["transmission"]["speed_limit_up_enabled"] - Whether the upload limit is used, default false.
  • node["transmission"]["watch_dir"] - Directory to watch for new torrent files, default /var/lib/transmission-daemon/watch.
  • node["transmission"]["watch_dir_enabled"] - Whether the watch file directory is used, default false.

The file also contains the following attribute types:
- platform specific locations and settings.
- source installation settings



Download a file via the BitTorrent protocol. The usage semantics are like that of the existing file and remote_file resources. This allows very fast downloads for files that are part of large BitTorrent swarms. The Ubuntu 10.04 LTS ISO (around 700MB) downloads in about 50 seconds.


  • :create: Download a file via the BitTorrent protocol

Attribute Parameters

  • path: name attribute. the path to the file
  • torrent: torrent file of the swarm to join. can either be a url or local file path
  • blocking: should the file be downloaded in a blocking way? If true Chef will download the file in a single Chef run, if false Chef will check for a completed download during each Chef run until the download is complete. default is true.
  • continue_seeding: should the file continue to be seeded to the swarm after download? default is false.
  • owner: The owner for the file
  • group: The group owner of the file (string or id)
  • rpc_host: the address of the Transmission RPC host to connect to. default is localhost.
  • rpc_port: the port of the Transmission RPC host to connect to. default is 9091.
  • rpc_username: the username of the Transmission RPC account. default is transmission.
  • rpc_password: the password of the Transmission RPC account . should probably be node['transmission']['rpc_password'] which by default is a secure password generated for this node.


Download the lucid ISO

transmission_torrent_file "/home/ubuntu/ubuntu.iso"  do
  torrent ""
  owner 'ubuntu'
  group 'ubuntu'
  rpc_username node['transmission']['rpc_username']
  rpc_password node['transmission']['rpc_password']
  action :create

Continue seeding after download

transmission_torrent_file "/home/ubuntu/ubuntu.iso"  do
  torrent ""
  owner 'ubuntu'
  group 'ubuntu'
  continue_seeding true
  rpc_username node['transmission']['rpc_username']
  rpc_password node['transmission']['rpc_password']
  action :create



Include default recipe in a run list, to get some Transmission installed. Installs Transmission by package or source depending on the platform.


Installs Transmission from packages. This should only be loaded by the default recipe.


Installs Transmission from source. This should only be loaded by the default recipe.

License & Authors

Author: Cookbook Engineering Team (

Copyright: 2011-2016, 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

openssl >= 0.0.0
build-essential >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

transmission Cookbook CHANGELOG

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

2.2.0 (2016-08-11)

  • Fix up chef_gem compile time warnings.
  • Add support for transmission whitelist settings.
  • Add use_inline_resources
  • Add conditional to support older versions of chef.
  • Update testing
  • Specif version 4.x of activesupport to fix installs on Ruby 2.1 Chef omnibus

v2.1.1 (2016-01-08)

  • Add supports metadata for all supported platforms

v2.1.0 (2016-01-08)

  • Fixed installation via source on RHEL systems by adding openssl / tar packages to the source recipe
  • Switched to platform_family to better support derivitive operating systems
  • Updated to the latest version of Transmission for source installs
  • Switched from .bz2 to .xz format archives for source installs as .bz2 archives are no longer being published. Xz tools will now be installed in the source recipe
  • Added source test suite in Test Kitchen
  • Removed support for RHEL releases before 7 as the version of libevent shipped in these distros is too old to compile tranmission

v2.0.10 (2015-12-14)

  • Set the minimum supported Chef release to 11
  • Removed the monkeypatch to Ruby 1.8.6 support
  • Resolved all rubocop warnings
  • Added testing with Travis CI
  • Added chefignore file
  • Swaped Digital Ocean Test Kitchen config for Docker
  • Added standard Chef .rubocop.yml
  • Updated contributing and testing docs
  • Added Gemfile with development deps
  • Added maintainers file
  • Added a Rakefile for simplified testing

v2.0.9 (2015-02-18)

  • reverting OpenSSL module namespace change

v2.0.8 (2015-02-18)

  • reverting chef_gem compile_time work

v2.0.7 (2015-02-18)

  • Updating to use the latest openssl

v2.0.6 (2015-02-18)

  • Fixing chef_gem for Chef below 12.1.0

v2.0.4 (2014-09-18)

  • [#11] prevent circular symlink for settings.json on Ubuntu 14.04
  • Add Berksfile and test-kitchen config

v2.0.2 (2014-03-19)

  • [COOK-4424] Updates Transmission url in README'


Requires Ruby 1.9 or higher!


  • COOK-3451 - Use Hash#key to silence Hash#index deprecation warnings
  • COOK-3450 - Delete torrent local data when not seeding
  • COOK-3449 - Prevent torrent status of checking from prematurely ending blocking downloads
  • COOK-3324 - Use BEncode.load_file to load torrent file when hashing to avoid UTF-8 encoding issues




  • [COOK-2981]: transmission cookbook has foodcritic errors


  • [COOK-729]: transmission_torrent_file doesn't work for more than a single torrent
  • [COOK-732]: link to file in swarm not created if torrent already completely downloaded

Collaborator Number Metric

2.2.0 passed this metric

Foodcritic Metric

2.2.0 passed this metric