| CARVIEW |
Select Language
HTTP/2 200
server: GitHub.com
content-type: text/html; charset=utf-8
last-modified: Sat, 13 Dec 2025 02:19:24 GMT
access-control-allow-origin: *
etag: W/"693ccd2c-2f0a"
expires: Fri, 26 Dec 2025 18:28:32 GMT
cache-control: max-age=600
content-encoding: gzip
x-proxy-cache: MISS
x-github-request-id: C0B5:3A7A40:593C78:637D2C:694ED178
accept-ranges: bytes
age: 0
date: Fri, 26 Dec 2025 18:18:32 GMT
via: 1.1 varnish
x-served-by: cache-bom-vanm7210092-BOM
x-cache: MISS
x-cache-hits: 0
x-timer: S1766773113.578089,VS0,VE208
vary: Accept-Encoding
x-fastly-request-id: 90a86554eefba1c474ef93ea9d55b23ca39d7c28
content-length: 3840
A remote server automation and deployment tool written in Ruby.
What is Capistrano?
The Readme, start here!
Installation
Structure
Configuration
User Input
Preparing Your Application
Flow
Rollbacks
Cold Start
Version Locking
Tasks
Local Tasks
Before / After Hooks
Authentication & Authorisation
Introduction
Rails related tasks
Console
PTYs
Filtering
Properties
Property Filtering
Host filtering
Role Filtering
Custom Filters
Overriding Capistrano Tasks
Remote File Task
Remote Commands with SSHKit
Preventing file deployment with gitattributes
Validation of variables
Custom SCM
Official Plugins
3rd Party Plugins
Why does something work in an SSH session, but not in Capistrano?
How can I access stage configuration variables?
How can I check for existing remote file?
How can I get Capistrano to prompt for a password?
How can I set Capistrano configuration paths?
Capistrano 2 Documentation Repository
Upgrading from Capistrano 2.x to 3
01 Jun 2013 Capistrano Version 3 Release Announcement
Search
Overview
Getting Started
Task cookbook
Advanced Features
Plugins
FAQ
Legacy
Recent Announcements
A remote server automation and deployment tool written in Ruby.
A Simple Task
role :demo, %w{example.com example.org example.net}
task :uptime do
on roles(:demo), in: :parallel do |host|
uptime = capture(:uptime)
puts "#{host.hostname} reports: #{uptime}"
end
end
Capistrano extends the Rake DSL with methods specific to running commands
on() servers.
For Any Language
Capistrano is written in Ruby, but it can easily be used to deploy any language.
If your language or framework has special deployment requirements, Capistrano can easily be extended to support them.
Source Code