Skip to content
This repository has been archived by the owner. It is now read-only.
Puma tasks for Mina (New repo
Branch: master
Clone or download
Latest commit 387ceb8 Mar 9, 2016
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE.txt init repo Nov 29, 2013 Update Mar 9, 2016
mina-puma.gemspec Removing puma dependency Dec 10, 2014

New maintainer here:

Mina Puma

Mina tasks for handle with Puma.

This gem provides several mina tasks:

mina puma:phased_restart  # Restart puma (with zero-downtime)
mina puma:restart         # Restart puma
mina puma:start           # Start puma
mina puma:stop            # Stop puma


Add this line to your application's Gemfile:

gem 'mina-puma', :require => false

And then execute:

$ bundle

Or install it yourself as:

$ gem install mina-puma

Note: by just including this gem, does not mean your development server will be Puma, for that, you need explicitly add gem 'puma' to your Gemfile.


Add this to your config/deploy.rb file:

require 'mina/puma'

Make sure the following settings are set in your config/deploy.rb:

  • deploy_to - deployment path

Make sure the following directories exists on your server:

  • shared/tmp/sockets - directory for socket files.
  • shared/tmp/pids - directory for pid files.

OR you can set other directories by setting follow variables:

  • puma_socket - puma socket file, default is shared/tmp/sockets/puma.sock
  • puma_pid - puma pid file, default shared/tmp/pids/
  • puma_state - puma state file, default shared/tmp/sockets/puma.state
  • pumactl_socket - pumactl socket file, default shared/tmp/sockets/pumactl.sock


$ mina puma:start


require 'mina/puma'

task :setup => :environment do
  # Puma needs a place to store its pid file and socket file.
  queue! %(mkdir -p "#{deploy_to}/#{shared_path}/tmp/sockets")
  queue! %(chmod g+rx,u+rwx "#{deploy_to}/#{shared_path}/tmp/sockets")
  queue! %(mkdir -p "#{deploy_to}/#{shared_path}/tmp/pids")
  queue! %(chmod g+rx,u+rwx "#{deploy_to}/#{shared_path}/tmp/pids")



# Add pids and sockets directories to shared paths
set :shared_paths, ['config/database.yml', 'tmp/pids', 'tmp/sockets']

task :deploy do
  deploy do
    invoke :'git:clone'
    invoke :'deploy:link_shared_paths'

    to :launch do
      invoke :'puma:phased_restart'


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request
You can’t perform that action at this time.