Forge Home


Setup a basic deployment target for the Rails deploy tool capistrano


11,716 latest version

2.0 quality score

Version information

  • 0.1.2 (latest)
  • 0.1.1
  • 0.1.0
released Aug 12th 2014

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'deversus-capistrano', '0.1.2'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add deversus-capistrano
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install deversus-capistrano --version 0.1.2

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



deversus/capistrano — version 0.1.2 Aug 12th 2014



Setup a basic deployment target for the Rails deploy tool capistrano.

Ensures the specific directory structure capistrano expects and sets the right permissions and ownership for everything.

For a more comperhensive Rails deployment recipe which makes use of this module, see deversus-rails.

Requests & patches welcome.


include capistrano

capistrano::deploytarget {'myapp':
    deploy_user    => 'capistrano',
    share_group    => 'puma',
    deploy_dir     => '/var/www/myapp/',                   # default
    shared_dirs    => ['log', 'pids', 'system', 'assets'], # default

This would create:

  • /var/www/myapp/release owned by capistrano
  • /var/www/myapp/shared owned by capistrano and the group puma (your web server will usually need access to this directory), and subdirectories:
    • /var/www/myapp/shared/log
    • /var/www/myapp/shared/pids
    • /var/www/myapp/shared/system
    • /var/www/myapp/shared/assets

Capistrano should run happily the first time using this structure.