uwsgi_php - Online in the Cloud

PROGRAM:

NAME

uwsgi_php - fast (pure C), self-healing, developer-friendly WSGI server

SYNOPSIS

uwsgi-core-local [options...]

DESCRIPTION

-s|--socket
bind to the specified UNIX/TCP socket using default protocol

-s|--uwsgi-socket
bind to the specified UNIX/TCP socket using uwsgi protocol

--suwsgi-socket
bind to the specified UNIX/TCP socket using uwsgi protocol over SSL

--ssl-socket
bind to the specified UNIX/TCP socket using uwsgi protocol over SSL

--http-socket
bind to the specified UNIX/TCP socket using HTTP protocol

--http-socket-modifier1
force the specified modifier1 when using HTTP protocol

--http-socket-modifier2
force the specified modifier2 when using HTTP protocol

--https-socket
bind to the specified UNIX/TCP socket using HTTPS protocol

--https-socket-modifier1
force the specified modifier1 when using HTTPS protocol

--https-socket-modifier2
force the specified modifier2 when using HTTPS protocol

--fastcgi-socket
bind to the specified UNIX/TCP socket using FastCGI protocol

--fastcgi-nph-socket
bind to the specified UNIX/TCP socket using FastCGI protocol (nph mode)

--fastcgi-modifier1
force the specified modifier1 when using FastCGI protocol

--fastcgi-modifier2
force the specified modifier2 when using FastCGI protocol

--scgi-socket
bind to the specified UNIX/TCP socket using SCGI protocol

--scgi-nph-socket
bind to the specified UNIX/TCP socket using SCGI protocol (nph mode)

--scgi-modifier1
force the specified modifier1 when using SCGI protocol

--scgi-modifier2
force the specified modifier2 when using SCGI protocol

--raw-socket
bind to the specified UNIX/TCP socket using RAW protocol

--raw-modifier1
force the specified modifier1 when using RAW protocol

--raw-modifier2
force the specified modifier2 when using RAW protocol

--puwsgi-socket
bind to the specified UNIX/TCP socket using persistent uwsgi protocol (puwsgi)

--protocol
force the specified protocol for default sockets

--socket-protocol
force the specified protocol for default sockets

--shared-socket
create a shared socket for advanced jailing or ipc

--undeferred-shared-socket
create a shared socket for advanced jailing or ipc (undeferred mode)

-p|--processes
spawn the specified number of workers/processes

-p|--workers
spawn the specified number of workers/processes

--thunder-lock
serialize accept() usage (if possible)

-t|--harakiri
set harakiri timeout

--harakiri-verbose
enable verbose mode for harakiri

--harakiri-no-arh
do not enable harakiri during after-request-hook

--no-harakiri-arh
do not enable harakiri during after-request-hook

--no-harakiri-after-req-hook
do not enable harakiri during after-request-hook

--backtrace-depth
set backtrace depth

--mule-harakiri
set harakiri timeout for mule tasks

-x|--xmlconfig
load config from xml file

-x|--xml
load config from xml file

--config
load configuration using the pluggable system

--fallback-config
re-exec uwsgi with the specified config when exit code is 1

--strict
enable strict mode (placeholder cannot be used)

--skip-zero
skip check of file descriptor 0

--skip-atexit
skip atexit hooks (ignored by the master)

-S|--set
set a placeholder or an option

--set-placeholder
set a placeholder

--set-ph
set a placeholder

--get print the specified option value and exit

--declare-option
declare a new uWSGI custom option

--declare-option2
declare a new uWSGI custom option (non-immediate)

--resolve
place the result of a dns query in the specified placeholder, sytax:
placeholder=name (immediate option)

--for (opt logic) for cycle

--for-glob
(opt logic) for cycle (expand glob)

--for-times
(opt logic) for cycle (expand the specified num to a list starting from 1)

--for-readline
(opt logic) for cycle (expand the specified file to a list of lines)

--endfor
(opt logic) end for cycle

--end-for
(opt logic) end for cycle

--if-opt
(opt logic) check for option

--if-not-opt
(opt logic) check for option

--if-env
(opt logic) check for environment variable

--if-not-env
(opt logic) check for environment variable

--ifenv
(opt logic) check for environment variable

--if-reload
(opt logic) check for reload

--if-not-reload
(opt logic) check for reload

--if-hostname
(opt logic) check for hostname

--if-not-hostname
(opt logic) check for hostname

--if-hostname-match
(opt logic) try to match hostname against a regular expression

--if-not-hostname-match
(opt logic) try to match hostname against a regular expression

--if-exists
(opt logic) check for file/directory existence

--if-not-exists
(opt logic) check for file/directory existence

--ifexists
(opt logic) check for file/directory existence

--if-plugin
(opt logic) check for plugin

--if-not-plugin
(opt logic) check for plugin

--ifplugin
(opt logic) check for plugin

--if-file
(opt logic) check for file existance

--if-not-file
(opt logic) check for file existance

--if-dir
(opt logic) check for directory existance

--if-not-dir
(opt logic) check for directory existance

--ifdir
(opt logic) check for directory existance

--if-directory
(opt logic) check for directory existance

--endif
(opt logic) end if

--end-if
(opt logic) end if

--blacklist
set options blacklist context

--end-blacklist
clear options blacklist context

--whitelist
set options whitelist context

--end-whitelist
clear options whitelist context

--ignore-sigpipe
do not report (annoying) SIGPIPE

--ignore-write-errors
do not report (annoying) write()/writev() errors

--write-errors-tolerance
set the maximum number of allowed write errors (default: no tolerance)

--write-errors-exception-only
only raise an exception on write errors giving control to the app itself

--disable-write-exception
disable exception generation on write()/writev()

--inherit
use the specified file as config template

--include
include the specified file as immediate configuration

--inject-before
inject a text file before the config file (advanced templating)

--inject-after
inject a text file after the config file (advanced templating)

-d|--daemonize
daemonize uWSGI

