1. Resources
  2. /
  3. Plugins
  4. /
  5. capistrano-buildkite-plugin

Capistrano Deployment Buildkite Plugin

Build status

A Buildkite plugin to deploy a project using Capistrano.

Example

This will deploy a project using the given branch-to-stage mapping. If the current branch being built doesn’t have a Capistrano stage associated with it, nothing happens.

steps:
  - plugins:
      - forumone/capistrano#v1.0.0:
          branches:
            master: dev
            stable: staging
            live: production

In this example, the plugin will fail if a Capistrano stage couldn’t be found.

steps:
  - plugins:
      - forumone/capistrano#v1.0.0:
          require-stage: true
          branches:
            master: dev
            stable: staging
            live: production

This runs a deployment by specifying additional arguments.

steps:
  - plugins:
      - forumone/capistrano#v1.0.0:
          extra-args:
            - foo=bar
          branches:
            master: dev
            stable: staging
            live: production

Options

branches

An object mapping Git branch names to Capistrano stages (the argument you pass to cap <env> deploy).

require-stage (optional)

When set to true, requires that a stage be found for the given branch. Useful when the logic for skipping deployments can be found elsewhere (using Buildkite’s if key or another plugin). By default, this value is false.

extra-args (optional)

If your Capistrano configuration needs additional arguments, you may specify them here. This uses a YAML list in order to respect potential hazards with spaces and quoting.

The plugins listed on this webpage are provided for informational purposes only. They have not undergone any formal security review or assessment. While we strive to provide useful resources, we cannot guarantee the safety, reliability, or integrity of these plugins. Users are strongly advised to conduct their own security evaluations before downloading, installing, or using any plugin. By using these plugins, you acknowledge and accept any risks associated with their use. We disclaim any liability for any harm or damages arising from the use of the plugins listed.

Start turning complexity into an advantage

Create an account to get started with a 30-day free trial. No credit card required.

Buildkite Pipelines

Platform

  1. Pipelines
  2. Pipeline templates
  3. Public pipelines
  4. Test Engine
  5. Package Registries
  6. Mobile Delivery Cloud
  7. Pricing

Hosting options

  1. Self-hosted agents
  2. Mac hosted agents
  3. Linux hosted agents

Resources

  1. Docs
  2. Blog
  3. Changelog
  4. Webinars
  5. Plugins
  6. Case studies
  7. Events
  8. Migration Services
  9. Comparisons

Company

  1. About
  2. Careers
  3. Press
  4. Brand assets
  5. Contact

Solutions

  1. Replace Jenkins
  2. Workflows for AI/ML
  3. Testing at scale
  4. Monorepo mojo
  5. Bazel orchestration

Legal

  1. Terms of Service
  2. Acceptable Use Policy
  3. Privacy Policy
  4. Subprocessors
  5. Service Level Agreement

Support

  1. System status
  2. Forum
© Buildkite Pty Ltd 2025