Capistrano: Less deploy output, better overview

Posted . Visible to the public.

Capistrano is quite verbose during deploy. In practice, almost all of its output is noise to me. It would be much more helpful if showed me an overview of total progress.

Here it is:
Image

Errors should still print to the console, and a full log is always available at log/capistrano.log.

You can have this, too:

Installation

  • Store the attached formatter in lib/capistrano/

  • In Capfile: require_relative 'lib/capistrano/custom_formatting' if ARGV.include?('deploy')

  • If you like a reminder where to find the full log, add a deploy task (e.g. to lib/capistrano/tasks/deploy.rake, or right inside Capfile):

namespace :deploy do

  task :print_full_log_location do
    log_file = fetch(:format_options, {}).fetch(:log_file, 'log/capistrano.log')
    puts "Full logs at #{File.expand_path(log_file, Dir.pwd)}"
  end

end
  • Then add a deploy hook (e.g. in Capfile): before 'deploy:starting', 'deploy:print_full_log_location'
Profile picture of Dominik Schöler
Dominik Schöler
Last edit
Dominik Schöler
License
Source code in this card is licensed under the MIT License.
Posted by Dominik Schöler to makandra dev (2026-06-23 08:55)