--daemonize2
daemonize uWSGI after app loading

--stop stop an instance

--reload
reload an instance

--pause
pause an instance

--suspend
suspend an instance

--resume
resume an instance

--connect-and-read
connect to a socket and wait for data from it

--extract
fetch/dump any supported address to stdout

-l|--listen
set the socket listen queue size

-v|--max-vars
set the amount of internal iovec/vars structures

--max-apps
set the maximum number of per-worker applications

-b|--buffer-size
set internal buffer size

-m|--memory-report
enable memory report

--profiler
enable the specified profiler

-c|--cgi-mode
force CGI-mode for plugins supporting it

-a|--abstract-socket
force UNIX socket in abstract mode (Linux only)

-C|--chmod-socket
chmod-socket

-C|--chmod
chmod-socket

--chown-socket
chown unix sockets

--umask
set umask

--freebind
put socket in freebind mode

--map-socket
map sockets to specific workers

-T|--enable-threads
enable threads

--no-threads-wait
do not wait for threads cancellation on quit/reload

--auto-procname
automatically set processes name to something meaningful

--procname-prefix
add a prefix to the process names

--procname-prefix-spaced
add a spaced prefix to the process names

--procname-append
append a string to process names

--procname
set process names

--procname-master
set master process name

-i|--single-interpreter
do not use multiple interpreters (where available)

--need-app
exit if no app can be loaded

-M|--master
enable master process

--honour-stdin
do not remap stdin to /dev/null

--emperor
run the Emperor

--emperor-proxy-socket
force the vassal to became an Emperor proxy

--emperor-wrapper
set a binary wrapper for vassals

--emperor-wrapper-override
set a binary wrapper for vassals to try before the default one

--emperor-wrapper-fallback
set a binary wrapper for vassals to try as a last resort

--emperor-nofollow
do not follow symlinks when checking for mtime

--emperor-procname
set the Emperor process name

--emperor-freq
set the Emperor scan frequency (default 3 seconds)

--emperor-required-heartbeat
set the Emperor tolerance about heartbeats

--emperor-curse-tolerance
set the Emperor tolerance about cursed vassals

--emperor-pidfile
write the Emperor pid in the specified file

--emperor-tyrant
put the Emperor in Tyrant mode

--emperor-tyrant-nofollow
do not follow symlinks when checking for uid/gid in Tyrant mode

--emperor-stats
run the Emperor stats server

--emperor-stats-server
run the Emperor stats server

--early-emperor
spawn the emperor as soon as possibile

--emperor-broodlord
run the emperor in BroodLord mode

--emperor-throttle
set throttling level (in milliseconds) for bad behaving vassals (default 1000)

--emperor-max-throttle
set max throttling level (in milliseconds) for bad behaving vassals (default 3
minutes)

--emperor-magic-exec
prefix vassals config files with exec:// if they have the executable bit

--emperor-on-demand-extension
search for text file (vassal name + extension) containing the on demand socket name

--emperor-on-demand-ext
search for text file (vassal name + extension) containing the on demand socket name

--emperor-on-demand-directory
enable on demand mode binding to the unix socket in the specified directory named
like the vassal + .socket

--emperor-on-demand-dir
enable on demand mode binding to the unix socket in the specified directory named
like the vassal + .socket

--emperor-on-demand-exec
use the output of the specified command as on demand socket name (the vassal name
is passed as the only argument)

--emperor-extra-extension
allows the specified extension in the Emperor (vassal will be called with --config)

--emperor-extra-ext
allows the specified extension in the Emperor (vassal will be called with --config)

--emperor-no-blacklist
disable Emperor blacklisting subsystem

--emperor-use-clone
use clone() instead of fork() passing the specified unshare() flags

--emperor-cap
set vassals capability

--vassals-cap
set vassals capability

--vassal-cap
set vassals capability

--imperial-monitor-list
list enabled imperial monitors

--imperial-monitors-list
list enabled imperial monitors

--vassals-inherit
add config templates to vassals config (uses --inherit)

--vassals-include
include config templates to vassals config (uses --include instead of --inherit)

--vassals-inherit-before
add config templates to vassals config (uses --inherit, parses before the vassal
file)

--vassals-include-before
include config templates to vassals config (uses --include instead of --inherit,
parses before the vassal file)

--vassals-start-hook
run the specified command before each vassal starts

--vassals-stop-hook
run the specified command after vassal's death

--vassal-sos
ask emperor for reinforcement when overloaded

--vassal-sos-backlog
ask emperor for sos if backlog queue has more items than the value specified

--vassals-set
automatically set the specified option (via --set) for every vassal

--vassal-set
automatically set the specified option (via --set) for every vassal

--heartbeat
announce healthiness to the emperor

--reload-mercy
set the maximum time (in seconds) we wait for workers and other processes to die
during reload/shutdown

--worker-reload-mercy
set the maximum time (in seconds) a worker can take to reload/shutdown (default is
60)

--mule-reload-mercy
set the maximum time (in seconds) a mule can take to reload/shutdown (default is
60)

--exit-on-reload
force exit even if a reload is requested

--die-on-term
exit instead of brutal reload on SIGTERM

--force-gateway
force the spawn of the first registered gateway without a master

-h|--help
show this help

-h|--usage
show this help

--print-sym
print content of the specified binary symbol

--print-symbol
print content of the specified binary symbol

-r|--reaper
call waitpid(-1,...) after each request to get rid of zombies

-R|--max-requests
reload workers after the specified amount of managed requests

--min-worker-lifetime
number of seconds worker must run before being reloaded (default is 60)

--max-worker-lifetime
reload workers after the specified amount of seconds (default is disabled)

-z|--socket-timeout
set internal sockets timeout

--no-fd-passing
disable file descriptor passing

--locks
create the specified number of shared locks

--lock-engine
set the lock engine

--ftok set the ipcsem key via ftok() for avoiding duplicates

--persistent-ipcsem
do not remove ipcsem's on shutdown

