Hey! These docs are for version 2.8, which is no longer officially supported. Click here for the latest version, 2.14!
./pants run [args]

Runs a binary target.

This goal propagates the return code of the underlying executable.

If your application can safely be restarted while it is running, you can pass restartable=True on your binary target (for supported types), and the run goal will automatically restart them as all relevant files change. This can be particularly useful for server applications.

Config section: [run]

Basic options


--run-args="[<shell_str>, <shell_str>, ...]", ... -- [<shell_str> [<shell_str> [...]]]
default: []

Arguments to pass directly to the executed target, e.g. --run-args="val1 val2 --debug"

Advanced options


Deprecated options