starman - Starman launcher
starman --listen :5001 --listen /tmp/starman.sock starman --workers 32 --port 8080
--listen HOST:PORT --listen :PORT --listen UNIX_SOCKET
Specifies the TCP address, ports and UNIX domain sockets to bind to wait for requests. You can repeat as many times as you want and mix TCP and UNIX domain sockets.
Defaults to any IP address and port 5000.
--host 127.0.0.1
Specifies the address to bind.
This option is for a compatiblity with plackup and you're recommended to use --listen instead.
--listen
--port 8080
Specifies the port to bind.
-S /tmp/starman.sock
Specifies the path to UNIX domain socket to bind.
Specifies the number of worker pool. Defaults to 5.
Starman by default sets up other spare server configuration based on this workers value, making sure there are always only N worker processes running. So even if there're no idle workers, Starman won't spawn off spare processes since that's mostly what you want to do by fine tuning the memory usage etc. in the production environment.
N
Specifies the number of backlog (listen queue size) of listener sockets. Defaults to 1024.
On production systems, setting a very low value can allow failover on frontend proxy (like nginx) to happen more quickly, if you have multiple Starman clusters.
If you're doing simple benchmarks and getting connection errors, increasing this parameter can help avoid them. You should also consider increasing net.core.somaxconn. Note that this is not recommended for real production system if you have another cluster to failover (see above).
net.core.somaxconn
Number of the requests to process per one worker process. Defaults to 1000.
Disable Keep-alive persistent connections. It is an useful workaround if you run Starman behind a broken frontend proxy that tries to pool connections more than a number of backend workers (i.e. Apache mpm_prefork + mod_proxy).
See `plackup -h` for more options.
Starman
To install Starman, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Starman
CPAN shell
perl -MCPAN -e shell install Starman
For more information on module installation, please visit the detailed CPAN module installation guide.