-A|--sharedarea
create a raw shared memory area of specified pages (note: it supports keyval too)

--safe-fd
do not close the specified file descriptor

--fd-safe
do not close the specified file descriptor

--cache
create a shared cache containing given elements

--cache-blocksize
set cache blocksize

--cache-store
enable persistent cache to disk

--cache-store-sync
set frequency of sync for persistent cache

--cache-no-expire
disable auto sweep of expired items

--cache-expire-freq
set the frequency of cache sweeper scans (default 3 seconds)

--cache-report-freed-items
constantly report the cache item freed by the sweeper (use only for debug)

--cache-udp-server
bind the cache udp server (used only for set/update/delete) to the specified socket

--cache-udp-node
send cache update/deletion to the specified cache udp server

--cache-sync
copy the whole content of another uWSGI cache server on server startup

--cache-use-last-modified
update last_modified_at timestamp on every cache item modification (default is
disabled)

--add-cache-item
add an item in the cache

--load-file-in-cache
load a static file in the cache

--load-file-in-cache-gzip
load a static file in the cache with gzip compression

--cache2
create a new generation shared cache (keyval syntax)

--queue
enable shared queue

--queue-blocksize
set queue blocksize

--queue-store
enable persistent queue to disk

--queue-store-sync
set frequency of sync for persistent queue

-Q|--spooler
run a spooler on the specified directory

--spooler-external
map spoolers requests to a spooler directory managed by an external instance

--spooler-ordered
try to order the execution of spooler tasks

--spooler-chdir
chdir() to specified directory before each spooler task

--spooler-processes
set the number of processes for spoolers

--spooler-quiet
do not be verbose with spooler tasks

--spooler-max-tasks
set the maximum number of tasks to run before recycling a spooler

--spooler-harakiri
set harakiri timeout for spooler tasks

--spooler-frequency
set spooler frequency

--spooler-freq
set spooler frequency

--mule add a mule

--mules
add the specified number of mules

--farm add a mule farm

--mule-msg-size
set mule message buffer size

--signal
send a uwsgi signal to a server

--signal-bufsize
set buffer size for signal queue

--signals-bufsize
set buffer size for signal queue

--signal-timer
add a timer (syntax: <signal> <seconds>)

--timer
add a timer (syntax: <signal> <seconds>)

--signal-rbtimer
add a redblack timer (syntax: <signal> <seconds>)

--rbtimer
add a redblack timer (syntax: <signal> <seconds>)

--rpc-max
maximum number of rpc slots (default: 64)

-L|--disable-logging
disable request logging

--flock
lock the specified file before starting, exit if locked

--flock-wait
lock the specified file before starting, wait if locked

--flock2
lock the specified file after logging/daemon setup, exit if locked

--flock-wait2
lock the specified file after logging/daemon setup, wait if locked

--pidfile
create pidfile (before privileges drop)

--pidfile2
create pidfile (after privileges drop)

--chroot
chroot() to the specified directory

--pivot-root
pivot_root() to the specified directories (new_root and put_old must be separated
with a space)

--pivot_root
pivot_root() to the specified directories (new_root and put_old must be separated
with a space)

--uid setuid to the specified user/uid

--gid setgid to the specified group/gid

--add-gid
add the specified group id to the process credentials

--immediate-uid
setuid to the specified user/uid IMMEDIATELY

--immediate-gid
setgid to the specified group/gid IMMEDIATELY

--no-initgroups
disable additional groups set via initgroups()

--cap set process capability

--unshare
unshare() part of the processes and put it in a new namespace

--unshare2
unshare() part of the processes and put it in a new namespace after rootfs change

--setns-socket
expose a unix socket returning namespace fds from /proc/self/ns

--setns-socket-skip
skip the specified entry when sending setns file descriptors

--setns-skip
skip the specified entry when sending setns file descriptors

--setns
join a namespace created by an external uWSGI instance

--setns-preopen
open /proc/self/ns as soon as possible and cache fds

--jailed
mark the instance as jailed (force the execution of post_jail hooks)

--refork
fork() again after privileges drop. Useful for jailing systems

--re-fork
fork() again after privileges drop. Useful for jailing systems

--refork-as-root
fork() again before privileges drop. Useful for jailing systems

--re-fork-as-root
fork() again before privileges drop. Useful for jailing systems

--refork-post-jail
fork() again after jailing. Useful for jailing systems

--re-fork-post-jail
fork() again after jailing. Useful for jailing systems

--hook-asap
run the specified hook as soon as possible

--hook-pre-jail
run the specified hook before jailing

--hook-post-jail
run the specified hook after jailing

--hook-in-jail
run the specified hook in jail after initialization

--hook-as-root
run the specified hook before privileges drop

--hook-as-user
run the specified hook after privileges drop

--hook-as-user-atexit
run the specified hook before app exit and reload

--hook-pre-app
run the specified hook before app loading

--hook-post-app
run the specified hook after app loading

--hook-post-fork
run the specified hook after each fork

--hook-accepting
run the specified hook after each worker enter the accepting phase

--hook-accepting1
run the specified hook after the first worker enters the accepting phase

--hook-accepting-once
run the specified hook after each worker enter the accepting phase (once
per-instance)

--hook-accepting1-once
run the specified hook after the first worker enters the accepting phase (once per
instance)

--hook-master-start
run the specified hook when the Master starts

--hook-touch
run the specified hook when the specified file is touched (syntax: <file> <action>)

--hook-emperor-start
run the specified hook when the Emperor starts

--hook-emperor-stop
run the specified hook when the Emperor send a stop message

--hook-emperor-reload
run the specified hook when the Emperor send a reload message

--hook-emperor-lost
run the specified hook when the Emperor connection is lost

--hook-as-vassal
run the specified hook before exec()ing the vassal

--hook-as-emperor
run the specified hook in the emperor after the vassal has been started

--hook-as-mule
run the specified hook in each mule

--hook-as-gateway
run the specified hook in each gateway

