uwsgi_python35(1)
fast (pure C), self-healing, developer-friendly WSGI server
SYNOPSIS
uwsgi-core-local
[,options/...]
DESCRIPTION
- -s|--socket
-
bind to the specified UNIX/TCP socket using default protocol
- -s|--uwsgi-socket
-
bind to the specified UNIX/TCP socket using uwsgi protocol
- --suwsgi-socket
-
bind to the specified UNIX/TCP socket using uwsgi protocol over SSL
- --ssl-socket
-
bind to the specified UNIX/TCP socket using uwsgi protocol over SSL
- --http-socket
-
bind to the specified UNIX/TCP socket using HTTP protocol
- --http-socket-modifier1
-
force the specified modifier1 when using HTTP protocol
- --http-socket-modifier2
-
force the specified modifier2 when using HTTP protocol
- --https-socket
-
bind to the specified UNIX/TCP socket using HTTPS protocol
- --https-socket-modifier1
-
force the specified modifier1 when using HTTPS protocol
- --https-socket-modifier2
-
force the specified modifier2 when using HTTPS protocol
- --fastcgi-socket
-
bind to the specified UNIX/TCP socket using FastCGI protocol
- --fastcgi-nph-socket
-
bind to the specified UNIX/TCP socket using FastCGI protocol (nph mode)
- --fastcgi-modifier1
-
force the specified modifier1 when using FastCGI protocol
- --fastcgi-modifier2
-
force the specified modifier2 when using FastCGI protocol
- --scgi-socket
-
bind to the specified UNIX/TCP socket using SCGI protocol
- --scgi-nph-socket
-
bind to the specified UNIX/TCP socket using SCGI protocol (nph mode)
- --scgi-modifier1
-
force the specified modifier1 when using SCGI protocol
- --scgi-modifier2
-
force the specified modifier2 when using SCGI protocol
- --raw-socket
-
bind to the specified UNIX/TCP socket using RAW protocol
- --raw-modifier1
-
force the specified modifier1 when using RAW protocol
- --raw-modifier2
-
force the specified modifier2 when using RAW protocol
- --puwsgi-socket
-
bind to the specified UNIX/TCP socket using persistent uwsgi protocol (puwsgi)
- --protocol
-
force the specified protocol for default sockets
- --socket-protocol
-
force the specified protocol for default sockets
- --shared-socket
-
create a shared socket for advanced jailing or ipc
- --undeferred-shared-socket
-
create a shared socket for advanced jailing or ipc (undeferred mode)
- -p|--processes
-
spawn the specified number of workers/processes
- -p|--workers
-
spawn the specified number of workers/processes
- --thunder-lock
-
serialize accept() usage (if possible)
- -t|--harakiri
-
set harakiri timeout
- --harakiri-verbose
-
enable verbose mode for harakiri
- --harakiri-no-arh
-
do not enable harakiri during after-request-hook
- --no-harakiri-arh
-
do not enable harakiri during after-request-hook
- --no-harakiri-after-req-hook
-
do not enable harakiri during after-request-hook
- --backtrace-depth
-
set backtrace depth
- --mule-harakiri
-
set harakiri timeout for mule tasks
- -x|--xmlconfig
-
load config from xml file
- -x|--xml
-
load config from xml file
- --config
-
load configuration using the pluggable system
- --fallback-config
-
re-exec uwsgi with the specified config when exit code is 1
- --strict
-
enable strict mode (placeholder cannot be used)
- --skip-zero
-
skip check of file descriptor 0
- --skip-atexit
-
skip atexit hooks (ignored by the master)
- -S|--set
-
set a placeholder or an option
- --set-placeholder
-
set a placeholder
- --set-ph
-
set a placeholder
- --get
-
print the specified option value and exit
- --declare-option
-
declare a new uWSGI custom option
- --declare-option2
-
declare a new uWSGI custom option (non-immediate)
- --resolve
-
place the result of a dns query in the specified placeholder, sytax: placeholder=name (immediate option)
- --for
-
(opt logic) for cycle
- --for-glob
-
(opt logic) for cycle (expand glob)
- --for-times
-
(opt logic) for cycle (expand the specified num to a list starting from 1)
- --for-readline
-
(opt logic) for cycle (expand the specified file to a list of lines)
- --endfor
-
(opt logic) end for cycle
- --end-for
-
(opt logic) end for cycle
- --if-opt
-
(opt logic) check for option
- --if-not-opt
-
(opt logic) check for option
- --if-env
-
(opt logic) check for environment variable
- --if-not-env
-
(opt logic) check for environment variable
- --ifenv
-
(opt logic) check for environment variable
- --if-reload
-
(opt logic) check for reload
- --if-not-reload
-
(opt logic) check for reload
- --if-hostname
-
(opt logic) check for hostname
- --if-not-hostname
-
(opt logic) check for hostname
- --if-hostname-match
-
(opt logic) try to match hostname against a regular expression
- --if-not-hostname-match
-
(opt logic) try to match hostname against a regular expression
- --if-exists
-
(opt logic) check for file/directory existence
- --if-not-exists
-
(opt logic) check for file/directory existence
- --ifexists
-
(opt logic) check for file/directory existence
- --if-plugin
-
(opt logic) check for plugin
- --if-not-plugin
-
(opt logic) check for plugin
- --ifplugin
-
(opt logic) check for plugin
- --if-file
-
(opt logic) check for file existance
- --if-not-file
-
(opt logic) check for file existance
- --if-dir
-
(opt logic) check for directory existance
- --if-not-dir
-
(opt logic) check for directory existance
- --ifdir
-
(opt logic) check for directory existance
- --if-directory
-
(opt logic) check for directory existance
- --endif
-
(opt logic) end if
- --end-if
-
(opt logic) end if
- --blacklist
-
set options blacklist context
- --end-blacklist
-
clear options blacklist context
- --whitelist
-
set options whitelist context
- --end-whitelist
-
clear options whitelist context
- --ignore-sigpipe
-
do not report (annoying) SIGPIPE
- --ignore-write-errors
-
do not report (annoying) write()/writev() errors
- --write-errors-tolerance
-
set the maximum number of allowed write errors (default: no tolerance)
- --write-errors-exception-only
-
only raise an exception on write errors giving control to the app itself
- --disable-write-exception
-
disable exception generation on write()/writev()
- --inherit
-
use the specified file as config template
- --include
-
include the specified file as immediate configuration
- --inject-before
-
inject a text file before the config file (advanced templating)
- --inject-after
-
inject a text file after the config file (advanced templating)
- -d|--daemonize
-
daemonize uWSGI
- --daemonize2
-
daemonize uWSGI after app loading
- --stop
-
stop an instance
- --reload
-
reload an instance
- --pause
-
pause an instance
- --suspend
-
suspend an instance
- --resume
-
resume an instance
- --connect-and-read
-
connect to a socket and wait for data from it
- --extract
-
fetch/dump any supported address to stdout
- -l|--listen
-
set the socket listen queue size
- -v|--max-vars
-
set the amount of internal iovec/vars structures
- --max-apps
-
set the maximum number of per-worker applications
- -b|--buffer-size
-
set internal buffer size
- -m|--memory-report
-
enable memory report
- --profiler
-
enable the specified profiler
- -c|--cgi-mode
-
force CGI-mode for plugins supporting it
- -a|--abstract-socket
-
force UNIX socket in abstract mode (Linux only)
- -C|--chmod-socket
-
chmod-socket
- -C|--chmod
-
chmod-socket
- --chown-socket
-
chown unix sockets
- --umask
-
set umask
- --freebind
-
put socket in freebind mode
- --map-socket
-
map sockets to specific workers
- -T|--enable-threads
-
enable threads
- --no-threads-wait
-
do not wait for threads cancellation on quit/reload
- --auto-procname
-
automatically set processes name to something meaningful
- --procname-prefix
-
add a prefix to the process names
- --procname-prefix-spaced
-
add a spaced prefix to the process names
- --procname-append
-
append a string to process names
- --procname
-
set process names
- --procname-master
-
set master process name
- -i|--single-interpreter
-
do not use multiple interpreters (where available)
- --need-app
-
exit if no app can be loaded
- -M|--master
-
enable master process
- --honour-stdin
-
do not remap stdin to ,/dev/null/
- --emperor
-
run the Emperor
- --emperor-proxy-socket
-
force the vassal to became an Emperor proxy
- --emperor-wrapper
-
set a binary wrapper for vassals
- --emperor-wrapper-override
-
set a binary wrapper for vassals to try before the default one
- --emperor-wrapper-fallback
-
set a binary wrapper for vassals to try as a last resort
- --emperor-nofollow
-
do not follow symlinks when checking for mtime
- --emperor-procname
-
set the Emperor process name
- --emperor-freq
-
set the Emperor scan frequency (default 3 seconds)
- --emperor-required-heartbeat
-
set the Emperor tolerance about heartbeats
- --emperor-curse-tolerance
-
set the Emperor tolerance about cursed vassals
- --emperor-pidfile
-
write the Emperor pid in the specified file
- --emperor-tyrant
-
put the Emperor in Tyrant mode
- --emperor-tyrant-nofollow
-
do not follow symlinks when checking for uid/gid in Tyrant mode
- --emperor-stats
-
run the Emperor stats server
- --emperor-stats-server
-
run the Emperor stats server
- --early-emperor
-
spawn the emperor as soon as possibile
- --emperor-broodlord
-
run the emperor in BroodLord mode
- --emperor-throttle
-
set throttling level (in milliseconds) for bad behaving vassals (default 1000)
- --emperor-max-throttle
-
set max throttling level (in milliseconds) for bad behaving vassals (default 3 minutes)
- --emperor-magic-exec
-
prefix vassals config files with exec:// if they have the executable bit
- --emperor-on-demand-extension
-
search for text file (vassal name + extension) containing the on demand socket name
- --emperor-on-demand-ext
-
search for text file (vassal name + extension) containing the on demand socket name
- --emperor-on-demand-directory
-
enable on demand mode binding to the unix socket in the specified directory named like the vassal + .socket
- --emperor-on-demand-dir
-
enable on demand mode binding to the unix socket in the specified directory named like the vassal + .socket
- --emperor-on-demand-exec
-
use the output of the specified command as on demand socket name (the vassal name is passed as the only argument)
- --emperor-extra-extension
-
allows the specified extension in the Emperor (vassal will be called with --config)
- --emperor-extra-ext
-
allows the specified extension in the Emperor (vassal will be called with --config)
- --emperor-no-blacklist
-
disable Emperor blacklisting subsystem
- --emperor-use-clone
-
use clone() instead of fork() passing the specified unshare() flags
- --emperor-cap
-
set vassals capability
- --vassals-cap
-
set vassals capability
- --vassal-cap
-
set vassals capability
- --imperial-monitor-list
-
list enabled imperial monitors
- --imperial-monitors-list
-
list enabled imperial monitors
- --vassals-inherit
-
add config templates to vassals config (uses --inherit)
- --vassals-include
-
include config templates to vassals config (uses --include instead of --inherit)
- --vassals-inherit-before
-
add config templates to vassals config (uses --inherit, parses before the vassal file)
- --vassals-include-before
-
include config templates to vassals config (uses --include instead of --inherit, parses before the vassal file)
- --vassals-start-hook
-
run the specified command before each vassal starts
- --vassals-stop-hook
-
run the specified command after vassal's death
- --vassal-sos
-
ask emperor for reinforcement when overloaded
- --vassal-sos-backlog
-
ask emperor for sos if backlog queue has more items than the value specified
- --vassals-set
-
automatically set the specified option (via --set) for every vassal
- --vassal-set
-
automatically set the specified option (via --set) for every vassal
- --heartbeat
-
announce healthiness to the emperor
- --reload-mercy
-
set the maximum time (in seconds) we wait for workers and other processes to die during reload/shutdown
- --worker-reload-mercy
-
set the maximum time (in seconds) a worker can take to reload/shutdown (default is 60)
- --mule-reload-mercy
-
set the maximum time (in seconds) a mule can take to reload/shutdown (default is 60)
- --exit-on-reload
-
force exit even if a reload is requested
- --die-on-term
-
exit instead of brutal reload on SIGTERM
- --force-gateway
-
force the spawn of the first registered gateway without a master
- -h|--help
-
show this help
- -h|--usage
-
show this help
- --print-sym
-
print content of the specified binary symbol
- --print-symbol
-
print content of the specified binary symbol
- -r|--reaper
-
call waitpid(-1,...) after each request to get rid of zombies
- -R|--max-requests
-
reload workers after the specified amount of managed requests
- --min-worker-lifetime
-
number of seconds worker must run before being reloaded (default is 60)
- --max-worker-lifetime
-
reload workers after the specified amount of seconds (default is disabled)
- -z|--socket-timeout
-
set internal sockets timeout
- --no-fd-passing
-
disable file descriptor passing
- --locks
-
create the specified number of shared locks
- --lock-engine
-
set the lock engine
- --ftok
-
set the ipcsem key via ftok() for avoiding duplicates
- --persistent-ipcsem
-
do not remove ipcsem's on shutdown
- -A|--sharedarea
-
create a raw shared memory area of specified pages (note: it supports keyval too)
- --safe-fd
-
do not close the specified file descriptor
- --fd-safe
-
do not close the specified file descriptor
- --cache
-
create a shared cache containing given elements
- --cache-blocksize
-
set cache blocksize
- --cache-store
-
enable persistent cache to disk
- --cache-store-sync
-
set frequency of sync for persistent cache
- --cache-no-expire
-
disable auto sweep of expired items
- --cache-expire-freq
-
set the frequency of cache sweeper scans (default 3 seconds)
- --cache-report-freed-items
-
constantly report the cache item freed by the sweeper (use only for debug)
- --cache-udp-server
-
bind the cache udp server (used only for set/update/delete) to the specified socket
- --cache-udp-node
-
send cache update/deletion to the specified cache udp server
- --cache-sync
-
copy the whole content of another uWSGI cache server on server startup
- --cache-use-last-modified
-
update last_modified_at timestamp on every cache item modification (default is disabled)
- --add-cache-item
-
add an item in the cache
- --load-file-in-cache
-
load a static file in the cache
- --load-file-in-cache-gzip
-
load a static file in the cache with gzip compression
- --cache2
-
create a new generation shared cache (keyval syntax)
- --queue
-
enable shared queue
- --queue-blocksize
-
set queue blocksize
- --queue-store
-
enable persistent queue to disk
- --queue-store-sync
-
set frequency of sync for persistent queue
- -Q|--spooler
-
run a spooler on the specified directory
- --spooler-external
-
map spoolers requests to a spooler directory managed by an external instance
- --spooler-ordered
-
try to order the execution of spooler tasks
- --spooler-chdir
-
chdir() to specified directory before each spooler task
- --spooler-processes
-
set the number of processes for spoolers
- --spooler-quiet
-
do not be verbose with spooler tasks
- --spooler-max-tasks
-
set the maximum number of tasks to run before recycling a spooler
- --spooler-harakiri
-
set harakiri timeout for spooler tasks
- --spooler-frequency
-
set spooler frequency
- --spooler-freq
-
set spooler frequency
- --mule
-
add a mule
- --mules
-
add the specified number of mules
- --farm
-
add a mule farm
- --mule-msg-size
-
set mule message buffer size
- --signal
-
send a uwsgi signal to a server
- --signal-bufsize
-
set buffer size for signal queue
- --signals-bufsize
-
set buffer size for signal queue
- --signal-timer
-
add a timer (syntax: <signal> <seconds>)
- --timer
-
add a timer (syntax: <signal> <seconds>)
- --signal-rbtimer
-
add a redblack timer (syntax: <signal> <seconds>)
- --rbtimer
-
add a redblack timer (syntax: <signal> <seconds>)
- --rpc-max
-
maximum number of rpc slots (default: 64)
- -L|--disable-logging
-
disable request logging
- --flock
-
lock the specified file before starting, exit if locked
- --flock-wait
-
lock the specified file before starting, wait if locked
- --flock2
-
lock the specified file after logging/daemon setup, exit if locked
- --flock-wait2
-
lock the specified file after logging/daemon setup, wait if locked
- --pidfile
-
create pidfile (before privileges drop)
- --pidfile2
-
create pidfile (after privileges drop)
- --chroot
-
chroot() to the specified directory
- --pivot-root
-
pivot_root() to the specified directories (new_root and put_old must be separated with a space)
- --pivot_root
-
pivot_root() to the specified directories (new_root and put_old must be separated with a space)
- --uid
-
setuid to the specified user/uid
- --gid
-
setgid to the specified group/gid
- --add-gid
-
add the specified group id to the process credentials
- --immediate-uid
-
setuid to the specified user/uid IMMEDIATELY
- --immediate-gid
-
setgid to the specified group/gid IMMEDIATELY
- --no-initgroups
-
disable additional groups set via initgroups()
- --cap
-
set process capability
- --unshare
-
unshare() part of the processes and put it in a new namespace
- --unshare2
-
unshare() part of the processes and put it in a new namespace after rootfs change
- --setns-socket
-
expose a unix socket returning namespace fds from ,/proc/self/ns/
- --setns-socket-skip
-
skip the specified entry when sending setns file descriptors
- --setns-skip
-
skip the specified entry when sending setns file descriptors
- --setns
-
join a namespace created by an external uWSGI instance
- --setns-preopen
-
open ,/proc/self/ns/ as soon as possible and cache fds
- --jailed
-
mark the instance as jailed (force the execution of post_jail hooks)
- --refork
-
fork() again after privileges drop. Useful for jailing systems
- --re-fork
-
fork() again after privileges drop. Useful for jailing systems
- --refork-as-root
-
fork() again before privileges drop. Useful for jailing systems
- --re-fork-as-root
-
fork() again before privileges drop. Useful for jailing systems
- --refork-post-jail
-
fork() again after jailing. Useful for jailing systems
- --re-fork-post-jail
-
fork() again after jailing. Useful for jailing systems
- --hook-asap
-
run the specified hook as soon as possible
- --hook-pre-jail
-
run the specified hook before jailing
- --hook-post-jail
-
run the specified hook after jailing
- --hook-in-jail
-
run the specified hook in jail after initialization
- --hook-as-root
-
run the specified hook before privileges drop
- --hook-as-user
-
run the specified hook after privileges drop
- --hook-as-user-atexit
-
run the specified hook before app exit and reload
- --hook-pre-app
-
run the specified hook before app loading
- --hook-post-app
-
run the specified hook after app loading
- --hook-post-fork
-
run the specified hook after each fork
- --hook-accepting
-
run the specified hook after each worker enter the accepting phase
- --hook-accepting1
-
run the specified hook after the first worker enters the accepting phase
- --hook-accepting-once
-
run the specified hook after each worker enter the accepting phase (once per-instance)
- --hook-accepting1-once
-
run the specified hook after the first worker enters the accepting phase (once per instance)
- --hook-master-start
-
run the specified hook when the Master starts
- --hook-touch
-
run the specified hook when the specified file is touched (syntax: <file> <action>)
- --hook-emperor-start
-
run the specified hook when the Emperor starts
- --hook-emperor-stop
-
run the specified hook when the Emperor send a stop message
- --hook-emperor-reload
-
run the specified hook when the Emperor send a reload message
- --hook-emperor-lost
-
run the specified hook when the Emperor connection is lost
- --hook-as-vassal
-
run the specified hook before exec()ing the vassal
- --hook-as-emperor
-
run the specified hook in the emperor after the vassal has been started
- --hook-as-mule
-
run the specified hook in each mule
- --hook-as-gateway
-
run the specified hook in each gateway
- --after-request-hook
-
run the specified function/symbol after each request
- --after-request-call
-
run the specified function/symbol after each request
- --exec-asap
-
run the specified command as soon as possible
- --exec-pre-jail
-
run the specified command before jailing
- --exec-post-jail
-
run the specified command after jailing
- --exec-in-jail
-
run the specified command in jail after initialization
- --exec-as-root
-
run the specified command before privileges drop
- --exec-as-user
-
run the specified command after privileges drop
- --exec-as-user-atexit
-
run the specified command before app exit and reload
- --exec-pre-app
-
run the specified command before app loading
- --exec-post-app
-
run the specified command after app loading
- --exec-as-vassal
-
run the specified command before exec()ing the vassal
- --exec-as-emperor
-
run the specified command in the emperor after the vassal has been started
- --mount-asap
-
mount filesystem as soon as possible
- --mount-pre-jail
-
mount filesystem before jailing
- --mount-post-jail
-
mount filesystem after jailing
- --mount-in-jail
-
mount filesystem in jail after initialization
- --mount-as-root
-
mount filesystem before privileges drop
- --mount-as-vassal
-
mount filesystem before exec()ing the vassal
- --mount-as-emperor
-
mount filesystem in the emperor after the vassal has been started
- --umount-asap
-
unmount filesystem as soon as possible
- --umount-pre-jail
-
unmount filesystem before jailing
- --umount-post-jail
-
unmount filesystem after jailing
- --umount-in-jail
-
unmount filesystem in jail after initialization
- --umount-as-root
-
unmount filesystem before privileges drop
- --umount-as-vassal
-
unmount filesystem before exec()ing the vassal
- --umount-as-emperor
-
unmount filesystem in the emperor after the vassal has been started
- --wait-for-interface
-
wait for the specified network interface to come up before running root hooks
- --wait-for-interface-timeout
-
set the timeout for wait-for-interface
- --wait-interface
-
wait for the specified network interface to come up before running root hooks
- --wait-interface-timeout
-
set the timeout for wait-for-interface
- --wait-for-iface
-
wait for the specified network interface to come up before running root hooks
- --wait-for-iface-timeout
-
set the timeout for wait-for-interface
- --wait-iface
-
wait for the specified network interface to come up before running root hooks
- --wait-iface-timeout
-
set the timeout for wait-for-interface
- --wait-for-fs
-
wait for the specified filesystem item to appear before running root hooks
- --wait-for-file
-
wait for the specified file to appear before running root hooks
- --wait-for-dir
-
wait for the specified directory to appear before running root hooks
- --wait-for-mountpoint
-
wait for the specified mountpoint to appear before running root hooks
- --wait-for-fs-timeout
-
set the timeout for wait-for-fs/file/dir
- --wait-for-socket
-
wait for the specified socket to be ready before loading apps
- --wait-for-socket-timeout
-
set the timeout for wait-for-socket
- --call-asap
-
call the specified function as soon as possible
- --call-pre-jail
-
call the specified function before jailing
- --call-post-jail
-
call the specified function after jailing
- --call-in-jail
-
call the specified function in jail after initialization
- --call-as-root
-
call the specified function before privileges drop
- --call-as-user
-
call the specified function after privileges drop
- --call-as-user-atexit
-
call the specified function before app exit and reload
- --call-pre-app
-
call the specified function before app loading
- --call-post-app
-
call the specified function after app loading
- --call-as-vassal
-
call the specified function() before exec()ing the vassal
- --call-as-vassal1
-
call the specified function(char *) before exec()ing the vassal
- --call-as-vassal3
-
call the specified function(char *, uid_t, gid_t) before exec()ing the vassal
- --call-as-emperor
-
call the specified function() in the emperor after the vassal has been started
- --call-as-emperor1
-
call the specified function(char *) in the emperor after the vassal has been started
- --call-as-emperor2
-
call the specified function(char *, pid_t) in the emperor after the vassal has been started
- --call-as-emperor4
-
call the specified function(char *, pid_t, uid_t, gid_t) in the emperor after the vassal has been started
- --ini
-
load config from ini file
- -y|--yaml
-
load config from yaml file
- -y|--yml
-
load config from yaml file
- -j|--json
-
load config from json file
- -j|--js
-
load config from json file
- --weight
-
weight of the instance (used by clustering/lb/subscriptions)
- --auto-weight
-
set weight of the instance (used by clustering/lb/subscriptions) automatically
- --no-server
-
force no-server mode
- --command-mode
-
force command mode
- --no-defer-accept
-
disable deferred-accept on sockets
- --tcp-nodelay
-
enable TCP NODELAY on each request
- --so-keepalive
-
enable TCP KEEPALIVEs
- --so-send-timeout
-
set SO_SNDTIMEO
- --socket-send-timeout
-
set SO_SNDTIMEO
- --so-write-timeout
-
set SO_SNDTIMEO
- --socket-write-timeout
-
set SO_SNDTIMEO
- --socket-sndbuf
-
set SO_SNDBUF
- --socket-rcvbuf
-
set SO_RCVBUF
- --limit-as
-
limit processes address space/vsz
- --limit-nproc
-
limit the number of spawnable processes
- --reload-on-as
-
reload if address space is higher than specified megabytes
- --reload-on-rss
-
reload if rss memory is higher than specified megabytes
- --evil-reload-on-as
-
force the master to reload a worker if its address space is higher than specified megabytes
- --evil-reload-on-rss
-
force the master to reload a worker if its rss memory is higher than specified megabytes
- --mem-collector-freq
-
set the memory collector frequency when evil reloads are in place
- --reload-on-fd
-
reload if the specified file descriptor is ready
- --brutal-reload-on-fd
-
brutal reload if the specified file descriptor is ready
- --ksm
-
enable Linux KSM
- --pcre-jit
-
enable pcre jit (if available)
- --never-swap
-
lock all memory pages avoiding swapping
- --touch-reload
-
reload uWSGI if the specified file is modified/touched
- --touch-workers-reload
-
trigger reload of (only) workers if the specified file is modified/touched
- --touch-chain-reload
-
trigger chain reload if the specified file is modified/touched
- --touch-logrotate
-
trigger logrotation if the specified file is modified/touched
- --touch-logreopen
-
trigger log reopen if the specified file is modified/touched
- --touch-exec
-
run command when the specified file is modified/touched (syntax: file command)
- --touch-signal
-
signal when the specified file is modified/touched (syntax: file signal)
- --fs-reload
-
graceful reload when the specified filesystem object is modified
- --fs-brutal-reload
-
brutal reload when the specified filesystem object is modified
- --fs-signal
-
raise a uwsgi signal when the specified filesystem object is modified (syntax: file signal)
- --check-mountpoint
-
destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management)
- --mountpoint-check
-
destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management)
- --check-mount
-
destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management)
- --mount-check
-
destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management)
- --propagate-touch
-
over-engineering option for system with flaky signal management
- --limit-post
-
limit request body
- --no-orphans
-
automatically kill workers if master dies (can be dangerous for availability)
- --prio
-
set processes/threads priority
- --cpu-affinity
-
set cpu affinity
- --post-buffering
-
set size in bytes after which will buffer to disk instead of memory
- --post-buffering-bufsize
-
set buffer size for read() in post buffering mode
- --body-read-warning
-
set the amount of allowed memory allocation (in megabytes) for request body before starting printing a warning
- --upload-progress
-
enable creation of .json files in the specified directory during a file upload
- --no-default-app
-
do not fallback to default app
- --manage-script-name
-
automatically rewrite SCRIPT_NAME and PATH_INFO
- --ignore-script-name
-
ignore SCRIPT_NAME
- --catch-exceptions
-
report exception as http output (discouraged, use only for testing)
- --reload-on-exception
-
reload a worker when an exception is raised
- --reload-on-exception-type
-
reload a worker when a specific exception type is raised
- --reload-on-exception-value
-
reload a worker when a specific exception value is raised
- --reload-on-exception-repr
-
reload a worker when a specific exception type+value (language-specific) is raised
- --exception-handler
-
add an exception handler
- --enable-metrics
-
enable metrics subsystem
- --metric
-
add a custom metric
- --metric-threshold
-
add a metric threshold/alarm
- --metric-alarm
-
add a metric threshold/alarm
- --alarm-metric
-
add a metric threshold/alarm
- --metrics-dir
-
export metrics as text files to the specified directory
- --metrics-dir-restore
-
restore last value taken from the metrics dir
- --metric-dir
-
export metrics as text files to the specified directory
- --metric-dir-restore
-
restore last value taken from the metrics dir
- --metrics-no-cores
-
disable generation of cores-related metrics
- --udp
-
run the udp server on the specified address
- --stats
-
enable the stats server on the specified address
- --stats-server
-
enable the stats server on the specified address
- --stats-http
-
prefix stats server json output with http headers
- --stats-minified
-
minify statistics json output
- --stats-min
-
minify statistics json output
- --stats-push
-
push the stats json to the specified destination
- --stats-pusher-default-freq
-
set the default frequency of stats pushers
- --stats-pushers-default-freq
-
set the default frequency of stats pushers
- --stats-no-cores
-
disable generation of cores-related stats
- --stats-no-metrics
-
do not include metrics in stats output
- --multicast
-
subscribe to specified multicast group
- --multicast-ttl
-
set multicast ttl
- --multicast-loop
-
set multicast loop (default 1)
- --master-fifo
-
enable the master fifo
- --notify-socket
-
enable the notification socket
- --subscription-notify-socket
-
set the notification socket for subscriptions
- --legion
-
became a member of a legion
- --legion-mcast
-
became a member of a legion (shortcut for multicast)
- --legion-node
-
add a node to a legion
- --legion-freq
-
set the frequency of legion packets
- --legion-tolerance
-
set the tolerance of legion subsystem
- --legion-death-on-lord-error
-
declare itself as a dead node for the specified amount of seconds if one of the lord hooks fails
- --legion-skew-tolerance
-
set the clock skew tolerance of legion subsystem (default 30 seconds)
- --legion-lord
-
action to call on Lord election
- --legion-unlord
-
action to call on Lord dismiss
- --legion-setup
-
action to call on legion setup
- --legion-death
-
action to call on legion death (shutdown of the instance)
- --legion-join
-
action to call on legion join (first time quorum is reached)
- --legion-node-joined
-
action to call on new node joining legion
- --legion-node-left
-
action to call node leaving legion
- --legion-quorum
-
set the quorum of a legion
- --legion-scroll
-
set the scroll of a legion
- --legion-scroll-max-size
-
set max size of legion scroll buffer
- --legion-scroll-list-max-size
-
set max size of legion scroll list buffer
- --subscriptions-sign-check
-
set digest algorithm and certificate directory for secured subscription system
- --subscriptions-sign-check-tolerance
-
set the maximum tolerance (in seconds) of clock skew for secured subscription system
- --subscriptions-sign-skip-uid
-
skip signature check for the specified uid when using unix sockets credentials
- --subscriptions-credentials-check
-
add a directory to search for subscriptions key credentials
- --subscriptions-use-credentials
-
enable management of SCM_CREDENTIALS in subscriptions UNIX sockets
- --subscription-algo
-
set load balancing algorithm for the subscription system
- --subscription-dotsplit
-
try to fallback to the next part (dot based) in subscription key
- --subscribe-to
-
subscribe to the specified subscription server
- --st
-
subscribe to the specified subscription server
- --subscribe
-
subscribe to the specified subscription server
- --subscribe2
-
subscribe to the specified subscription server using advanced keyval syntax
- --subscribe-freq
-
send subscription announce at the specified interval
- --subscription-tolerance
-
set tolerance for subscription servers
- --unsubscribe-on-graceful-reload
-
force unsubscribe request even during graceful reload
- --start-unsubscribed
-
configure subscriptions but do not send them (useful with master fifo)
- --subscribe-with-modifier1
-
force the specififed modifier1 when subscribing
- --snmp
-
enable the embedded snmp server
- --snmp-community
-
set the snmp community string
- --ssl-verbose
-
be verbose about SSL errors
- --ssl-sessions-use-cache
-
use uWSGI cache for ssl sessions storage
- --ssl-session-use-cache
-
use uWSGI cache for ssl sessions storage
- --ssl-sessions-timeout
-
set SSL sessions timeout (default: 300 seconds)
- --ssl-session-timeout
-
set SSL sessions timeout (default: 300 seconds)
- --sni
-
add an SNI-governed SSL context
- --sni-dir
-
check for cert/key/client_ca file in the specified directory and create a sni/ssl context on demand
- --sni-dir-ciphers
-
set ssl ciphers for sni-dir option
- --ssl-enable3
-
enable SSLv3 (insecure)
- --ssl-option
-
set a raw ssl option (numeric value)
- --sni-regexp
-
add an SNI-governed SSL context (the key is a regexp)
- --ssl-tmp-dir
-
store ssl-related temp files in the specified directory
- --check-interval
-
set the interval (in seconds) of master checks
- --forkbomb-delay
-
sleep for the specified number of seconds when a forkbomb is detected
- --binary-path
-
force binary path
- --privileged-binary-patch
-
patch the uwsgi binary with a new command (before privileges drop)
- --unprivileged-binary-patch
-
patch the uwsgi binary with a new command (after privileges drop)
- --privileged-binary-patch-arg
-
patch the uwsgi binary with a new command and arguments (before privileges drop)
- --unprivileged-binary-patch-arg
-
patch the uwsgi binary with a new command and arguments (after privileges drop)
- --async
-
enable async mode with specified cores
- --max-fd
-
set maximum number of file descriptors (requires root privileges)
- --logto
-
set logfile/udp address
- --logto2
-
log to specified file or udp address after privileges drop
- --log-format
-
set advanced format for request logging
- --logformat
-
set advanced format for request logging
- --logformat-strftime
-
apply strftime to logformat output
- --log-format-strftime
-
apply strftime to logformat output
- --logfile-chown
-
chown logfiles
- --logfile-chmod
-
chmod logfiles
- --log-syslog
-
log to syslog
- --log-socket
-
send logs to the specified socket
- --req-logger
-
set/append a request logger
- --logger-req
-
set/append a request logger
- --logger
-
set/append a logger
- --logger-list
-
list enabled loggers
- --loggers-list
-
list enabled loggers
- --threaded-logger
-
offload log writing to a thread
- --log-encoder
-
add an item in the log encoder chain
- --log-req-encoder
-
add an item in the log req encoder chain
- --log-drain
-
drain (do not show) log lines matching the specified regexp
- --log-filter
-
show only log lines matching the specified regexp
- --log-route
-
log to the specified named logger if regexp applied on logline matches
- --log-req-route
-
log requests to the specified named logger if regexp applied on logline matches
- --use-abort
-
call abort() on segfault/fpe, could be useful for generating a core dump
- --alarm
-
create a new alarm, syntax: <alarm> <plugin:args>
- --alarm-cheap
-
use main alarm thread rather than create dedicated threads for curl-based alarms
- --alarm-freq
-
tune the anti-loop alarm system (default 3 seconds)
- --alarm-fd
-
raise the specified alarm when an fd is read for read (by default it reads 1 byte, set 8 for eventfd)
- --alarm-segfault
-
raise the specified alarm when the segmentation fault handler is executed
- --segfault-alarm
-
raise the specified alarm when the segmentation fault handler is executed
- --alarm-backlog
-
raise the specified alarm when the socket backlog queue is full
- --backlog-alarm
-
raise the specified alarm when the socket backlog queue is full
- --lq-alarm
-
raise the specified alarm when the socket backlog queue is full
- --alarm-lq
-
raise the specified alarm when the socket backlog queue is full
- --alarm-listen-queue
-
raise the specified alarm when the socket backlog queue is full
- --listen-queue-alarm
-
raise the specified alarm when the socket backlog queue is full
- --log-alarm
-
raise the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp>
- --alarm-log
-
raise the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp>
- --not-log-alarm
-
skip the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp>
- --not-alarm-log
-
skip the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp>
- --alarm-list
-
list enabled alarms
- --alarms-list
-
list enabled alarms
- --alarm-msg-size
-
set the max size of an alarm message (default 8192)
- --log-master
-
delegate logging to master process
- --log-master-bufsize
-
set the buffer size for the master logger. bigger log messages will be truncated
- --log-master-stream
-
create the master logpipe as SOCK_STREAM
- --log-master-req-stream
-
create the master requests logpipe as SOCK_STREAM
- --log-reopen
-
reopen log after reload
- --log-truncate
-
truncate log on startup
- --log-maxsize
-
set maximum logfile size
- --log-backupname
-
set logfile name after rotation
- --logdate
-
prefix logs with date or a strftime string
- --log-date
-
prefix logs with date or a strftime string
- --log-prefix
-
prefix logs with a string
- --log-zero
-
log responses without body
- --log-slow
-
log requests slower than the specified number of milliseconds
- --log-4xx
-
log requests with a 4xx response
- --log-5xx
-
log requests with a 5xx response
- --log-big
-
log requestes bigger than the specified size
- --log-sendfile
-
log sendfile requests
- --log-ioerror
-
log requests with io errors
- --log-micros
-
report response time in microseconds instead of milliseconds
- --log-x-forwarded-for
-
use the ip from X-Forwarded-For header instead of REMOTE_ADDR
- --master-as-root
-
leave master process running as root
- --drop-after-init
-
run privileges drop after plugin initialization
- --drop-after-apps
-
run privileges drop after apps loading
- --force-cwd
-
force the initial working directory to the specified value
- --binsh
-
override ,/bin/sh/ (used by exec hooks, it always fallback to ,/bin/sh/)
- --chdir
-
chdir to specified directory before apps loading
- --chdir2
-
chdir to specified directory after apps loading
- --lazy
-
set lazy mode (load apps in workers instead of master)
- --lazy-apps
-
load apps in each worker instead of the master
- --cheap
-
set cheap mode (spawn workers only after the first request)
- --cheaper
-
set cheaper mode (adaptive process spawning)
- --cheaper-initial
-
set the initial number of processes to spawn in cheaper mode
- --cheaper-algo
-
choose to algorithm used for adaptive process spawning
- --cheaper-step
-
number of additional processes to spawn at each overload
- --cheaper-overload
-
increase workers after specified overload
- --cheaper-algo-list
-
list enabled cheapers algorithms
- --cheaper-algos-list
-
list enabled cheapers algorithms
- --cheaper-list
-
list enabled cheapers algorithms
- --cheaper-rss-limit-soft
-
don't spawn new workers if total resident memory usage of all workers is higher than this limit
- --cheaper-rss-limit-hard
-
if total workers resident memory usage is higher try to stop workers
- --idle
-
set idle mode (put uWSGI in cheap mode after inactivity)
- --die-on-idle
-
shutdown uWSGI when idle
- --mount
-
load application under mountpoint
- --worker-mount
-
load application under mountpoint in the specified worker or after workers spawn
- --threads
-
run each worker in prethreaded mode with the specified number of threads
- --thread-stacksize
-
set threads stacksize
- --threads-stacksize
-
set threads stacksize
- --thread-stack-size
-
set threads stacksize
- --threads-stack-size
-
set threads stacksize
- --vhost
-
enable virtualhosting mode (based on SERVER_NAME variable)
- --vhost-host
-
enable virtualhosting mode (based on HTTP_HOST variable)
- --route
-
add a route
- --route-host
-
add a route based on Host header
- --route-uri
-
add a route based on REQUEST_URI
- --route-qs
-
add a route based on QUERY_STRING
- --route-remote-addr
-
add a route based on REMOTE_ADDR
- --route-user-agent
-
add a route based on HTTP_USER_AGENT
- --route-remote-user
-
add a route based on REMOTE_USER
- --route-referer
-
add a route based on HTTP_REFERER
- --route-label
-
add a routing label (for use with goto)
- --route-if
-
add a route based on condition
- --route-if-not
-
add a route based on condition (negate version)
- --route-run
-
always run the specified route action
- --final-route
-
add a final route
- --final-route-status
-
add a final route for the specified status
- --final-route-host
-
add a final route based on Host header
- --final-route-uri
-
add a final route based on REQUEST_URI
- --final-route-qs
-
add a final route based on QUERY_STRING
- --final-route-remote-addr
-
add a final route based on REMOTE_ADDR
- --final-route-user-agent
-
add a final route based on HTTP_USER_AGENT
- --final-route-remote-user
-
add a final route based on REMOTE_USER
- --final-route-referer
-
add a final route based on HTTP_REFERER
- --final-route-label
-
add a final routing label (for use with goto)
- --final-route-if
-
add a final route based on condition
- --final-route-if-not
-
add a final route based on condition (negate version)
- --final-route-run
-
always run the specified final route action
- --error-route
-
add an error route
- --error-route-status
-
add an error route for the specified status
- --error-route-host
-
add an error route based on Host header
- --error-route-uri
-
add an error route based on REQUEST_URI
- --error-route-qs
-
add an error route based on QUERY_STRING
- --error-route-remote-addr
-
add an error route based on REMOTE_ADDR
- --error-route-user-agent
-
add an error route based on HTTP_USER_AGENT
- --error-route-remote-user
-
add an error route based on REMOTE_USER
- --error-route-referer
-
add an error route based on HTTP_REFERER
- --error-route-label
-
add an error routing label (for use with goto)
- --error-route-if
-
add an error route based on condition
- --error-route-if-not
-
add an error route based on condition (negate version)
- --error-route-run
-
always run the specified error route action
- --response-route
-
add a response route
- --response-route-status
-
add a response route for the specified status
- --response-route-host
-
add a response route based on Host header
- --response-route-uri
-
add a response route based on REQUEST_URI
- --response-route-qs
-
add a response route based on QUERY_STRING
- --response-route-remote-addr
-
add a response route based on REMOTE_ADDR
- --response-route-user-agent
-
add a response route based on HTTP_USER_AGENT
- --response-route-remote-user
-
add a response route based on REMOTE_USER
- --response-route-referer
-
add a response route based on HTTP_REFERER
- --response-route-label
-
add a response routing label (for use with goto)
- --response-route-if
-
add a response route based on condition
- --response-route-if-not
-
add a response route based on condition (negate version)
- --response-route-run
-
always run the specified response route action
- --router-list
-
list enabled routers
- --routers-list
-
list enabled routers
- --error-page-403
-
add an error page (html) for managed 403 response
- --error-page-404
-
add an error page (html) for managed 404 response
- --error-page-500
-
add an error page (html) for managed 500 response
- --websockets-ping-freq
-
set the frequency (in seconds) of websockets automatic ping packets
- --websocket-ping-freq
-
set the frequency (in seconds) of websockets automatic ping packets
- --websockets-pong-tolerance
-
set the tolerance (in seconds) of websockets ping/pong subsystem
- --websocket-pong-tolerance
-
set the tolerance (in seconds) of websockets ping/pong subsystem
- --websockets-max-size
-
set the max allowed size of websocket messages (in Kbytes, default 1024)
- --websocket-max-size
-
set the max allowed size of websocket messages (in Kbytes, default 1024)
- --chunked-input-limit
-
set the max size of a chunked input part (default 1MB, in bytes)
- --chunked-input-timeout
-
set default timeout for chunked input
- --clock
-
set a clock source
- --clock-list
-
list enabled clocks
- --clocks-list
-
list enabled clocks
- --add-header
-
automatically add HTTP headers to response
- --rem-header
-
automatically remove specified HTTP header from the response
- --del-header
-
automatically remove specified HTTP header from the response
- --collect-header
-
store the specified response header in a request var (syntax: header var)
- --response-header-collect
-
store the specified response header in a request var (syntax: header var)
- --pull-header
-
store the specified response header in a request var and remove it from the response (syntax: header var)
- --check-static
-
check for static files in the specified directory
- --check-static-docroot
-
check for static files in the requested DOCUMENT_ROOT
- --static-check
-
check for static files in the specified directory
- --static-map
-
map mountpoint to static directory (or file)
- --static-map2
-
like static-map but completely appending the requested resource to the docroot
- --static-skip-ext
-
skip specified extension from staticfile checks
- --static-index
-
search for specified file if a directory is requested
- --static-safe
-
skip security checks if the file is under the specified path
- --static-cache-paths
-
put resolved paths in the uWSGI cache for the specified amount of seconds
- --static-cache-paths-name
-
use the specified cache for static paths
- --mimefile
-
set mime types file path (default ,/etc/mime.types/)
- --mime-file
-
set mime types file path (default ,/etc/mime.types/)
- --static-expires-type
-
set the Expires header based on content type
- --static-expires-type-mtime
-
set the Expires header based on content type and file mtime
- --static-expires
-
set the Expires header based on filename regexp
- --static-expires-mtime
-
set the Expires header based on filename regexp and file mtime
- --static-expires-uri
-
set the Expires header based on REQUEST_URI regexp
- --static-expires-uri-mtime
-
set the Expires header based on REQUEST_URI regexp and file mtime
- --static-expires-path-info
-
set the Expires header based on PATH_INFO regexp
- --static-expires-path-info-mtime
-
set the Expires header based on PATH_INFO regexp and file mtime
- --static-gzip
-
if the supplied regexp matches the static file translation it will search for a gzip version
- --static-gzip-all
-
check for a gzip version of all requested static files
- --static-gzip-dir
-
check for a gzip version of all requested static files in the specified dir/prefix
- --static-gzip-prefix
-
check for a gzip version of all requested static files in the specified dir/prefix
- --static-gzip-ext
-
check for a gzip version of all requested static files with the specified ext/suffix
- --static-gzip-suffix
-
check for a gzip version of all requested static files with the specified ext/suffix
- --honour-range
-
enable support for the HTTP Range header
- --offload-threads
-
set the number of offload threads to spawn (per-worker, default 0)
- --offload-thread
-
set the number of offload threads to spawn (per-worker, default 0)
- --file-serve-mode
-
set static file serving mode
- --fileserve-mode
-
set static file serving mode
- --disable-sendfile
-
disable sendfile() and rely on boring read()/write()
- --check-cache
-
check for response data in the specified cache (empty for default cache)
- --close-on-exec
-
set close-on-exec on connection sockets (could be required for spawning processes in requests)
- --close-on-exec2
-
set close-on-exec on server sockets (could be required for spawning processes in requests)
- --mode
-
set uWSGI custom mode
- --env
-
set environment variable
- --envdir
-
load a daemontools compatible envdir
- --early-envdir
-
load a daemontools compatible envdir ASAP
- --unenv
-
unset environment variable
- --vacuum
-
try to remove all of the generated file/sockets
- --file-write
-
write the specified content to the specified file (syntax: file=value) before privileges drop
- --cgroup
-
put the processes in the specified cgroup
- --cgroup-opt
-
set value in specified cgroup option
- --cgroup-dir-mode
-
set permission for cgroup directory (default is 700)
- --namespace
-
run in a new namespace under the specified rootfs
- --namespace-keep-mount
-
keep the specified mountpoint in your namespace
- --ns
-
run in a new namespace under the specified rootfs
- --namespace-net
-
add network namespace
- --ns-net
-
add network namespace
- --enable-proxy-protocol
-
enable PROXY1 protocol support (only for http parsers)
- --reuse-port
-
enable REUSE_PORT flag on socket (BSD only)
- --tcp-fast-open
-
enable TCP_FASTOPEN flag on TCP sockets with the specified qlen value
- --tcp-fastopen
-
enable TCP_FASTOPEN flag on TCP sockets with the specified qlen value
- --tcp-fast-open-client
-
use sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported
- --tcp-fastopen-client
-
use sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported
- --zerg
-
attach to a zerg server
- --zerg-fallback
-
fallback to normal sockets if the zerg server is not available
- --zerg-server
-
enable the zerg server on the specified UNIX socket
- --cron
-
add a cron task
- --cron2
-
add a cron task (key=val syntax)
- --unique-cron
-
add a unique cron task
- --cron-harakiri
-
set the maximum time (in seconds) we wait for cron command to complete
- --legion-cron
-
add a cron task runnable only when the instance is a lord of the specified legion
- --cron-legion
-
add a cron task runnable only when the instance is a lord of the specified legion
- --unique-legion-cron
-
add a unique cron task runnable only when the instance is a lord of the specified legion
- --unique-cron-legion
-
add a unique cron task runnable only when the instance is a lord of the specified legion
- --loop
-
select the uWSGI loop engine
- --loop-list
-
list enabled loop engines
- --loops-list
-
list enabled loop engines
- --worker-exec
-
run the specified command as worker
- --worker-exec2
-
run the specified command as worker (after post_fork hook)
- --attach-daemon
-
attach a command/daemon to the master process (the command has to not go in background)
- --attach-control-daemon
-
attach a command/daemon to the master process (the command has to not go in background), when the daemon dies, the master dies too
- --smart-attach-daemon
-
attach a command/daemon to the master process managed by a pidfile (the command has to daemonize)
- --smart-attach-daemon2
-
attach a command/daemon to the master process managed by a pidfile (the command has to NOT daemonize)
- --legion-attach-daemon
-
same as --attach-daemon but daemon runs only on legion lord node
- --legion-smart-attach-daemon
-
same as --smart-attach-daemon but daemon runs only on legion lord node
- --legion-smart-attach-daemon2
-
same as --smart-attach-daemon2 but daemon runs only on legion lord node
- --daemons-honour-stdin
-
do not change the stdin of external daemons to ,/dev/null/
- --attach-daemon2
-
attach-daemon keyval variant (supports smart modes too)
- --plugins
-
load uWSGI plugins
- --plugin
-
load uWSGI plugins
- --need-plugins
-
load uWSGI plugins (exit on error)
- --need-plugin
-
load uWSGI plugins (exit on error)
- --plugins-dir
-
add a directory to uWSGI plugin search path
- --plugin-dir
-
add a directory to uWSGI plugin search path
- --plugins-list
-
list enabled plugins
- --plugin-list
-
list enabled plugins
- --autoload
-
try to automatically load plugins when unknown options are found
- --dlopen
-
blindly load a shared library
- --allowed-modifiers
-
comma separated list of allowed modifiers
- --remap-modifier
-
remap request modifier from one id to another
- --dump-options
-
dump the full list of available options
- --show-config
-
show the current config reformatted as ini
- --binary-append-data
-
return the content of a resource to stdout for appending to a uwsgi binary (for data:// usage)
- --print
-
simple print
- --iprint
-
simple print (immediate version)
- --exit
-
force exit() of the instance
- --cflags
-
report uWSGI CFLAGS (useful for building external plugins)
- --dot-h
-
dump the uwsgi.h used for building the core (useful for building external plugins)
- --config-py
-
dump the uwsgiconfig.py used for building the core (useful for building external plugins)
- --build-plugin
-
build a uWSGI plugin for the current binary
- --version
-
print uWSGI version
- --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
- --python-worker-override
-
override worker with the specified python script