Scroll to navigation

PUMA(1) User Commands PUMA(1)

NAME

pumactl - command line client for puma

USAGE

pumactl [options...] [commands]

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

COMMANDS

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.

OPTIONS

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.

EXAMPLES

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

SEE ALSO

puma(1)

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

AUTHOR

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