--after-request-hook
run the specified function/symbol after each request

--after-request-call
run the specified function/symbol after each request

--exec-asap
run the specified command as soon as possible

--exec-pre-jail
run the specified command before jailing

--exec-post-jail
run the specified command after jailing

--exec-in-jail
run the specified command in jail after initialization

--exec-as-root
run the specified command before privileges drop

--exec-as-user
run the specified command after privileges drop

--exec-as-user-atexit
run the specified command before app exit and reload

--exec-pre-app
run the specified command before app loading

--exec-post-app
run the specified command after app loading

--exec-as-vassal
run the specified command before exec()ing the vassal

--exec-as-emperor
run the specified command in the emperor after the vassal has been started

--mount-asap
mount filesystem as soon as possible

--mount-pre-jail
mount filesystem before jailing

--mount-post-jail
mount filesystem after jailing

--mount-in-jail
mount filesystem in jail after initialization

--mount-as-root
mount filesystem before privileges drop

--mount-as-vassal
mount filesystem before exec()ing the vassal

--mount-as-emperor
mount filesystem in the emperor after the vassal has been started

--umount-asap
unmount filesystem as soon as possible

--umount-pre-jail
unmount filesystem before jailing

--umount-post-jail
unmount filesystem after jailing

--umount-in-jail
unmount filesystem in jail after initialization

--umount-as-root
unmount filesystem before privileges drop

--umount-as-vassal
unmount filesystem before exec()ing the vassal

--umount-as-emperor
unmount filesystem in the emperor after the vassal has been started

--wait-for-interface
wait for the specified network interface to come up before running root hooks

--wait-for-interface-timeout
set the timeout for wait-for-interface

--wait-interface
wait for the specified network interface to come up before running root hooks

--wait-interface-timeout
set the timeout for wait-for-interface

--wait-for-iface
wait for the specified network interface to come up before running root hooks

--wait-for-iface-timeout
set the timeout for wait-for-interface

--wait-iface
wait for the specified network interface to come up before running root hooks

--wait-iface-timeout
set the timeout for wait-for-interface

--wait-for-fs
wait for the specified filesystem item to appear before running root hooks

--wait-for-file
wait for the specified file to appear before running root hooks

--wait-for-dir
wait for the specified directory to appear before running root hooks

--wait-for-mountpoint
wait for the specified mountpoint to appear before running root hooks

--wait-for-fs-timeout
set the timeout for wait-for-fs/file/dir

--wait-for-socket
wait for the specified socket to be ready before loading apps

--wait-for-socket-timeout
set the timeout for wait-for-socket

--call-asap
call the specified function as soon as possible

--call-pre-jail
call the specified function before jailing

--call-post-jail
call the specified function after jailing

--call-in-jail
call the specified function in jail after initialization

--call-as-root
call the specified function before privileges drop

--call-as-user
call the specified function after privileges drop

--call-as-user-atexit
call the specified function before app exit and reload

--call-pre-app
call the specified function before app loading

--call-post-app
call the specified function after app loading

--call-as-vassal
call the specified function() before exec()ing the vassal

--call-as-vassal1
call the specified function(char *) before exec()ing the vassal

--call-as-vassal3
call the specified function(char *, uid_t, gid_t) before exec()ing the vassal

--call-as-emperor
call the specified function() in the emperor after the vassal has been started

--call-as-emperor1
call the specified function(char *) in the emperor after the vassal has been
started

--call-as-emperor2
call the specified function(char *, pid_t) in the emperor after the vassal has been
started

--call-as-emperor4
call the specified function(char *, pid_t, uid_t, gid_t) in the emperor after the
vassal has been started

--ini load config from ini file

-y|--yaml
load config from yaml file

-y|--yml
load config from yaml file

-j|--json
load config from json file

-j|--js
load config from json file

--weight
weight of the instance (used by clustering/lb/subscriptions)

--auto-weight
set weight of the instance (used by clustering/lb/subscriptions) automatically

--no-server
force no-server mode

--command-mode
force command mode

--no-defer-accept
disable deferred-accept on sockets

--tcp-nodelay
enable TCP NODELAY on each request

--so-keepalive
enable TCP KEEPALIVEs

--so-send-timeout
set SO_SNDTIMEO

--socket-send-timeout
set SO_SNDTIMEO

--so-write-timeout
set SO_SNDTIMEO

--socket-write-timeout
set SO_SNDTIMEO

--socket-sndbuf
set SO_SNDBUF

--socket-rcvbuf
set SO_RCVBUF

--limit-as
limit processes address space/vsz

--limit-nproc
limit the number of spawnable processes

--reload-on-as
reload if address space is higher than specified megabytes

--reload-on-rss
reload if rss memory is higher than specified megabytes

--evil-reload-on-as
force the master to reload a worker if its address space is higher than specified
megabytes

--evil-reload-on-rss
force the master to reload a worker if its rss memory is higher than specified
megabytes

--mem-collector-freq
set the memory collector frequency when evil reloads are in place

--reload-on-fd
reload if the specified file descriptor is ready

--brutal-reload-on-fd
brutal reload if the specified file descriptor is ready

--ksm enable Linux KSM

--pcre-jit
enable pcre jit (if available)

--never-swap
lock all memory pages avoiding swapping

--touch-reload
reload uWSGI if the specified file is modified/touched

--touch-workers-reload
trigger reload of (only) workers if the specified file is modified/touched

--touch-chain-reload
trigger chain reload if the specified file is modified/touched

--touch-logrotate
trigger logrotation if the specified file is modified/touched

--touch-logreopen
trigger log reopen if the specified file is modified/touched

--touch-exec
run command when the specified file is modified/touched (syntax: file command)

--touch-signal
signal when the specified file is modified/touched (syntax: file signal)

--fs-reload
graceful reload when the specified filesystem object is modified

--fs-brutal-reload
brutal reload when the specified filesystem object is modified

--fs-signal
raise a uwsgi signal when the specified filesystem object is modified (syntax: file
signal)

