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
• Packaging Recipes

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

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

3rd Party Tutorials

• Testing
  • Testing Capistrano with Cucumber
• Other Software Packages
  • Drupal
  • 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/view/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 lighthouse project tracker - 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.