Home

General Resources & Beginner Guides

If you are new to Capistrano 2.x please read Getting Started, once you are familiar with the basics you may want to read From the beginning which is a much more detailed tutorial.

You may also want to read, and or contribute to the Capistrano handbook - an immature document that holds some really useful tips, but needs a lot more work!

• Github Guide to Deploying with Capistrano

Frameworks & Tools

• Using Capistrano 2.x with Rails 2.x

• Using Capistrano 2.x with Bundler

• Using Capistrano 2.x with RVM

Intermediate Resources

• Default Deployment Behaviour
• [[Managing database.yml Securely|http://www.simonecarletti.com/blog/2009/06/capistrano-and-database-yml/]]
• Packaging Recipes
• Writing Extensions

Reference Resources

• API Documentation
• DSL Documentation
  • Action Module (put(), get(), run(), stream(), capture(), etc)
  • Configuration Module (namespace(), task(), set(), fetch(), etc)
• Configuration Variables
• Capistrano Tasks
• Formatting Logs

Useful Background Knowledge (3rd Party Articles)

• Unix Shell

  • Unix shell skills (Wordpress guide, but very readable for beginners)

• Bash

  • Shell scripting for beginners

• SSH

  • Getting Started with SSH
  • What is an SSH Agent
  • How SSH Agent Forwarding Works
  • What are deploy keys?

Semi-Official Extensions

• Capistrano Multistage, Deploying to Multiple Environments
• Rails-less Deploy

3rd Party Extensions

• capistrano-windows-server Deploy Rails apps to Windows servers
• capistrano-offroad For deploying non-rails apps, specially Django
• capistrano_winrm Run commands against MS Windows servers with WinRM
• capify-ec2 A number of utilities to help with deploying to amazon ec2 instances
• resque_utils Helper tasks for remote Resque deployments (requeue & remove failed jobs)
• capistrano-ash For deploying Magento, Drupal, WordPress, and Zend/Doctrine apps
• play-capistrano For deploying/controlling remote Play Framework apps
• capifony For deploying symfony and Symfony2 apps
• capcake extension of Capistrano, deploy CakePHP apps
• capistrano-chef Integrates Capistrano with Chef search
• capistrano-puppet Integrates Capistrano with Puppet
• capistrano-deploytags Track your current and all previous releases with Git tags automatically at deployment time
• capistrano-detect-migrations Automatically discover and warn about pending Rails migrations with Git before you deploy
• capistrano-notifier Notify via mail and StatsD when deploying
• capistrano-remote-cache-with-project-root Adds a new deployment strategy to deploy your app from an internal folder (non-root).
• magentify Deployment recipes customised for deployment of Magento projects.

3rd Party Tutorials

• Testing
  • Testing Capistrano with Cucumber
• Other Software Packages
  • Drupal
  • Magento
    • http://www.designdisclosure.com/2012/04/deploy-magento-with-capistrano/
  • Wordpress
    • http://github.com/jestro/wordpress-capistrano/tree/master
    • http://whomwah.com/2006/05/21/deploying-wordpress-using-capistrano/
    • http://devblog.imedo.de/2008/6/23/wordpress-deployment-with-capistrano-2-and-git
    • http://www.tractionco.com/blog/95-deploying-wordpress-with-capistrano-and-svn
    • http://theme.fm/2011/08/tutorial-deploying-wordpress-with-capistrano-2082/
• Other Languages / Frameworks
  • PHP
    • http://mathew-davies.co.uk/2009/10/28/php-deployment.html
    • http://hivelogic.com/articles/deploying-expressionengine-github-capistrano
    • http://blog.servergrove.com/2011/09/07/deploying-symfony2-projects-on-shared-hosting-with-capifony
  • Any Non-Rails Project

Seeking Assistance

Help first and foremost via the Capistrano Google Group. Community support is also also often available in #Capistrano on freenode.

There are extensive archives of questions and answers also at stackoverflow.com, tagged #capistrano.

For bugs and problems please open an issue in the Github issues page - preferably with a patch, test-case, or steps-to-reproduce. Pull requests on Github will be ignored without a corresponding ticket, as there is no history of changes or forum for discussion without submitting a ticket.