--check-mountpoint
destroy the instance if a filesystem is no more reachable (useful for reliable Fuse
management)

--mountpoint-check
destroy the instance if a filesystem is no more reachable (useful for reliable Fuse
management)

--check-mount
destroy the instance if a filesystem is no more reachable (useful for reliable Fuse
management)

--mount-check
destroy the instance if a filesystem is no more reachable (useful for reliable Fuse
management)

--propagate-touch
over-engineering option for system with flaky signal management

--limit-post
limit request body

--no-orphans
automatically kill workers if master dies (can be dangerous for availability)

--prio set processes/threads priority

--cpu-affinity
set cpu affinity

--post-buffering
set size in bytes after which will buffer to disk instead of memory

--post-buffering-bufsize
set buffer size for read() in post buffering mode

--body-read-warning
set the amount of allowed memory allocation (in megabytes) for request body before
starting printing a warning

--upload-progress
enable creation of .json files in the specified directory during a file upload

--no-default-app
do not fallback to default app

--manage-script-name
automatically rewrite SCRIPT_NAME and PATH_INFO

--ignore-script-name
ignore SCRIPT_NAME

--catch-exceptions
report exception as http output (discouraged, use only for testing)

--reload-on-exception
reload a worker when an exception is raised

--reload-on-exception-type
reload a worker when a specific exception type is raised

--reload-on-exception-value
reload a worker when a specific exception value is raised

--reload-on-exception-repr
reload a worker when a specific exception type+value (language-specific) is raised

--exception-handler
add an exception handler

--enable-metrics
enable metrics subsystem

--metric
add a custom metric

--metric-threshold
add a metric threshold/alarm

--metric-alarm
add a metric threshold/alarm

--alarm-metric
add a metric threshold/alarm

--metrics-dir
export metrics as text files to the specified directory

--metrics-dir-restore
restore last value taken from the metrics dir

--metric-dir
export metrics as text files to the specified directory

--metric-dir-restore
restore last value taken from the metrics dir

--metrics-no-cores
disable generation of cores-related metrics

--udp run the udp server on the specified address

--stats
enable the stats server on the specified address

--stats-server
enable the stats server on the specified address

--stats-http
prefix stats server json output with http headers

--stats-minified
minify statistics json output

--stats-min
minify statistics json output

--stats-push
push the stats json to the specified destination

--stats-pusher-default-freq
set the default frequency of stats pushers

--stats-pushers-default-freq
set the default frequency of stats pushers

--stats-no-cores
disable generation of cores-related stats

--stats-no-metrics
do not include metrics in stats output

--multicast
subscribe to specified multicast group

--multicast-ttl
set multicast ttl

--multicast-loop
set multicast loop (default 1)

--master-fifo
enable the master fifo

--notify-socket
enable the notification socket

--subscription-notify-socket
set the notification socket for subscriptions

--legion
became a member of a legion

--legion-mcast
became a member of a legion (shortcut for multicast)

--legion-node
add a node to a legion

--legion-freq
set the frequency of legion packets

--legion-tolerance
set the tolerance of legion subsystem

--legion-death-on-lord-error
declare itself as a dead node for the specified amount of seconds if one of the
lord hooks fails

--legion-skew-tolerance
set the clock skew tolerance of legion subsystem (default 30 seconds)

--legion-lord
action to call on Lord election

--legion-unlord
action to call on Lord dismiss

--legion-setup
action to call on legion setup

--legion-death
action to call on legion death (shutdown of the instance)

--legion-join
action to call on legion join (first time quorum is reached)

--legion-node-joined
action to call on new node joining legion

--legion-node-left
action to call node leaving legion

--legion-quorum
set the quorum of a legion

--legion-scroll
set the scroll of a legion

--legion-scroll-max-size
set max size of legion scroll buffer

--legion-scroll-list-max-size
set max size of legion scroll list buffer

--subscriptions-sign-check
set digest algorithm and certificate directory for secured subscription system

--subscriptions-sign-check-tolerance
set the maximum tolerance (in seconds) of clock skew for secured subscription
system

--subscriptions-sign-skip-uid
skip signature check for the specified uid when using unix sockets credentials

--subscriptions-credentials-check
add a directory to search for subscriptions key credentials

--subscriptions-use-credentials
enable management of SCM_CREDENTIALS in subscriptions UNIX sockets

--subscription-algo
set load balancing algorithm for the subscription system

--subscription-dotsplit
try to fallback to the next part (dot based) in subscription key

--subscribe-to
subscribe to the specified subscription server

--st subscribe to the specified subscription server

--subscribe
subscribe to the specified subscription server

--subscribe2
subscribe to the specified subscription server using advanced keyval syntax

--subscribe-freq
send subscription announce at the specified interval

--subscription-tolerance
set tolerance for subscription servers

--unsubscribe-on-graceful-reload
force unsubscribe request even during graceful reload

--start-unsubscribed
configure subscriptions but do not send them (useful with master fifo)

--subscribe-with-modifier1
force the specififed modifier1 when subscribing

--snmp enable the embedded snmp server

--snmp-community
set the snmp community string

--ssl-verbose
be verbose about SSL errors

--ssl-sessions-use-cache
use uWSGI cache for ssl sessions storage

--ssl-session-use-cache
use uWSGI cache for ssl sessions storage

--ssl-sessions-timeout
set SSL sessions timeout (default: 300 seconds)

--ssl-session-timeout
set SSL sessions timeout (default: 300 seconds)

--sni add an SNI-governed SSL context

--sni-dir
check for cert/key/client_ca file in the specified directory and create a sni/ssl
context on demand

--sni-dir-ciphers
set ssl ciphers for sni-dir option

--ssl-enable3
enable SSLv3 (insecure)

--ssl-option
set a raw ssl option (numeric value)

--sni-regexp
add an SNI-governed SSL context (the key is a regexp)

--ssl-tmp-dir
store ssl-related temp files in the specified directory

