DOKK / manpages / debian 12 / puma / pumactl.1.en
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://127.0.0.1:9293 --control-token foo
pumactl --control-url 'tcp://127.0.0.1:9293' --control-token foo restart

puma(1)

There is extensive documentation at <https://puma.io/puma/> and <https://github.com/puma/puma>.

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

January 2020 PUMA 3.12