World Library  
Flag as Inappropriate
Email this Article

Capistrano (software)

Original author(s) Jamis Buck, Lee Hambley
Stable release 3.4.0[1] / March 2, 2015
Written in Ruby
Operating system POSIX (Linux, OpenBSD, OS X)
Type Deployment tool
License MIT License
Website .com.capistranorbwww

Capistrano is an open source tool for running scripts on multiple servers; its main use is deploying web applications. It automates the process of making a new version of an application available on one or more web servers, including supporting tasks such as changing databases.

Capistrano is written in the Ruby language and is distributed using the RubyGems distribution channel. It is an outgrowth of the Ruby on Rails web application framework, but it is also used to deploy web applications written using other frameworks, for example: PHP.

Capistrano is implemented primarily for use on the UNIX shell command line. A user may choose from many Capistrano recipes, e.g. to deploy current changes to the web application or roll back to the previous deployment state.

Originally called SwitchTower, the name was changed to Capistrano in March 2006 due to a trademark conflict. The original author, Jamis Buck, announced on February 24, 2009 that he is no longer the maintainer of the project.[2]


  • Internals 1
  • Example Capfile 2
  • See also 3
  • References 4
  • Further reading 5
  • External links 6


Capistrano is a utility and framework for executing commands in parallel on multiple remote machines, via SSH. It uses a simple domain-specific language borrowed in part from the tool Rake. It also supports tunnelling connections via some gateway machine to allow operations to be performed behind VPNs and firewalls.

Capistrano was originally designed to simplify and automate deployment of web applications to distributed environments, and originally came bundled with a set of tasks designed for deploying Ruby on Rails applications. The deployment tasks are now (as of Capistrano 2.0) opt-in and require clients to explicitly put "load 'deploy'" in their recipes.[3]

Example Capfile

task :xml_libs, :hosts => "" do
  run "ls -x1 /usr/lib | grep -i xml"

This defines a single task, called "xml_libs", and says that it should be executed only on the "" host. When executed, it will display all files and subdirectories in /usr/lib that include the text "xml" in their name. Assuming the capfile is in the current directory, the user would execute that task like this:

cap xml_libs

See also


  1. ^ "capistrano | | your community gem host". Retrieved 2015-03-02. 
  2. ^ "the { buckblogs :here }: Net::SSH, Capistrano, and Saying Goodbye". 2009-02-24. Retrieved 2014-03-21. 
  3. ^ "capistrano/ at master · capistrano/capistrano · GitHub". 2013-06-13. Retrieved 2014-03-21. 

Further reading

  • Zygmuntowicz, Ezra; Tate, Bruce; Begin, Clinton (May 2008). Deploying Rails Applications: A Step-by-Step Guide.  

External links

  • Official website
  • Capistrano Source Code
  • Capistrano's project
  • deprec project: Deployment Recipes for capistrano
  • Capistrano Changelog
  • Fabric, a similar system written in Python
  • tsshbatch, another similar system written in Python
This article was sourced from Creative Commons Attribution-ShareAlike License; additional terms may apply. World Heritage Encyclopedia content is assembled from numerous content providers, Open Access Publishing, and in compliance with The Fair Access to Science and Technology Research Act (FASTR), Wikimedia Foundation, Inc., Public Library of Science, The Encyclopedia of Life, Open Book Publishers (OBP), PubMed, U.S. National Library of Medicine, National Center for Biotechnology Information, U.S. National Library of Medicine, National Institutes of Health (NIH), U.S. Department of Health & Human Services, and, which sources content from all federal, state, local, tribal, and territorial government publication portals (.gov, .mil, .edu). Funding for and content contributors is made possible from the U.S. Congress, E-Government Act of 2002.
Crowd sourced content that is contributed to World Heritage Encyclopedia is peer reviewed and edited by our editorial staff to ensure quality scholarly research articles.
By using this site, you agree to the Terms of Use and Privacy Policy. World Heritage Encyclopedia™ is a registered trademark of the World Public Library Association, a non-profit organization.

Copyright © World Library Foundation. All rights reserved. eBooks from Hawaii eBook Library are sponsored by the World Library Foundation,
a 501c(4) Member's Support Non-Profit Organization, and is NOT affiliated with any governmental agency or department.