--check-interval
set the interval (in seconds) of master checks

--forkbomb-delay
sleep for the specified number of seconds when a forkbomb is detected

--binary-path
force binary path

--privileged-binary-patch
patch the uwsgi binary with a new command (before privileges drop)

--unprivileged-binary-patch
patch the uwsgi binary with a new command (after privileges drop)

--privileged-binary-patch-arg
patch the uwsgi binary with a new command and arguments (before privileges drop)

--unprivileged-binary-patch-arg
patch the uwsgi binary with a new command and arguments (after privileges drop)

--async
enable async mode with specified cores

--max-fd
set maximum number of file descriptors (requires root privileges)

--logto
set logfile/udp address

--logto2
log to specified file or udp address after privileges drop

--log-format
set advanced format for request logging

--logformat
set advanced format for request logging

--logformat-strftime
apply strftime to logformat output

--log-format-strftime
apply strftime to logformat output

--logfile-chown
chown logfiles

--logfile-chmod
chmod logfiles

--log-syslog
log to syslog

--log-socket
send logs to the specified socket

--req-logger
set/append a request logger

--logger-req
set/append a request logger

--logger
set/append a logger

--logger-list
list enabled loggers

--loggers-list
list enabled loggers

--threaded-logger
offload log writing to a thread

--log-encoder
add an item in the log encoder chain

--log-req-encoder
add an item in the log req encoder chain

--log-drain
drain (do not show) log lines matching the specified regexp

--log-filter
show only log lines matching the specified regexp

--log-route
log to the specified named logger if regexp applied on logline matches

--log-req-route
log requests to the specified named logger if regexp applied on logline matches

--use-abort
call abort() on segfault/fpe, could be useful for generating a core dump

--alarm
create a new alarm, syntax: <alarm> <plugin:args>

--alarm-cheap
use main alarm thread rather than create dedicated threads for curl-based alarms

--alarm-freq
tune the anti-loop alarm system (default 3 seconds)

--alarm-fd
raise the specified alarm when an fd is read for read (by default it reads 1 byte,
set 8 for eventfd)

--alarm-segfault
raise the specified alarm when the segmentation fault handler is executed

--segfault-alarm
raise the specified alarm when the segmentation fault handler is executed

--alarm-backlog
raise the specified alarm when the socket backlog queue is full

--backlog-alarm
raise the specified alarm when the socket backlog queue is full

--lq-alarm
raise the specified alarm when the socket backlog queue is full

--alarm-lq
raise the specified alarm when the socket backlog queue is full

--alarm-listen-queue
raise the specified alarm when the socket backlog queue is full

--listen-queue-alarm
raise the specified alarm when the socket backlog queue is full

--log-alarm
raise the specified alarm when a log line matches the specified regexp, syntax:
<alarm>[,alarm...] <regexp>

--alarm-log
raise the specified alarm when a log line matches the specified regexp, syntax:
<alarm>[,alarm...] <regexp>

--not-log-alarm
skip the specified alarm when a log line matches the specified regexp, syntax:
<alarm>[,alarm...] <regexp>

--not-alarm-log
skip the specified alarm when a log line matches the specified regexp, syntax:
<alarm>[,alarm...] <regexp>

--alarm-list
list enabled alarms

--alarms-list
list enabled alarms

--alarm-msg-size
set the max size of an alarm message (default 8192)

--log-master
delegate logging to master process

--log-master-bufsize
set the buffer size for the master logger. bigger log messages will be truncated

--log-master-stream
create the master logpipe as SOCK_STREAM

--log-master-req-stream
create the master requests logpipe as SOCK_STREAM

--log-reopen
reopen log after reload

--log-truncate
truncate log on startup

--log-maxsize
set maximum logfile size

--log-backupname
set logfile name after rotation

--logdate
prefix logs with date or a strftime string

--log-date
prefix logs with date or a strftime string

--log-prefix
prefix logs with a string

--log-zero
log responses without body

--log-slow
log requests slower than the specified number of milliseconds

--log-4xx
log requests with a 4xx response

--log-5xx
log requests with a 5xx response

--log-big
log requestes bigger than the specified size

--log-sendfile
log sendfile requests

--log-ioerror
log requests with io errors

--log-micros
report response time in microseconds instead of milliseconds

--log-x-forwarded-for
use the ip from X-Forwarded-For header instead of REMOTE_ADDR

--master-as-root
leave master process running as root

--drop-after-init
run privileges drop after plugin initialization

--drop-after-apps
run privileges drop after apps loading

--force-cwd
force the initial working directory to the specified value

--binsh
override /bin/sh (used by exec hooks, it always fallback to /bin/sh)

--chdir
chdir to specified directory before apps loading

--chdir2
chdir to specified directory after apps loading

--lazy set lazy mode (load apps in workers instead of master)

--lazy-apps
load apps in each worker instead of the master

--cheap
set cheap mode (spawn workers only after the first request)

--cheaper
set cheaper mode (adaptive process spawning)

--cheaper-initial
set the initial number of processes to spawn in cheaper mode

--cheaper-algo
choose to algorithm used for adaptive process spawning

--cheaper-step
number of additional processes to spawn at each overload

--cheaper-overload
increase workers after specified overload

--cheaper-algo-list
list enabled cheapers algorithms

--cheaper-algos-list
list enabled cheapers algorithms

--cheaper-list
list enabled cheapers algorithms

--cheaper-rss-limit-soft
don't spawn new workers if total resident memory usage of all workers is higher
than this limit

--cheaper-rss-limit-hard
if total workers resident memory usage is higher try to stop workers

--idle set idle mode (put uWSGI in cheap mode after inactivity)

--die-on-idle
shutdown uWSGI when idle

--mount
load application under mountpoint

--worker-mount
load application under mountpoint in the specified worker or after workers spawn

--threads
run each worker in prethreaded mode with the specified number of threads

--thread-stacksize
set threads stacksize

--threads-stacksize
set threads stacksize

