The puma plugin provides basic, zero-configuration support for the default Rails web server.


Name Purpose Default
puma_control_token Auth token to use when connecting to the puma control server "tomo"
puma_control_url Connection URL for the puma control server "tcp://"
puma_stdout_path File where puma’s stdout will be written using the --redirect-stdout option "%<shared_path>/log/puma.out"
puma_stderr_path File where puma’s stderr will be written using the --redirect-stderr option "%<shared_path>/log/puma.err"



Attempts to restart the puma web server via pumactl. If puma is not already running or has crashed, this task will gracefully perform a cold start of the server instead. The puma gem must be present in the Rails application Gemfile for this task to work. Puma is started with this command:

bundle exec puma --daemon

The config/puma.rb file within the Rails app is used for configuration.

puma:restart is intended for use in a deploy, immediately following core:symlink_current to ensure that the new version of the Rails app is activated.