Scroll to navigation

PUMA(1) User Commands PUMA(1)


pumactl - command line client for puma


pumactl [options...] [commands]

pumactl [-h | --help | -V | --version]


Halt the server.
Restart the server.
Restart server but phase out old workers while starting new workers one at a time.
Start the server.
Show stats about the server.
Show server status.
Stop server.
Reload the worker directory.
Start garbage collector.
Show information about garbage collector.


The following options are available:

Load given path as a config file.
The TOKEN to use as authentication for the control server.
The bind URL to use for the control server and app. Use auto to use a temp unix server. This requires to use a --control-token, which needs to be given with every request to the control server (token=foo).
Define the TCP port to bind to. Use -b for more advanced options.
Use the given path as PID file.
Don't display messages.
Where the state file is.
Show help.
Print the version information.


Create a control server and use pumactl(1) to interact with the control server to restart puma.

puma --control-url tcp:// --control-token foo
pumactl --control-url 'tcp://' --control-token foo restart



There is extensive documentation at <> and <>.


This manual page was written by Daniel Leidert <>, for the Debian GNU/Linux system (but may be used by others).

January 2020 PUMA 3.12