--thread-stack-size
set threads stacksize

--threads-stack-size
set threads stacksize

--vhost
enable virtualhosting mode (based on SERVER_NAME variable)

--vhost-host
enable virtualhosting mode (based on HTTP_HOST variable)

--route
add a route

--route-host
add a route based on Host header

--route-uri
add a route based on REQUEST_URI

--route-qs
add a route based on QUERY_STRING

--route-remote-addr
add a route based on REMOTE_ADDR

--route-user-agent
add a route based on HTTP_USER_AGENT

--route-remote-user
add a route based on REMOTE_USER

--route-referer
add a route based on HTTP_REFERER

--route-label
add a routing label (for use with goto)

--route-if
add a route based on condition

--route-if-not
add a route based on condition (negate version)

--route-run
always run the specified route action

--final-route
add a final route

--final-route-status
add a final route for the specified status

--final-route-host
add a final route based on Host header

--final-route-uri
add a final route based on REQUEST_URI

--final-route-qs
add a final route based on QUERY_STRING

--final-route-remote-addr
add a final route based on REMOTE_ADDR

--final-route-user-agent
add a final route based on HTTP_USER_AGENT

--final-route-remote-user
add a final route based on REMOTE_USER

--final-route-referer
add a final route based on HTTP_REFERER

--final-route-label
add a final routing label (for use with goto)

--final-route-if
add a final route based on condition

--final-route-if-not
add a final route based on condition (negate version)

--final-route-run
always run the specified final route action

--error-route
add an error route

--error-route-status
add an error route for the specified status

--error-route-host
add an error route based on Host header

--error-route-uri
add an error route based on REQUEST_URI

--error-route-qs
add an error route based on QUERY_STRING

--error-route-remote-addr
add an error route based on REMOTE_ADDR

--error-route-user-agent
add an error route based on HTTP_USER_AGENT

--error-route-remote-user
add an error route based on REMOTE_USER

--error-route-referer
add an error route based on HTTP_REFERER

--error-route-label
add an error routing label (for use with goto)

--error-route-if
add an error route based on condition

--error-route-if-not
add an error route based on condition (negate version)

--error-route-run
always run the specified error route action

--response-route
add a response route

--response-route-status
add a response route for the specified status

--response-route-host
add a response route based on Host header

--response-route-uri
add a response route based on REQUEST_URI

--response-route-qs
add a response route based on QUERY_STRING

--response-route-remote-addr
add a response route based on REMOTE_ADDR

--response-route-user-agent
add a response route based on HTTP_USER_AGENT

--response-route-remote-user
add a response route based on REMOTE_USER

--response-route-referer
add a response route based on HTTP_REFERER

--response-route-label
add a response routing label (for use with goto)

--response-route-if
add a response route based on condition

--response-route-if-not
add a response route based on condition (negate version)

--response-route-run
always run the specified response route action

--router-list
list enabled routers

--routers-list
list enabled routers

--error-page-403
add an error page (html) for managed 403 response

--error-page-404
add an error page (html) for managed 404 response

--error-page-500
add an error page (html) for managed 500 response

--websockets-ping-freq
set the frequency (in seconds) of websockets automatic ping packets

--websocket-ping-freq
set the frequency (in seconds) of websockets automatic ping packets

--websockets-pong-tolerance
set the tolerance (in seconds) of websockets ping/pong subsystem

--websocket-pong-tolerance
set the tolerance (in seconds) of websockets ping/pong subsystem

--websockets-max-size
set the max allowed size of websocket messages (in Kbytes, default 1024)

--websocket-max-size
set the max allowed size of websocket messages (in Kbytes, default 1024)

--chunked-input-limit
set the max size of a chunked input part (default 1MB, in bytes)

--chunked-input-timeout
set default timeout for chunked input

--clock
set a clock source

--clock-list
list enabled clocks

--clocks-list
list enabled clocks

--add-header
automatically add HTTP headers to response

--rem-header
automatically remove specified HTTP header from the response

--del-header
automatically remove specified HTTP header from the response

--collect-header
store the specified response header in a request var (syntax: header var)

--response-header-collect
store the specified response header in a request var (syntax: header var)

--pull-header
store the specified response header in a request var and remove it from the
response (syntax: header var)

--check-static
check for static files in the specified directory

--check-static-docroot
check for static files in the requested DOCUMENT_ROOT

--static-check
check for static files in the specified directory

--static-map
map mountpoint to static directory (or file)

--static-map2
like static-map but completely appending the requested resource to the docroot

--static-skip-ext
skip specified extension from staticfile checks

--static-index
search for specified file if a directory is requested

--static-safe
skip security checks if the file is under the specified path

--static-cache-paths
put resolved paths in the uWSGI cache for the specified amount of seconds

--static-cache-paths-name
use the specified cache for static paths

--mimefile
set mime types file path (default /etc/mime.types)

--mime-file
set mime types file path (default /etc/mime.types)

--static-expires-type
set the Expires header based on content type

--static-expires-type-mtime
set the Expires header based on content type and file mtime

--static-expires
set the Expires header based on filename regexp

--static-expires-mtime
set the Expires header based on filename regexp and file mtime

--static-expires-uri
set the Expires header based on REQUEST_URI regexp

--static-expires-uri-mtime
set the Expires header based on REQUEST_URI regexp and file mtime

--static-expires-path-info
set the Expires header based on PATH_INFO regexp

--static-expires-path-info-mtime
set the Expires header based on PATH_INFO regexp and file mtime

--static-gzip
if the supplied regexp matches the static file translation it will search for a
gzip version

--static-gzip-all
check for a gzip version of all requested static files

--static-gzip-dir
check for a gzip version of all requested static files in the specified dir/prefix

--static-gzip-prefix
check for a gzip version of all requested static files in the specified dir/prefix

--static-gzip-ext
check for a gzip version of all requested static files with the specified
ext/suffix

--static-gzip-suffix
check for a gzip version of all requested static files with the specified
ext/suffix

