Usage: /opt/chainguard/openstack-designate-2025.2/bin/uwsgi [options...]
-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
--http11-socket bind to the specified UNIX/TCP socket using HTTP 1.1 (Keep-Alive) 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-graceful-timeout interval between graceful harakiri attempt and a sigkill
--harakiri-graceful-signal use this signal instead of sigterm for graceful harakiri attempts
--harakiri-queue-threshold only trigger harakiri if queue is greater than this threshold
--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)
--skip-atexit-teardown skip atexit teardown (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 existence
--if-not-file (opt logic) check for file existence
--if-dir (opt logic) check for directory existence
--if-not-dir (opt logic) check for directory existence
--ifdir (opt logic) check for directory existence
--if-directory (opt logic) check for directory existence
--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 (stub option this is true by default)
--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 possible
--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-graceful-shutdown use vassals graceful shutdown during ragnarok
--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
--max-requests-delta add (worker_id * delta) to the max_requests value of each worker
--min-worker-lifetime number of seconds worker must run before being reloaded (default is 10)
--max-worker-lifetime reload workers after the specified amount of seconds (default is disabled)
--max-worker-lifetime-delta add (worker_id * delta) seconds to the max_worker_lifetime value of each worker
-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)
--safe-pidfile create safe pidfile (before privileges drop)
--safe-pidfile2 create safe 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()
--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
--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
--shutdown-sockets force calling shutdown() in addition to close() when sockets are destroyed
--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-mules-reload reload mules if the specified file is modified/touched
--touch-spoolers-reload reload spoolers 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 60 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-verify-depth set maximum certificate verification depth
--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-enable-sslv3 enable SSLv3 (insecure)
--ssl-enable-tlsv1 enable TLSv1 (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 requests 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, superseded by drop-after-apps
--drop-after-apps run privileges drop after apps loading, superseded by master-as-root
--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
--response-headers-limit set response header maximum size (default: 64k)
--wsgi-file load .wsgi file
--file load .wsgi file
--eval eval python code
-w|--module load a WSGI module
-w|--wsgi load a WSGI module
--callable set default WSGI callable name
-J|--test test a module import
-H|--home set PYTHONHOME/virtualenv
-H|--virtualenv set PYTHONHOME/virtualenv
-H|--venv set PYTHONHOME/virtualenv
-H|--pyhome set PYTHONHOME/virtualenv
--py-programname set python program name
--py-program-name set python program name
--pythonpath add directory (or glob) to pythonpath
--python-path add directory (or glob) to pythonpath
--pp add directory (or glob) to pythonpath
--pymodule-alias add a python alias module
--post-pymodule-alias add a python module alias after uwsgi module initialization
--import import a python module
--pyimport import a python module
--py-import import a python module
--python-import import a python module
--shared-import import a python module in all of the processes
--shared-pyimport import a python module in all of the processes
--shared-py-import import a python module in all of the processes
--shared-python-import import a python module in all of the processes
--spooler-import import a python module in the spooler
--spooler-pyimport import a python module in the spooler
--spooler-py-import import a python module in the spooler
--spooler-python-import import a python module in the spooler
--pyargv manually set sys.argv
-O|--optimize set python optimization level
--pecan load a pecan config file
--paste load a paste.deploy config file
--paste-logger enable paste fileConfig logger
--web3 load a web3 app
--pump load a pump app
--wsgi-lite load a wsgi-lite app
--ini-paste load a paste.deploy config file containing uwsgi section
--ini-paste-logged load a paste.deploy config file containing uwsgi section (load loggers too)
--reload-os-env force reload of os.environ at each request
--no-site do not import site module
--pyshell run an interactive python shell in the uWSGI environment
--pyshell-oneshot run an interactive python shell in the uWSGI environment (one-shot variant)
--python run a python script in the uWSGI environment
--py run a python script in the uWSGI environment
--pyrun run a python script in the uWSGI environment
--py-tracebacker enable the uWSGI python tracebacker
--py-auto-reload monitor python modules mtime to trigger reload (use only in development)
--py-autoreload monitor python modules mtime to trigger reload (use only in development)
--python-auto-reload monitor python modules mtime to trigger reload (use only in development)
--python-autoreload monitor python modules mtime to trigger reload (use only in development)
--py-auto-reload-ignore ignore the specified module during auto-reload scan (can be specified multiple times)
--wsgi-env-behaviour set the strategy for allocating/deallocating the WSGI env
--wsgi-env-behavior set the strategy for allocating/deallocating the WSGI env
--start_response-nodelay send WSGI http headers as soon as possible (PEP violation)
--wsgi-strict try to be fully PEP compliant disabling optimizations
--wsgi-accept-buffer accept CPython buffer-compliant objects as WSGI response in addition to string/bytes
--wsgi-accept-buffers accept CPython buffer-compliant objects as WSGI response in addition to string/bytes
--wsgi-disable-file-wrapper disable wsgi.file_wrapper feature
--python-version report python version
--python-raw load a python file for managing raw requests
--py-sharedarea create a sharedarea from a python bytearray object of the specified size
--py-call-osafterfork enable child processes running cpython to trap OS signals
--py-call-uwsgi-fork-hooks call pre and post hooks when uswgi forks to update the internal interpreter state of CPython
--python-worker-override override worker with the specified python script
--py-executable override sys.executable value
--py-sys-executable override sys.executable value
--symcall load the specified C symbol as the symcall request handler (supports <mountpoint=func> too)
--symcall-use-next use RTLD_NEXT when searching for symbols
--symcall-register-rpc load the specified C symbol as an RPC function (syntax: name function)
--symcall-post-fork call the specified C symbol after each fork()
--ping ping specified uwsgi host
--ping-timeout set ping timeout
--gevent a shortcut enabling gevent loop engine with the specified number of async cores and optimal parameters
--gevent-monkey-patch call gevent.monkey.patch_all() automatically on startup
--gevent-early-monkey-patch call gevent.monkey.patch_all() automatically before app loading
--gevent-wait-for-hub wait for gevent hub's death instead of the control greenlet
--nagios nagios check
--rrdtool store rrd files in the specified directory
--rrdtool-freq set collect frequency
--rrdtool-lib set the name of rrd library (default: librrd.so)
--carbon push statistics to the specified carbon server
--carbon-timeout set carbon connection timeout in seconds (default 3)
--carbon-freq set carbon push frequency in seconds (default 60)
--carbon-id set carbon id
--carbon-no-workers disable generation of single worker metrics
--carbon-max-retry set maximum number of retries in case of connection errors (default 1)
--carbon-retry-delay set connection retry delay in seconds (default 7)
--carbon-root set carbon metrics root node (default 'uwsgi')
--carbon-hostname-dots set char to use as a replacement for dots in hostname (dots are not replaced by default)
--carbon-name-resolve allow using hostname as carbon server address (default disabled)
--carbon-resolve-names allow using hostname as carbon server address (default disabled)
--carbon-idle-avg average values source during idle period (no requests), can be "last", "zero", "none" (default is last)
--carbon-use-metrics don't compute all statistics, use metrics subsystem data instead (warning! key names will be different)
--fastrouter run the fastrouter on the specified port
--fastrouter-processes prefork the specified number of fastrouter processes
--fastrouter-workers prefork the specified number of fastrouter processes
--fastrouter-zerg attach the fastrouter to a zerg server
--fastrouter-use-cache use uWSGI cache as hostname->server mapper for the fastrouter
--fastrouter-use-pattern use a pattern for fastrouter hostname->server mapping
--fastrouter-use-base use a base dir for fastrouter hostname->server mapping
--fastrouter-fallback fallback to the specified node in case of error
--fastrouter-use-code-string use code string as hostname->server mapper for the fastrouter
--fastrouter-use-socket forward request to the specified uwsgi socket
--fastrouter-to forward requests to the specified uwsgi server (you can specify it multiple times for load balancing)
--fastrouter-gracetime retry connections to dead static nodes after the specified amount of seconds
--fastrouter-events set the maximum number of concurrent events
--fastrouter-quiet do not report failed connections to instances
--fastrouter-cheap run the fastrouter in cheap mode
--fastrouter-subscription-server run the fastrouter subscription server on the specified address
--fastrouter-subscription-slot *** deprecated ***
--fastrouter-timeout set fastrouter timeout
--fastrouter-post-buffering enable fastrouter post buffering
--fastrouter-post-buffering-dir put fastrouter buffered files to the specified directory (noop, use TMPDIR env)
--fastrouter-stats run the fastrouter stats server
--fastrouter-stats-server run the fastrouter stats server
--fastrouter-ss run the fastrouter stats server
--fastrouter-harakiri enable fastrouter harakiri
--fastrouter-uid drop fastrouter privileges to the specified uid
--fastrouter-gid drop fastrouter privileges to the specified gid
--fastrouter-resubscribe forward subscriptions to the specified subscription server
--fastrouter-resubscribe-bind bind to the specified address when re-subscribing
--fastrouter-buffer-size set internal buffer size (default: page size)
--fastrouter-fallback-on-no-key move to fallback node even if a subscription key is not found
--fastrouter-subscription-fallback-key key to use for fallback fastrouter
--http add an http router/server on the specified address
--httprouter add an http router/server on the specified address
--https add an https router/server on the specified address with specified certificate and key
--https2 add an https/spdy router/server using keyval options
--https-export-cert export uwsgi variable HTTPS_CC containing the raw client certificate
--https-session-context set the session id context to the specified value
--http-to-https add an http router/server on the specified address and redirect all of the requests to https
--http-processes set the number of http processes to spawn
--http-workers set the number of http processes to spawn
--http-var add a key=value item to the generated uwsgi packet
--http-to forward requests to the specified node (you can specify it multiple time for lb)
--http-zerg attach the http router to a zerg server
--http-fallback fallback to the specified node in case of error
--http-modifier1 set uwsgi protocol modifier1
--http-modifier2 set uwsgi protocol modifier2
--http-use-cache use uWSGI cache as key->value virtualhost mapper
--http-use-pattern use the specified pattern for mapping requests to unix sockets
--http-use-base use the specified base for mapping requests to unix sockets
--http-events set the number of concurrent http async events
--http-subscription-server enable the subscription server
--http-subscription-fallback-key key to use for fallback http handler
--http-timeout set internal http socket timeout (default: 60 seconds)
--http-manage-expect manage the Expect HTTP request header (optionally checking for Content-Length)
--http-keepalive HTTP 1.1 keepalive support (non-pipelined) requests
--http-auto-chunked automatically transform output to chunked encoding during HTTP 1.1 keepalive (if needed)
--http-auto-gzip automatically gzip content if uWSGI-Encoding header is set to gzip, but content size (Content-Length/Transfer-Encoding) and Content-Encoding are not specified
--http-raw-body blindly send HTTP body to backends (required for WebSockets and Icecast support in backends)
--http-websockets automatically detect websockets connections and put the session in raw mode
--http-chunked-input automatically detect chunked input requests and put the session in raw mode
--http-use-code-string use code string as hostname->server mapper for the http router
--http-use-socket forward request to the specified uwsgi socket
--http-gracetime retry connections to dead static nodes after the specified amount of seconds
--http-quiet do not report failed connections to instances
--http-cheap run the http router in cheap mode
--http-stats run the http router stats server
--http-stats-server run the http router stats server
--http-ss run the http router stats server
--http-harakiri enable http router harakiri
--http-stud-prefix expect a stud prefix (1byte family + 4/16 bytes address) on connections from the specified address
--http-uid drop http router privileges to the specified uid
--http-gid drop http router privileges to the specified gid
--http-resubscribe forward subscriptions to the specified subscription server
--http-buffer-size set internal buffer size (default: page size)
--http-server-name-as-http-host force SERVER_NAME to HTTP_HOST
--http-headers-timeout set internal http socket timeout for headers
--http-connect-timeout set internal http socket timeout for backend connections
--http-manage-source manage the SOURCE HTTP method placing the session in raw mode
--http-manage-rtsp manage RTSP sessions
--http-enable-proxy-protocol manage PROXY protocol requests
--ugreen enable ugreen coroutine subsystem
--ugreen-stacksize set ugreen stack size in pages
--rsyslog-packet-size set maximum packet size for syslog messages (default 1024) WARNING! using packets > 1024 breaks RFC 3164 (#4.1)
--rsyslog-split-messages split big messages into multiple chunks if they are bigger than allowed packet size (default is false)
--zergpool start a zergpool on specified address for specified address
--zerg-pool start a zergpool on specified address for specified address
--rawrouter run the rawrouter on the specified port
--rawrouter-processes prefork the specified number of rawrouter processes
--rawrouter-workers prefork the specified number of rawrouter processes
--rawrouter-zerg attach the rawrouter to a zerg server
--rawrouter-use-cache use uWSGI cache as hostname->server mapper for the rawrouter
--rawrouter-use-pattern use a pattern for rawrouter hostname->server mapping
--rawrouter-use-base use a base dir for rawrouter hostname->server mapping
--rawrouter-fallback fallback to the specified node in case of error
--rawrouter-use-code-string use code string as hostname->server mapper for the rawrouter
--rawrouter-use-socket forward request to the specified uwsgi socket
--rawrouter-to forward requests to the specified uwsgi server (you can specify it multiple times for load balancing)
--rawrouter-gracetime retry connections to dead static nodes after the specified amount of seconds
--rawrouter-events set the maximum number of concurrent events
--rawrouter-max-retries set the maximum number of retries/fallbacks to other nodes
--rawrouter-quiet do not report failed connections to instances
--rawrouter-cheap run the rawrouter in cheap mode
--rawrouter-subscription-server run the rawrouter subscription server on the spcified address
--rawrouter-subscription-slot *** deprecated ***
--rawrouter-timeout set rawrouter timeout
--rawrouter-stats run the rawrouter stats server
--rawrouter-stats-server run the rawrouter stats server
--rawrouter-ss run the rawrouter stats server
--rawrouter-harakiri enable rawrouter harakiri
--rawrouter-xclient use the xclient protocol to pass the client address
--rawrouter-buffer-size set internal buffer size (default: page size)
--sslrouter run the sslrouter on the specified port
--sslrouter2 run the sslrouter on the specified port (key-value based)
--sslrouter-session-context set the session id context to the specified value
--sslrouter-processes prefork the specified number of sslrouter processes
--sslrouter-workers prefork the specified number of sslrouter processes
--sslrouter-zerg attach the sslrouter to a zerg server
--sslrouter-use-cache use uWSGI cache as hostname->server mapper for the sslrouter
--sslrouter-use-pattern use a pattern for sslrouter hostname->server mapping
--sslrouter-use-base use a base dir for sslrouter hostname->server mapping
--sslrouter-fallback fallback to the specified node in case of error
--sslrouter-use-code-string use code string as hostname->server mapper for the sslrouter
--sslrouter-use-socket forward request to the specified uwsgi socket
--sslrouter-to forward requests to the specified uwsgi server (you can specify it multiple times for load balancing)
--sslrouter-gracetime retry connections to dead static nodes after the specified amount of seconds
--sslrouter-events set the maximum number of concurrent events
--sslrouter-max-retries set the maximum number of retries/fallbacks to other nodes
--sslrouter-quiet do not report failed connections to instances
--sslrouter-cheap run the sslrouter in cheap mode
--sslrouter-subscription-server run the sslrouter subscription server on the spcified address
--sslrouter-timeout set sslrouter timeout
--sslrouter-stats run the sslrouter stats server
--sslrouter-stats-server run the sslrouter stats server
--sslrouter-ss run the sslrouter stats server
--sslrouter-harakiri enable sslrouter harakiri
--sslrouter-sni use SNI to route requests
--sslrouter-buffer-size set internal buffer size (default: page size)
--cheaper-busyness-max set the cheaper busyness high percent limit, above that value worker is considered loaded (default 50)
--cheaper-busyness-min set the cheaper busyness low percent limit, below that value worker is considered idle (default 25)
--cheaper-busyness-multiplier set initial cheaper multiplier, worker needs to be idle for cheaper-overload*multiplier seconds to be cheaped (default 10)
--cheaper-busyness-penalty penalty for respawning workers to fast, it will be added to the current multiplier value if worker is cheaped and than respawned back too fast (default 2)
--cheaper-busyness-verbose enable verbose log messages from busyness algorithm
--cheaper-busyness-backlog-alert spawn emergency worker(s) if any time listen queue is higher than this value (default 33)
--cheaper-busyness-backlog-multiplier set cheaper multiplier used for emergency workers (default 3)
--cheaper-busyness-backlog-step number of emergency workers to spawn at a time (default 1)
--cheaper-busyness-backlog-nonzero spawn emergency worker(s) if backlog is > 0 for more then N seconds (default 60)
Options (600)
| Option | Description | Source |
|---|---|---|
--suwsgi-socket | bind to the specified UNIX/TCP socket using uwsgi protocol over SSL | help |
--ssl-socket | bind to the specified UNIX/TCP socket using uwsgi protocol over SSL | help |
--http-socket | bind to the specified UNIX/TCP socket using HTTP protocol | help |
--http-socket-modifier1 | force the specified modifier1 when using HTTP protocol | help |
--http-socket-modifier2 | force the specified modifier2 when using HTTP protocol | help |
--http11-socket | bind to the specified UNIX/TCP socket using HTTP 1.1 (Keep-Alive) protocol | help |
--https-socket | bind to the specified UNIX/TCP socket using HTTPS protocol | help |
--https-socket-modifier1 | force the specified modifier1 when using HTTPS protocol | help |
--https-socket-modifier2 | force the specified modifier2 when using HTTPS protocol | help |
--fastcgi-socket | bind to the specified UNIX/TCP socket using FastCGI protocol | help |
--fastcgi-nph-socket | bind to the specified UNIX/TCP socket using FastCGI protocol (nph mode) | help |
--fastcgi-modifier1 | force the specified modifier1 when using FastCGI protocol | help |
--fastcgi-modifier2 | force the specified modifier2 when using FastCGI protocol | help |
--scgi-socket | bind to the specified UNIX/TCP socket using SCGI protocol | help |
--scgi-nph-socket | bind to the specified UNIX/TCP socket using SCGI protocol (nph mode) | help |
--scgi-modifier1 | force the specified modifier1 when using SCGI protocol | help |
--scgi-modifier2 | force the specified modifier2 when using SCGI protocol | help |
--raw-socket | bind to the specified UNIX/TCP socket using RAW protocol | help |
--raw-modifier1 | force the specified modifier1 when using RAW protocol | help |
--raw-modifier2 | force the specified modifier2 when using RAW protocol | help |
--puwsgi-socket | bind to the specified UNIX/TCP socket using persistent uwsgi protocol (puwsgi) | help |
--protocol | force the specified protocol for default sockets | help |
--socket-protocol | force the specified protocol for default sockets | help |
--shared-socket | create a shared socket for advanced jailing or ipc | help |
--undeferred-shared-socket | create a shared socket for advanced jailing or ipc (undeferred mode) | help |
--thunder-lock | serialize accept() usage (if possible) | help |
--harakiri-verbose | enable verbose mode for harakiri | help |
--harakiri-graceful-timeout | interval between graceful harakiri attempt and a sigkill | help |
--harakiri-graceful-signal | use this signal instead of sigterm for graceful harakiri attempts | help |
--harakiri-queue-threshold | only trigger harakiri if queue is greater than this threshold | help |
--harakiri-no-arh | do not enable harakiri during after-request-hook | help |
--no-harakiri-arh | do not enable harakiri during after-request-hook | help |
--no-harakiri-after-req-hook | do not enable harakiri during after-request-hook | help |
--backtrace-depth | set backtrace depth | help |
--mule-harakiri | set harakiri timeout for mule tasks | help |
--config | load configuration using the pluggable system | help |
--fallback-config | re-exec uwsgi with the specified config when exit code is 1 | help |
--strict | enable strict mode (placeholder cannot be used) | help |
--skip-zero | skip check of file descriptor 0 | help |
--skip-atexit | skip atexit hooks (ignored by the master) | help |
--skip-atexit-teardown | skip atexit teardown (ignored by the master) | help |
--set-placeholder | set a placeholder | help |
--set-ph | set a placeholder | help |
--get | print the specified option value and exit | help |
--declare-option | declare a new uWSGI custom option | help |
--declare-option2 | declare a new uWSGI custom option (non-immediate) | help |
--resolve | place the result of a dns query in the specified placeholder, sytax: placeholder=name (immediate option) | help |
--for | (opt logic) for cycle | help |
--for-glob | (opt logic) for cycle (expand glob) | help |
--for-times | (opt logic) for cycle (expand the specified num to a list starting from 1) | help |
--for-readline | (opt logic) for cycle (expand the specified file to a list of lines) | help |
--endfor | (opt logic) end for cycle | help |
--end-for | (opt logic) end for cycle | help |
--if-opt | (opt logic) check for option | help |
--if-not-opt | (opt logic) check for option | help |
--if-env | (opt logic) check for environment variable | help |
--if-not-env | (opt logic) check for environment variable | help |
--ifenv | (opt logic) check for environment variable | help |
--if-reload | (opt logic) check for reload | help |
--if-not-reload | (opt logic) check for reload | help |
--if-hostname | (opt logic) check for hostname | help |
--if-not-hostname | (opt logic) check for hostname | help |
--if-hostname-match | (opt logic) try to match hostname against a regular expression | help |
--if-not-hostname-match | (opt logic) try to match hostname against a regular expression | help |
--if-exists | (opt logic) check for file/directory existence | help |
--if-not-exists | (opt logic) check for file/directory existence | help |
--ifexists | (opt logic) check for file/directory existence | help |
--if-plugin | (opt logic) check for plugin | help |
--if-not-plugin | (opt logic) check for plugin | help |
--ifplugin | (opt logic) check for plugin | help |
--if-file | (opt logic) check for file existence | help |
--if-not-file | (opt logic) check for file existence | help |
--if-dir | (opt logic) check for directory existence | help |
--if-not-dir | (opt logic) check for directory existence | help |
--ifdir | (opt logic) check for directory existence | help |
--if-directory | (opt logic) check for directory existence | help |
--endif | (opt logic) end if | help |
--end-if | (opt logic) end if | help |
--blacklist | set options blacklist context | help |
--end-blacklist | clear options blacklist context | help |
--whitelist | set options whitelist context | help |
--end-whitelist | clear options whitelist context | help |
--ignore-sigpipe | do not report (annoying) SIGPIPE | help |
--ignore-write-errors | do not report (annoying) write()/writev() errors | help |
--write-errors-tolerance | set the maximum number of allowed write errors (default: no tolerance) | help |
--write-errors-exception-only | only raise an exception on write errors giving control to the app itself | help |
--disable-write-exception | disable exception generation on write()/writev() | help |
--inherit | use the specified file as config template | help |
--include | include the specified file as immediate configuration | help |
--inject-before | inject a text file before the config file (advanced templating) | help |
--inject-after | inject a text file after the config file (advanced templating) | help |
--daemonize2 | daemonize uWSGI after app loading | help |
--stop | stop an instance | help |
--reload | reload an instance | help |
--pause | pause an instance | help |
--suspend | suspend an instance | help |
--resume | resume an instance | help |
--connect-and-read | connect to a socket and wait for data from it | help |
--extract | fetch/dump any supported address to stdout | help |
--max-apps | set the maximum number of per-worker applications | help |
--profiler | enable the specified profiler | help |
--chown-socket | chown unix sockets | help |
--umask | set umask | help |
--freebind | put socket in freebind mode | help |
--map-socket | map sockets to specific workers | help |
--no-threads-wait | do not wait for threads cancellation on quit/reload | help |
--auto-procname | automatically set processes name to something meaningful | help |
--procname-prefix | add a prefix to the process names | help |
--procname-prefix-spaced | add a spaced prefix to the process names | help |
--procname-append | append a string to process names | help |
--procname | set process names | help |
--procname-master | set master process name | help |
--need-app | exit if no app can be loaded | help |
--honour-stdin | do not remap stdin to /dev/null | help |
--emperor | run the Emperor | help |
--emperor-proxy-socket | force the vassal to became an Emperor proxy | help |
--emperor-wrapper | set a binary wrapper for vassals | help |
--emperor-wrapper-override | set a binary wrapper for vassals to try before the default one | help |
--emperor-wrapper-fallback | set a binary wrapper for vassals to try as a last resort | help |
--emperor-nofollow | do not follow symlinks when checking for mtime | help |
--emperor-procname | set the Emperor process name | help |
--emperor-freq | set the Emperor scan frequency (default 3 seconds) | help |
--emperor-required-heartbeat | set the Emperor tolerance about heartbeats | help |
--emperor-curse-tolerance | set the Emperor tolerance about cursed vassals | help |
--emperor-pidfile | write the Emperor pid in the specified file | help |
--emperor-tyrant | put the Emperor in Tyrant mode | help |
--emperor-tyrant-nofollow | do not follow symlinks when checking for uid/gid in Tyrant mode | help |
--emperor-stats | run the Emperor stats server | help |
--emperor-stats-server | run the Emperor stats server | help |
--early-emperor | spawn the emperor as soon as possible | help |
--emperor-broodlord | run the emperor in BroodLord mode | help |
--emperor-throttle | set throttling level (in milliseconds) for bad behaving vassals (default 1000) | help |
--emperor-max-throttle | set max throttling level (in milliseconds) for bad behaving vassals (default 3 minutes) | help |
--emperor-magic-exec | prefix vassals config files with exec:// if they have the executable bit | help |
--emperor-on-demand-extension | search for text file (vassal name + extension) containing the on demand socket name | help |
--emperor-on-demand-ext | search for text file (vassal name + extension) containing the on demand socket name | help |
--emperor-on-demand-directory | enable on demand mode binding to the unix socket in the specified directory named like the vassal + .socket | help |
--emperor-on-demand-dir | enable on demand mode binding to the unix socket in the specified directory named like the vassal + .socket | help |
--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) | help |
--emperor-extra-extension | allows the specified extension in the Emperor (vassal will be called with --config) | help |
--emperor-extra-ext | allows the specified extension in the Emperor (vassal will be called with --config) | help |
--emperor-no-blacklist | disable Emperor blacklisting subsystem | help |
--emperor-use-clone | use clone() instead of fork() passing the specified unshare() flags | help |
--emperor-graceful-shutdown | use vassals graceful shutdown during ragnarok | help |
--imperial-monitor-list | list enabled imperial monitors | help |
--imperial-monitors-list | list enabled imperial monitors | help |
--vassals-inherit | add config templates to vassals config (uses --inherit) | help |
--vassals-include | include config templates to vassals config (uses --include instead of --inherit) | help |
--vassals-inherit-before | add config templates to vassals config (uses --inherit, parses before the vassal file) | help |
--vassals-include-before | include config templates to vassals config (uses --include instead of --inherit, parses before the vassal file) | help |
--vassals-start-hook | run the specified command before each vassal starts | help |
--vassals-stop-hook | run the specified command after vassal's death | help |
--vassal-sos | ask emperor for reinforcement when overloaded | help |
--vassal-sos-backlog | ask emperor for sos if backlog queue has more items than the value specified | help |
--vassals-set | automatically set the specified option (via --set) for every vassal | help |
--vassal-set | automatically set the specified option (via --set) for every vassal | help |
--heartbeat | announce healthiness to the emperor | help |
--reload-mercy | set the maximum time (in seconds) we wait for workers and other processes to die during reload/shutdown | help |
--worker-reload-mercy | set the maximum time (in seconds) a worker can take to reload/shutdown (default is 60) | help |
--mule-reload-mercy | set the maximum time (in seconds) a mule can take to reload/shutdown (default is 60) | help |
--exit-on-reload | force exit even if a reload is requested | help |
--die-on-term | exit instead of brutal reload on SIGTERM | help |
--force-gateway | force the spawn of the first registered gateway without a master | help |
--print-sym | print content of the specified binary symbol | help |
--print-symbol | print content of the specified binary symbol | help |
--max-requests-delta | add (worker_id * delta) to the max_requests value of each worker | help |
--min-worker-lifetime | number of seconds worker must run before being reloaded (default is 10) | help |
--max-worker-lifetime | reload workers after the specified amount of seconds (default is disabled) | help |
--max-worker-lifetime-delta | add (worker_id * delta) seconds to the max_worker_lifetime value of each worker | help |
--no-fd-passing | disable file descriptor passing | help |
--locks | create the specified number of shared locks | help |
--lock-engine | set the lock engine | help |
--ftok | set the ipcsem key via ftok() for avoiding duplicates | help |
--persistent-ipcsem | do not remove ipcsem's on shutdown | help |
--safe-fd | do not close the specified file descriptor | help |
--fd-safe | do not close the specified file descriptor | help |
--cache | create a shared cache containing given elements | help |
--cache-blocksize | set cache blocksize | help |
--cache-store | enable persistent cache to disk | help |
--cache-store-sync | set frequency of sync for persistent cache | help |
--cache-no-expire | disable auto sweep of expired items | help |
--cache-expire-freq | set the frequency of cache sweeper scans (default 3 seconds) | help |
--cache-report-freed-items | constantly report the cache item freed by the sweeper (use only for debug) | help |
--cache-udp-server | bind the cache udp server (used only for set/update/delete) to the specified socket | help |
--cache-udp-node | send cache update/deletion to the specified cache udp server | help |
--cache-sync | copy the whole content of another uWSGI cache server on server startup | help |
--cache-use-last-modified | update last_modified_at timestamp on every cache item modification (default is disabled) | help |
--add-cache-item | add an item in the cache | help |
--load-file-in-cache | load a static file in the cache | help |
--load-file-in-cache-gzip | load a static file in the cache with gzip compression | help |
--cache2 | create a new generation shared cache (keyval syntax) | help |
--queue | enable shared queue | help |
--queue-blocksize | set queue blocksize | help |
--queue-store | enable persistent queue to disk | help |
--queue-store-sync | set frequency of sync for persistent queue | help |
--spooler-external | map spoolers requests to a spooler directory managed by an external instance | help |
--spooler-ordered | try to order the execution of spooler tasks | help |
--spooler-chdir | chdir() to specified directory before each spooler task | help |
--spooler-processes | set the number of processes for spoolers | help |
--spooler-quiet | do not be verbose with spooler tasks | help |
--spooler-max-tasks | set the maximum number of tasks to run before recycling a spooler | help |
--spooler-harakiri | set harakiri timeout for spooler tasks | help |
--spooler-frequency | set spooler frequency | help |
--spooler-freq | set spooler frequency | help |
--mule | add a mule | help |
--mules | add the specified number of mules | help |
--farm | add a mule farm | help |
--mule-msg-size | set mule message buffer size | help |
--signal | send a uwsgi signal to a server | help |
--signal-bufsize | set buffer size for signal queue | help |
--signals-bufsize | set buffer size for signal queue | help |
--signal-timer | add a timer (syntax: <signal> <seconds>) | help |
--timer | add a timer (syntax: <signal> <seconds>) | help |
--signal-rbtimer | add a redblack timer (syntax: <signal> <seconds>) | help |
--rbtimer | add a redblack timer (syntax: <signal> <seconds>) | help |
--rpc-max | maximum number of rpc slots (default: 64) | help |
--flock | lock the specified file before starting, exit if locked | help |
--flock-wait | lock the specified file before starting, wait if locked | help |
--flock2 | lock the specified file after logging/daemon setup, exit if locked | help |
--flock-wait2 | lock the specified file after logging/daemon setup, wait if locked | help |
--pidfile | create pidfile (before privileges drop) | help |
--pidfile2 | create pidfile (after privileges drop) | help |
--safe-pidfile | create safe pidfile (before privileges drop) | help |
--safe-pidfile2 | create safe pidfile (after privileges drop) | help |
--chroot | chroot() to the specified directory | help |
--pivot-root | pivot_root() to the specified directories (new_root and put_old must be separated with a space) | help |
--pivot_root | pivot_root() to the specified directories (new_root and put_old must be separated with a space) | help |
--uid | setuid to the specified user/uid | help |
--gid | setgid to the specified group/gid | help |
--add-gid | add the specified group id to the process credentials | help |
--immediate-uid | setuid to the specified user/uid IMMEDIATELY | help |
--immediate-gid | setgid to the specified group/gid IMMEDIATELY | help |
--no-initgroups | disable additional groups set via initgroups() | help |
--unshare | unshare() part of the processes and put it in a new namespace | help |
--unshare2 | unshare() part of the processes and put it in a new namespace after rootfs change | help |
--setns-socket | expose a unix socket returning namespace fds from /proc/self/ns | help |
--setns-socket-skip | skip the specified entry when sending setns file descriptors | help |
--setns-skip | skip the specified entry when sending setns file descriptors | help |
--setns | join a namespace created by an external uWSGI instance | help |
--setns-preopen | open /proc/self/ns as soon as possible and cache fds | help |
--jailed | mark the instance as jailed (force the execution of post_jail hooks) | help |
--refork | fork() again after privileges drop. | help |
--re-fork | fork() again after privileges drop. | help |
--refork-as-root | fork() again before privileges drop. | help |
--re-fork-as-root | fork() again before privileges drop. | help |
--refork-post-jail | fork() again after jailing. | help |
--re-fork-post-jail | fork() again after jailing. | help |
--hook-asap | run the specified hook as soon as possible | help |
--hook-pre-jail | run the specified hook before jailing | help |
--hook-post-jail | run the specified hook after jailing | help |
--hook-in-jail | run the specified hook in jail after initialization | help |
--hook-as-root | run the specified hook before privileges drop | help |
--hook-as-user | run the specified hook after privileges drop | help |
--hook-as-user-atexit | run the specified hook before app exit and reload | help |
--hook-pre-app | run the specified hook before app loading | help |
--hook-post-app | run the specified hook after app loading | help |
--hook-post-fork | run the specified hook after each fork | help |
--hook-accepting | run the specified hook after each worker enter the accepting phase | help |
--hook-accepting1 | run the specified hook after the first worker enters the accepting phase | help |
--hook-accepting-once | run the specified hook after each worker enter the accepting phase (once per-instance) | help |
--hook-accepting1-once | run the specified hook after the first worker enters the accepting phase (once per instance) | help |
--hook-master-start | run the specified hook when the Master starts | help |
--hook-touch | run the specified hook when the specified file is touched (syntax: <file> <action>) | help |
--hook-emperor-start | run the specified hook when the Emperor starts | help |
--hook-emperor-stop | run the specified hook when the Emperor send a stop message | help |
--hook-emperor-reload | run the specified hook when the Emperor send a reload message | help |
--hook-emperor-lost | run the specified hook when the Emperor connection is lost | help |
--hook-as-vassal | run the specified hook before exec()ing the vassal | help |
--hook-as-emperor | run the specified hook in the emperor after the vassal has been started | help |
--hook-as-mule | run the specified hook in each mule | help |
--hook-as-gateway | run the specified hook in each gateway | help |
--after-request-hook | run the specified function/symbol after each request | help |
--after-request-call | run the specified function/symbol after each request | help |
--exec-asap | run the specified command as soon as possible | help |
--exec-pre-jail | run the specified command before jailing | help |
--exec-post-jail | run the specified command after jailing | help |
--exec-in-jail | run the specified command in jail after initialization | help |
--exec-as-root | run the specified command before privileges drop | help |
--exec-as-user | run the specified command after privileges drop | help |
--exec-as-user-atexit | run the specified command before app exit and reload | help |
--exec-pre-app | run the specified command before app loading | help |
--exec-post-app | run the specified command after app loading | help |
--exec-as-vassal | run the specified command before exec()ing the vassal | help |
--exec-as-emperor | run the specified command in the emperor after the vassal has been started | help |
--mount-asap | mount filesystem as soon as possible | help |
--mount-pre-jail | mount filesystem before jailing | help |
--mount-post-jail | mount filesystem after jailing | help |
--mount-in-jail | mount filesystem in jail after initialization | help |
--mount-as-root | mount filesystem before privileges drop | help |
--mount-as-vassal | mount filesystem before exec()ing the vassal | help |
--mount-as-emperor | mount filesystem in the emperor after the vassal has been started | help |
--umount-asap | unmount filesystem as soon as possible | help |
--umount-pre-jail | unmount filesystem before jailing | help |
--umount-post-jail | unmount filesystem after jailing | help |
--umount-in-jail | unmount filesystem in jail after initialization | help |
--umount-as-root | unmount filesystem before privileges drop | help |
--umount-as-vassal | unmount filesystem before exec()ing the vassal | help |
--umount-as-emperor | unmount filesystem in the emperor after the vassal has been started | help |
--wait-for-interface | wait for the specified network interface to come up before running root hooks | help |
--wait-for-interface-timeout | set the timeout for wait-for-interface | help |
--wait-interface | wait for the specified network interface to come up before running root hooks | help |
--wait-interface-timeout | set the timeout for wait-for-interface | help |
--wait-for-iface | wait for the specified network interface to come up before running root hooks | help |
--wait-for-iface-timeout | set the timeout for wait-for-interface | help |
--wait-iface | wait for the specified network interface to come up before running root hooks | help |
--wait-iface-timeout | set the timeout for wait-for-interface | help |
--wait-for-fs | wait for the specified filesystem item to appear before running root hooks | help |
--wait-for-file | wait for the specified file to appear before running root hooks | help |
--wait-for-dir | wait for the specified directory to appear before running root hooks | help |
--wait-for-mountpoint | wait for the specified mountpoint to appear before running root hooks | help |
--wait-for-fs-timeout | set the timeout for wait-for-fs/file/dir | help |
--wait-for-socket | wait for the specified socket to be ready before loading apps | help |
--wait-for-socket-timeout | set the timeout for wait-for-socket | help |
--call-asap | call the specified function as soon as possible | help |
--call-pre-jail | call the specified function before jailing | help |
--call-post-jail | call the specified function after jailing | help |
--call-in-jail | call the specified function in jail after initialization | help |
--call-as-root | call the specified function before privileges drop | help |
--call-as-user | call the specified function after privileges drop | help |
--call-as-user-atexit | call the specified function before app exit and reload | help |
--call-pre-app | call the specified function before app loading | help |
--call-post-app | call the specified function after app loading | help |
--call-as-vassal | call the specified function() before exec()ing the vassal | help |
--call-as-vassal1 | call the specified function(char *) before exec()ing the vassal | help |
--call-as-vassal3 | call the specified function(char *, uid_t, gid_t) before exec()ing the vassal | help |
--call-as-emperor | call the specified function() in the emperor after the vassal has been started | help |
--call-as-emperor1 | call the specified function(char *) in the emperor after the vassal has been started | help |
--call-as-emperor2 | call the specified function(char *, pid_t) in the emperor after the vassal has been started | help |
--call-as-emperor4 | call the specified function(char *, pid_t, uid_t, gid_t) in the emperor after the vassal has been started | help |
--ini | load config from ini file | help |
--weight | weight of the instance (used by clustering/lb/subscriptions) | help |
--auto-weight | set weight of the instance (used by clustering/lb/subscriptions) automatically | help |
--no-server | force no-server mode | help |
--command-mode | force command mode | help |
--no-defer-accept | disable deferred-accept on sockets | help |
--tcp-nodelay | enable TCP NODELAY on each request | help |
--so-keepalive | enable TCP KEEPALIVEs | help |
--so-send-timeout | set SO_SNDTIMEO | help |
--socket-send-timeout | set SO_SNDTIMEO | help |
--so-write-timeout | set SO_SNDTIMEO | help |
--socket-write-timeout | set SO_SNDTIMEO | help |
--socket-sndbuf | set SO_SNDBUF | help |
--socket-rcvbuf | set SO_RCVBUF | help |
--shutdown-sockets | force calling shutdown() in addition to close() when sockets are destroyed | help |
--limit-as | limit processes address space/vsz | help |
--limit-nproc | limit the number of spawnable processes | help |
--reload-on-as | reload if address space is higher than specified megabytes | help |
--reload-on-rss | reload if rss memory is higher than specified megabytes | help |
--evil-reload-on-as | force the master to reload a worker if its address space is higher than specified megabytes | help |
--evil-reload-on-rss | force the master to reload a worker if its rss memory is higher than specified megabytes | help |
--mem-collector-freq | set the memory collector frequency when evil reloads are in place | help |
--reload-on-fd | reload if the specified file descriptor is ready | help |
--brutal-reload-on-fd | brutal reload if the specified file descriptor is ready | help |
--ksm | enable Linux KSM | help |
--pcre-jit | enable pcre jit (if available) | help |
--never-swap | lock all memory pages avoiding swapping | help |
--touch-reload | reload uWSGI if the specified file is modified/touched | help |
--touch-workers-reload | trigger reload of (only) workers if the specified file is modified/touched | help |
--touch-mules-reload | reload mules if the specified file is modified/touched | help |
--touch-spoolers-reload | reload spoolers if the specified file is modified/touched | help |
--touch-chain-reload | trigger chain reload if the specified file is modified/touched | help |
--touch-logrotate | trigger logrotation if the specified file is modified/touched | help |
--touch-logreopen | trigger log reopen if the specified file is modified/touched | help |
--touch-exec | run command when the specified file is modified/touched (syntax: file command) | help |
--touch-signal | signal when the specified file is modified/touched (syntax: file signal) | help |
--fs-reload | graceful reload when the specified filesystem object is modified | help |
--fs-brutal-reload | brutal reload when the specified filesystem object is modified | help |
--fs-signal | raise a uwsgi signal when the specified filesystem object is modified (syntax: file signal) | help |
--check-mountpoint | destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management) | help |
--mountpoint-check | destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management) | help |
--check-mount | destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management) | help |
--mount-check | destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management) | help |
--propagate-touch | over-engineering option for system with flaky signal management | help |
--limit-post | limit request body | help |
--no-orphans | automatically kill workers if master dies (can be dangerous for availability) | help |
--prio | set processes/threads priority | help |
--cpu-affinity | set cpu affinity | help |
--post-buffering | set size in bytes after which will buffer to disk instead of memory | help |
--post-buffering-bufsize | set buffer size for read() in post buffering mode | help |
--body-read-warning | set the amount of allowed memory allocation (in megabytes) for request body before starting printing a warning | help |
--upload-progress | enable creation of .json files in the specified directory during a file upload | help |
--no-default-app | do not fallback to default app | help |
--manage-script-name | automatically rewrite SCRIPT_NAME and PATH_INFO | help |
--ignore-script-name | ignore SCRIPT_NAME | help |
--catch-exceptions | report exception as http output (discouraged, use only for testing) | help |
--reload-on-exception | reload a worker when an exception is raised | help |
--reload-on-exception-type | reload a worker when a specific exception type is raised | help |
--reload-on-exception-value | reload a worker when a specific exception value is raised | help |
--reload-on-exception-repr | reload a worker when a specific exception type+value (language-specific) is raised | help |
--exception-handler | add an exception handler | help |
--enable-metrics | enable metrics subsystem | help |
--metric | add a custom metric | help |
--metric-threshold | add a metric threshold/alarm | help |
--metric-alarm | add a metric threshold/alarm | help |
--alarm-metric | add a metric threshold/alarm | help |
--metrics-dir | export metrics as text files to the specified directory | help |
--metrics-dir-restore | restore last value taken from the metrics dir | help |
--metric-dir | export metrics as text files to the specified directory | help |
--metric-dir-restore | restore last value taken from the metrics dir | help |
--metrics-no-cores | disable generation of cores-related metrics | help |
--udp | run the udp server on the specified address | help |
--stats | enable the stats server on the specified address | help |
--stats-server | enable the stats server on the specified address | help |
--stats-http | prefix stats server json output with http headers | help |
--stats-minified | minify statistics json output | help |
--stats-min | minify statistics json output | help |
--stats-push | push the stats json to the specified destination | help |
--stats-pusher-default-freq | set the default frequency of stats pushers | help |
--stats-pushers-default-freq | set the default frequency of stats pushers | help |
--stats-no-cores | disable generation of cores-related stats | help |
--stats-no-metrics | do not include metrics in stats output | help |
--multicast | subscribe to specified multicast group | help |
--multicast-ttl | set multicast ttl | help |
--multicast-loop | set multicast loop (default 1) | help |
--master-fifo | enable the master fifo | help |
--notify-socket | enable the notification socket | help |
--subscription-notify-socket | set the notification socket for subscriptions | help |
--legion | became a member of a legion | help |
--legion-mcast | became a member of a legion (shortcut for multicast) | help |
--legion-node | add a node to a legion | help |
--legion-freq | set the frequency of legion packets | help |
--legion-tolerance | set the tolerance of legion subsystem | help |
--legion-death-on-lord-error | declare itself as a dead node for the specified amount of seconds if one of the lord hooks fails | help |
--legion-skew-tolerance | set the clock skew tolerance of legion subsystem (default 60 seconds) | help |
--legion-lord | action to call on Lord election | help |
--legion-unlord | action to call on Lord dismiss | help |
--legion-setup | action to call on legion setup | help |
--legion-death | action to call on legion death (shutdown of the instance) | help |
--legion-join | action to call on legion join (first time quorum is reached) | help |
--legion-node-joined | action to call on new node joining legion | help |
--legion-node-left | action to call node leaving legion | help |
--legion-quorum | set the quorum of a legion | help |
--legion-scroll | set the scroll of a legion | help |
--legion-scroll-max-size | set max size of legion scroll buffer | help |
--legion-scroll-list-max-size | set max size of legion scroll list buffer | help |
--subscriptions-sign-check | set digest algorithm and certificate directory for secured subscription system | help |
--subscriptions-sign-check-tolerance | set the maximum tolerance (in seconds) of clock skew for secured subscription system | help |
--subscriptions-sign-skip-uid | skip signature check for the specified uid when using unix sockets credentials | help |
--subscriptions-credentials-check | add a directory to search for subscriptions key credentials | help |
--subscriptions-use-credentials | enable management of SCM_CREDENTIALS in subscriptions UNIX sockets | help |
--subscription-algo | set load balancing algorithm for the subscription system | help |
--subscription-dotsplit | try to fallback to the next part (dot based) in subscription key | help |
--subscribe-to | subscribe to the specified subscription server | help |
--st | subscribe to the specified subscription server | help |
--subscribe | subscribe to the specified subscription server | help |
--subscribe2 | subscribe to the specified subscription server using advanced keyval syntax | help |
--subscribe-freq | send subscription announce at the specified interval | help |
--subscription-tolerance | set tolerance for subscription servers | help |
--unsubscribe-on-graceful-reload | force unsubscribe request even during graceful reload | help |
--start-unsubscribed | configure subscriptions but do not send them (useful with master fifo) | help |
--subscribe-with-modifier1 | force the specififed modifier1 when subscribing | help |
--snmp | enable the embedded snmp server | help |
--snmp-community | set the snmp community string | help |
--ssl-verbose | be verbose about SSL errors | help |
--ssl-verify-depth | set maximum certificate verification depth | help |
--sni | add an SNI-governed SSL context | help |
--sni-dir | check for cert/key/client_ca file in the specified directory and create a sni/ssl context on demand | help |
--sni-dir-ciphers | set ssl ciphers for sni-dir option | help |
--ssl-enable3 | enable SSLv3 (insecure) | help |
--ssl-enable-sslv3 | enable SSLv3 (insecure) | help |
--ssl-enable-tlsv1 | enable TLSv1 (insecure) | help |
--ssl-option | set a raw ssl option (numeric value) | help |
--sni-regexp | add an SNI-governed SSL context (the key is a regexp) | help |
--ssl-tmp-dir | store ssl-related temp files in the specified directory | help |
--check-interval | set the interval (in seconds) of master checks | help |
--forkbomb-delay | sleep for the specified number of seconds when a forkbomb is detected | help |
--binary-path | force binary path | help |
--privileged-binary-patch | patch the uwsgi binary with a new command (before privileges drop) | help |
--unprivileged-binary-patch | patch the uwsgi binary with a new command (after privileges drop) | help |
--privileged-binary-patch-arg | patch the uwsgi binary with a new command and arguments (before privileges drop) | help |
--unprivileged-binary-patch-arg | patch the uwsgi binary with a new command and arguments (after privileges drop) | help |
--async | enable async mode with specified cores | help |
--max-fd | set maximum number of file descriptors (requires root privileges) | help |
--logto | set logfile/udp address | help |
--logto2 | log to specified file or udp address after privileges drop | help |
--log-format | set advanced format for request logging | help |
--logformat | set advanced format for request logging | help |
--logformat-strftime | apply strftime to logformat output | help |
--log-format-strftime | apply strftime to logformat output | help |
--logfile-chown | chown logfiles | help |
--logfile-chmod | chmod logfiles | help |
--log-syslog | log to syslog | help |
--log-socket | send logs to the specified socket | help |
--req-logger | set/append a request logger | help |
--logger-req | set/append a request logger | help |
--logger | set/append a logger | help |
--logger-list | list enabled loggers | help |
--loggers-list | list enabled loggers | help |
--threaded-logger | offload log writing to a thread | help |
--log-encoder | add an item in the log encoder chain | help |
--log-req-encoder | add an item in the log req encoder chain | help |
--log-drain | drain (do not show) log lines matching the specified regexp | help |
--log-filter | show only log lines matching the specified regexp | help |
--log-route | log to the specified named logger if regexp applied on logline matches | help |
--log-req-route | log requests to the specified named logger if regexp applied on logline matches | help |
--use-abort | call abort() on segfault/fpe, could be useful for generating a core dump | help |
--alarm | create a new alarm, syntax: <alarm> <plugin:args> | help |
--alarm-cheap | use main alarm thread rather than create dedicated threads for curl-based alarms | help |
--alarm-freq | tune the anti-loop alarm system (default 3 seconds) | help |
--alarm-fd | raise the specified alarm when an fd is read for read (by default it reads 1 byte, set 8 for eventfd) | help |
--alarm-segfault | raise the specified alarm when the segmentation fault handler is executed | help |
--segfault-alarm | raise the specified alarm when the segmentation fault handler is executed | help |
--alarm-backlog | raise the specified alarm when the socket backlog queue is full | help |
--backlog-alarm | raise the specified alarm when the socket backlog queue is full | help |
--lq-alarm | raise the specified alarm when the socket backlog queue is full | help |
--alarm-lq | raise the specified alarm when the socket backlog queue is full | help |
--alarm-listen-queue | raise the specified alarm when the socket backlog queue is full | help |
--listen-queue-alarm | raise the specified alarm when the socket backlog queue is full | help |
--log-alarm | raise the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp> | help |
--alarm-log | raise the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp> | help |
--not-log-alarm | skip the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp> | help |
--not-alarm-log | skip the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp> | help |
--alarm-list | list enabled alarms | help |
--alarms-list | list enabled alarms | help |
--alarm-msg-size | set the max size of an alarm message (default 8192) | help |
--log-master | delegate logging to master process | help |
--log-master-bufsize | set the buffer size for the master logger. | help |
--log-master-stream | create the master logpipe as SOCK_STREAM | help |
--log-master-req-stream | create the master requests logpipe as SOCK_STREAM | help |
--log-reopen | reopen log after reload | help |
--log-truncate | truncate log on startup | help |
--log-maxsize | set maximum logfile size | help |
--log-backupname | set logfile name after rotation | help |
--logdate | prefix logs with date or a strftime string | help |
--log-date | prefix logs with date or a strftime string | help |
--log-prefix | prefix logs with a string | help |
--log-zero | log responses without body | help |
--log-slow | log requests slower than the specified number of milliseconds | help |
--log-4xx | log requests with a 4xx response | help |
--log-5xx | log requests with a 5xx response | help |
--log-big | log requests bigger than the specified size | help |
--log-sendfile | log sendfile requests | help |
--log-ioerror | log requests with io errors | help |
--log-micros | report response time in microseconds instead of milliseconds | help |
--log-x-forwarded-for | use the ip from X-Forwarded-For header instead of REMOTE_ADDR | help |
--master-as-root | leave master process running as root | help |
--drop-after-init | run privileges drop after plugin initialization, superseded by drop-after-apps | help |
--drop-after-apps | run privileges drop after apps loading, superseded by master-as-root | help |
--force-cwd | force the initial working directory to the specified value | help |
--binsh | override /bin/sh (used by exec hooks, it always fallback to /bin/sh) | help |
--chdir | chdir to specified directory before apps loading | help |
--chdir2 | chdir to specified directory after apps loading | help |
--lazy | set lazy mode (load apps in workers instead of master) | help |
--lazy-apps | load apps in each worker instead of the master | help |
--cheap | set cheap mode (spawn workers only after the first request) | help |
--cheaper | set cheaper mode (adaptive process spawning) | help |
--cheaper-initial | set the initial number of processes to spawn in cheaper mode | help |
--cheaper-algo | choose to algorithm used for adaptive process spawning | help |
--cheaper-step | number of additional processes to spawn at each overload | help |
--cheaper-overload | increase workers after specified overload | help |
--cheaper-algo-list | list enabled cheapers algorithms | help |
--cheaper-algos-list | list enabled cheapers algorithms | help |
--cheaper-list | list enabled cheapers algorithms | help |
--cheaper-rss-limit-soft | don't spawn new workers if total resident memory usage of all workers is higher than this limit | help |
--cheaper-rss-limit-hard | if total workers resident memory usage is higher try to stop workers | help |
--idle | set idle mode (put uWSGI in cheap mode after inactivity) | help |
--die-on-idle | shutdown uWSGI when idle | help |
--mount | load application under mountpoint | help |
--worker-mount | load application under mountpoint in the specified worker or after workers spawn | help |
--threads | run each worker in prethreaded mode with the specified number of threads | help |
--thread-stacksize | set threads stacksize | help |
--threads-stacksize | set threads stacksize | help |
--thread-stack-size | set threads stacksize | help |
--threads-stack-size | set threads stacksize | help |
--vhost | enable virtualhosting mode (based on SERVER_NAME variable) | help |
--vhost-host | enable virtualhosting mode (based on HTTP_HOST variable) | help |
--route | add a route | help |
--route-host | add a route based on Host header | help |
--route-uri | add a route based on REQUEST_URI | help |
--route-qs | add a route based on QUERY_STRING | help |
--route-remote-addr | add a route based on REMOTE_ADDR | help |
--route-user-agent | add a route based on HTTP_USER_AGENT | help |
--route-remote-user | add a route based on REMOTE_USER | help |
--route-referer | add a route based on HTTP_REFERER | help |
--route-label | add a routing label (for use with goto) | help |
--route-if | add a route based on condition | help |
--route-if-not | add a route based on condition (negate version) | help |
--route-run | always run the specified route action | help |
--final-route | add a final route | help |
--final-route-status | add a final route for the specified status | help |
--final-route-host | add a final route based on Host header | help |
--final-route-uri | add a final route based on REQUEST_URI | help |
--final-route-qs | add a final route based on QUERY_STRING | help |
--final-route-remote-addr | add a final route based on REMOTE_ADDR | help |
--final-route-user-agent | add a final route based on HTTP_USER_AGENT | help |
--final-route-remote-user | add a final route based on REMOTE_USER | help |
--final-route-referer | add a final route based on HTTP_REFERER | help |
--final-route-label | add a final routing label (for use with goto) | help |
--final-route-if | add a final route based on condition | help |
--final-route-if-not | add a final route based on condition (negate version) | help |
--final-route-run | always run the specified final route action | help |
--error-route | add an error route | help |
--error-route-status | add an error route for the specified status | help |
--error-route-host | add an error route based on Host header | help |
--error-route-uri | add an error route based on REQUEST_URI | help |
--error-route-qs | add an error route based on QUERY_STRING | help |
--error-route-remote-addr | add an error route based on REMOTE_ADDR | help |
--error-route-user-agent | add an error route based on HTTP_USER_AGENT | help |
--error-route-remote-user | add an error route based on REMOTE_USER | help |
--error-route-referer | add an error route based on HTTP_REFERER | help |