--honour-range
enable support for the HTTP Range header

--offload-threads
set the number of offload threads to spawn (per-worker, default 0)

--offload-thread
set the number of offload threads to spawn (per-worker, default 0)

--file-serve-mode
set static file serving mode

--fileserve-mode
set static file serving mode

--disable-sendfile
disable sendfile() and rely on boring read()/write()

--check-cache
check for response data in the specified cache (empty for default cache)

--close-on-exec
set close-on-exec on connection sockets (could be required for spawning processes
in requests)

--close-on-exec2
set close-on-exec on server sockets (could be required for spawning processes in
requests)

--mode set uWSGI custom mode

--env set environment variable

--envdir
load a daemontools compatible envdir

--early-envdir
load a daemontools compatible envdir ASAP

--unenv
unset environment variable

--vacuum
try to remove all of the generated file/sockets

--file-write
write the specified content to the specified file (syntax: file=value) before
privileges drop

--cgroup
put the processes in the specified cgroup

--cgroup-opt
set value in specified cgroup option

--cgroup-dir-mode
set permission for cgroup directory (default is 700)

--namespace
run in a new namespace under the specified rootfs

--namespace-keep-mount
keep the specified mountpoint in your namespace

--ns run in a new namespace under the specified rootfs

--namespace-net
add network namespace

--ns-net
add network namespace

--enable-proxy-protocol
enable PROXY1 protocol support (only for http parsers)

--reuse-port
enable REUSE_PORT flag on socket (BSD only)

--tcp-fast-open
enable TCP_FASTOPEN flag on TCP sockets with the specified qlen value

--tcp-fastopen
enable TCP_FASTOPEN flag on TCP sockets with the specified qlen value

--tcp-fast-open-client
use sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported

--tcp-fastopen-client
use sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported

--zerg attach to a zerg server

--zerg-fallback
fallback to normal sockets if the zerg server is not available

--zerg-server
enable the zerg server on the specified UNIX socket

--cron add a cron task

--cron2
add a cron task (key=val syntax)

--unique-cron
add a unique cron task

--cron-harakiri
set the maximum time (in seconds) we wait for cron command to complete

--legion-cron
add a cron task runnable only when the instance is a lord of the specified legion

--cron-legion
add a cron task runnable only when the instance is a lord of the specified legion

--unique-legion-cron
add a unique cron task runnable only when the instance is a lord of the specified
legion

--unique-cron-legion
add a unique cron task runnable only when the instance is a lord of the specified
legion

--loop select the uWSGI loop engine

--loop-list
list enabled loop engines

--loops-list
list enabled loop engines

--worker-exec
run the specified command as worker

--worker-exec2
run the specified command as worker (after post_fork hook)

--attach-daemon
attach a command/daemon to the master process (the command has to not go in
background)

--attach-control-daemon
attach a command/daemon to the master process (the command has to not go in
background), when the daemon dies, the master dies too

--smart-attach-daemon
attach a command/daemon to the master process managed by a pidfile (the command has
to daemonize)

--smart-attach-daemon2
attach a command/daemon to the master process managed by a pidfile (the command has
to NOT daemonize)

--legion-attach-daemon
same as --attach-daemon but daemon runs only on legion lord node

--legion-smart-attach-daemon
same as --smart-attach-daemon but daemon runs only on legion lord node

--legion-smart-attach-daemon2
same as --smart-attach-daemon2 but daemon runs only on legion lord node

--daemons-honour-stdin
do not change the stdin of external daemons to /dev/null

--attach-daemon2
attach-daemon keyval variant (supports smart modes too)

--plugins
load uWSGI plugins

--plugin
load uWSGI plugins

--need-plugins
load uWSGI plugins (exit on error)

--need-plugin
load uWSGI plugins (exit on error)

--plugins-dir
add a directory to uWSGI plugin search path

--plugin-dir
add a directory to uWSGI plugin search path

--plugins-list
list enabled plugins

--plugin-list
list enabled plugins

--autoload
try to automatically load plugins when unknown options are found

--dlopen
blindly load a shared library

--allowed-modifiers
comma separated list of allowed modifiers

--remap-modifier
remap request modifier from one id to another

--dump-options
dump the full list of available options

--show-config
show the current config reformatted as ini

--binary-append-data
return the content of a resource to stdout for appending to a uwsgi binary (for
data:// usage)

--print
simple print

--iprint
simple print (immediate version)

--exit force exit() of the instance

--cflags
report uWSGI CFLAGS (useful for building external plugins)

--dot-h
dump the uwsgi.h used for building the core (useful for building external plugins)

--config-py
dump the uwsgiconfig.py used for building the core (useful for building external
plugins)

--build-plugin
build a uWSGI plugin for the current binary

--version
print uWSGI version

--php-ini
set php.ini path

--php-config
set php.ini path

--php-ini-append
set php.ini path (append mode)

--php-config-append
set php.ini path (append mode)

--php-set
set a php config directive

--php-index
list the php index files

--php-docroot
force php DOCUMENT_ROOT

--php-allowed-docroot
list the allowed document roots

--php-allowed-ext
list the allowed php file extensions

--php-allowed-script
list the allowed php scripts (require absolute path)

--php-server-software
force php SERVER_SOFTWARE

--php-app
force the php file to run at each request

--php-app-qs
when in app mode force QUERY_STRING to the specified value + REQUEST_URI

--php-fallback
run the specified php script when the request one does not exist

--php-app-bypass
if the regexp matches the uri the --php-app is bypassed

--php-var
add/overwrite a CGI variable at each request

--php-dump-config
dump php config (if modified via --php-set or append options)

--php-exec-before
run specified php code before the requested script

--php-exec-begin
run specified php code before the requested script

--php-exec-after
run specified php code after the requested script

--php-exec-end
run specified php code after the requested script

--php-sapi-name
hack the sapi name (required for enabling zend opcode cache)

Use uwsgi_php online using onworks.net services