UWSGI_PYTHON311(1)

📦 version 2.0.21, in debian bookworm

✨ NAME ✨

uwsgi_python311 — a fast (pure C), self-healing, developer-friendly WSGI server. bestie she is that girl. 💅

🦋 SYNOPSIS 🦋

uwsgi-core-local [options...]

💖 DESCRIPTION 💖

okay so. this is uWSGI, but the Python 3.11 flavoured one, and the whole page is basically one giant list of options. no shade, that's just how she is. every flag below does exactly what it says, so grab a snack 🍓 and let's go.

💅 sockets & protocols

-s, --socket — bind to the specified UNIX/TCP socket using the default protocol 🌈
-s, --uwsgi-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol
--suwsgi-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol over SSL 🔒
--ssl-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol over SSL 🔒
--http-socket — bind to the specified UNIX/TCP socket using the HTTP protocol 🌐
--http-socket-modifier1 — force the specified modifier1 when using the HTTP protocol
--http-socket-modifier2 — force the specified modifier2 when using the HTTP protocol
--http11-socket — bind to the specified UNIX/TCP socket using the HTTP 1.1 (Keep-Alive) protocol ✨
--https-socket — bind to the specified UNIX/TCP socket using the HTTPS protocol 🔐
--https-socket-modifier1 — force the specified modifier1 when using the HTTPS protocol
--https-socket-modifier2 — force the specified modifier2 when using the HTTPS protocol
--fastcgi-socket — bind to the specified UNIX/TCP socket using the FastCGI protocol
--fastcgi-nph-socket — bind to the specified UNIX/TCP socket using the FastCGI protocol (nph mode)
--fastcgi-modifier1 — force the specified modifier1 when using the FastCGI protocol
--fastcgi-modifier2 — force the specified modifier2 when using the FastCGI protocol
--scgi-socket — bind to the specified UNIX/TCP socket using the SCGI protocol
--scgi-nph-socket — bind to the specified UNIX/TCP socket using the SCGI protocol (nph mode)
--scgi-modifier1 — force the specified modifier1 when using the SCGI protocol
--scgi-modifier2 — force the specified modifier2 when using the SCGI protocol
--raw-socket — bind to the specified UNIX/TCP socket using the RAW protocol
--raw-modifier1 — force the specified modifier1 when using the RAW protocol
--raw-modifier2 — force the specified modifier2 when using the RAW protocol
--puwsgi-socket — bind to the specified UNIX/TCP socket using the 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)

🧚 workers, processes & harakiri

-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

📜 config & friends

-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)

🎀 opt logic (the if/for girlies)

--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

🌈 lists, errors & templates

--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)

💀 daemonize & instance control

-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

⭐ tuning, buffers & memory

-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

🧵 threads, names & the master

-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

👑 the Emperor

--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

and bestie we are literally not even close to done, hold on because part 2 is right there and it's got even more 💖

--early-emperor — spawn the emperor as soon as possibile ✨ (yes, that's the manpage's own spelling, we keep it bestie, no cap)
--emperor-broodlord — run the emperor in BroodLord mode 🧚 (it's giving sci-fi villain, but make it config management)
--emperor-throttle — set the throttling level (in milliseconds) for vassals that are being bad 😤 default is 1000
--emperor-max-throttle — set the max throttling level (in milliseconds) for badly-behaved vassals, default is 3 minutes 💀
--emperor-magic-exec — prefixes vassal config files with exec:// if they have the executable bit set 🔥 lowkey magic fr
--emperor-on-demand-extension — search for a text file (vassal name + extension) that contains the on demand socket name 🫶
--emperor-on-demand-ext — same thing, shorter name, search for that text file (vassal name + extension) holding the on demand socket name 💅
--emperor-on-demand-directory — enable on demand mode, binding to the unix socket inside the specified directory, named like the vassal + .socket 🌸
--emperor-on-demand-dir — the short twin: on demand mode, unix socket in the specified dir, named vassal + .socket ✨
--emperor-on-demand-exec — use the output of the specified command as the on demand socket name (the vassal name gets passed as the only argument) 👑
--emperor-extra-extension — allows the specified extension in the Emperor (the vassal will be called with --config) 🎀
--emperor-extra-ext — same energy, short version: allows that extension in the Emperor, vassal gets called with --config 🦋
--emperor-no-blacklist — disable the 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 🌈 (yes, ragnarok, they said what they said)
--emperor-cap — set vassals capability 💪
--vassals-cap — set vassals capability (same flag, another alias, we love options) 💪
--vassal-cap — set vassals capability, singular edition 💪
--imperial-monitor-list — list enabled imperial monitors 👀
--imperial-monitors-list — list enabled imperial monitors (plural, because why not) 👀
--vassals-inherit — add config templates to vassals config (uses --inherit) 🫶
--vassals-include — include config templates in vassals config (uses --include instead of --inherit) ✨
--vassals-inherit-before — add config templates to vassals config (uses --inherit, and parses before the vassal file) ⭐
--vassals-include-before — include config templates in vassals config (uses --include instead of --inherit, and parses before the vassal file) ⭐
--vassals-start-hook — run the specified command before each vassal starts 🎬
--vassals-stop-hook — run the specified command after a vassal's death 💀
--vassal-sos — ask the emperor for reinforcement when overloaded 🆘
--vassal-sos-backlog — ask the emperor for SOS if the 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 (singular spelling, same vibe) 🔁
--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 (yes, again, it's the same letter, don't come for us) 🫶
--print-sym — print the content of the specified binary symbol 🔍
--print-symbol — print the content of the specified binary symbol (longer name, same tea) 🔍
-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 a worker must run before being reloaded, default is 60 ⏱️
--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 (same thing, different order, iconic) 🛟
--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 (short twin) 📶
--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 (plural, same thing) 📥
--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) — underscore edition 💅
--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, but 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 (short version) ⏭️
--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 (hyphen edition) 🔁
--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 (hyphen edition, still iconic) 👑

✨ OPTIONS ✨

okay bestie we're in the thick of it now, this is the options list and it is long. hydrate. stretch. let's go 💅

🪝 hooks (aka the "do a thing at this exact moment" squad)

every single one of these wants you to hand it a hook — you pick the moment, it runs your hook there. no cap.

--refork-post-jail — fork() again after jailing. useful for jailing systems 🎀
--re-fork-post-jail — fork() again after jailing. useful for jailing systems (yes bestie it's the same thing, it's an alias, we love a spare key 🔑)
--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 enters 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 enters 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 sends a stop message
--hook-emperor-reload — run the specified hook when the Emperor sends 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 — same moments, but it's a command this time

--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 — filesystems, but make it scheduled

--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 — the un-mounting of it all

--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

⏳ waiting era — bestie we are NOT starting until this thing exists

🌐 network interfaces (four whole names for the same vibe, iconic)

--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

📁 filesystem stuff

--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

🔌 sockets

--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 — like exec but it's a function, and it is picky about signatures

some of these care about the exact shape of the function you hand them. the ones with a number at the end? that's the arg count, iykyk. don't mix them up bestie 💀

--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

📄 config files — feed me, bestie

--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

⚖️ mode + weight + the socket behaviour knobs

--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

🚧 limits, memory, and the reload machinery

--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 💀

ngl "brutal" is doing a lot of heavy lifting in that name and it means what it says. read the label before you reach for it.

--ksm — enable Linux KSM
--pcre-jit — enable pcre jit (if available)
--never-swap — lock all memory pages avoiding swapping

👆 touch-* — the "poke a file, get a reaction" collection

--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-* — filesystem object watches, the glow-up edition

--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)

and we are not done bestie, keep scrolling, there's more coming 💖

--check-mountpoint — destroys the instance if a filesystem is no longer reachable 💀 (handy if you want reliable Fuse management, fr fr)
--mountpoint-check — yeah same thing bestie: instance gets destroyed when a filesystem stops being reachable (good for reliable Fuse management) ✨
--check-mount — yep, again: destroy the instance if a filesystem is no more reachable (reliable Fuse management vibes 🫶)
--mount-check — the fourth twin 💅 destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management)
--propagate-touch — over-engineering option for systems with flaky signal management 😭 like it's giving "we fixed the thing by adding more thing"
--limit-post — limit the request body 🛑
--no-orphans — automatically kills workers if the master dies 🪦

⚠️ bestie this one can be dangerous for availability, so know what you're doing before you turn it on

--prio — set processes/threads priority 🎚️
--cpu-affinity — set cpu affinity 🧲
--post-buffering — set the size in bytes after which it'll buffer to disk instead of memory 📦
--post-buffering-bufsize — set the buffer size for read() in post buffering mode 📖
--body-read-warning — set the amount of allowed memory allocation (in megabytes) for the request body before it starts 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 — literally it says so, don't @ me

--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 (same energy, different name 💅)
--alarm-metric — add a metric threshold/alarm (yes queen, three names, one job 👑)
--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 (the shorter-flavored twin 🌸)
--metric-dir-restore — restore last value taken from the metrics dir (also the shorter twin 🌸)
--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 (same, same 🙃)
--stats-http — prefix stats server json output with http headers 🌐
--stats-minified — minify statistics json output 🗜️
--stats-min — minify statistics json output (identical twin, they're obsessed with each other 🫶)
--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 (plural edition 🧚)
--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 (the short king 👑)
--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 specified 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 🚨

okay and that's the end of this chunk bestie, more coming, stay tuned 💖

--segfault-alarm — the moment the segmentation fault handler fires, raise the alarm you named. yes bestie, segfaults get their own ✨klaxon✨
--alarm-backlog — raise the specified alarm when the socket backlog queue is full 😭
--backlog-alarm — same energy, same job: raise the specified alarm when the socket backlog queue is full. it's the same option, just a different alias 🫶
--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 — when a log line matches your regexp, raise the specified alarm. syntax: <alarm>[,alarm...] <regexp> 🔥
--alarm-log — same thing, different name order: raise the specified alarm when a log line matches the specified regexp. syntax: <alarm>[,alarm...] <regexp>
--not-log-alarm — the opposite vibe: 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 — show me all the enabled alarms 👑
--alarms-list — also lists enabled alarms. twins fr fr 💜
--alarm-msg-size — set the max size of an alarm message. default is 8192 📏
--log-master — hand the logging off to the master process. delegation, main character energy ✨
--log-master-bufsize — set the buffer size for the master logger. heads up bestie: 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 the log after a reload 🔁
--log-truncate — truncate the log on startup. fresh slate, clean girl aesthetic 🎀
--log-maxsize — set the maximum logfile size
--log-backupname — set the logfile name to use after rotation
--logdate — prefix your logs with a date, or with a strftime string 🗓️
--log-date — same: prefix logs with a date or a strftime string
--log-prefix — prefix logs with a string of your choosing
--log-zero — log responses that have no body at all 🫥
--log-slow — log any request slower than the number of milliseconds you specify 🐌
--log-4xx — log requests that came back with a 4xx response
--log-5xx — log requests that came back with a 5xx response
--log-big — log requestes bigger than the specified size (the typo stays, it's canon now 💅)
--log-sendfile — log sendfile requests
--log-ioerror — log requests that hit io errors
--log-micros — report response time in microseconds instead of milliseconds. precision era ⏱️
--log-x-forwarded-for — use the ip from the X-Forwarded-For header instead of REMOTE_ADDR

--master-as-root — leave the master process running as root 👑
--drop-after-init — run the privileges drop after plugin initialization. note: this one is superseded by drop-after-apps
--drop-after-apps — run the privileges drop after apps loading. note: this one is superseded by master-as-root
--force-cwd — force the initial working directory to the value you give it
--binsh — override /bin/sh (it's used by exec hooks, and it always falls back to /bin/sh)
--chdir — chdir to the specified directory before apps loading
--chdir2 — chdir to the specified directory after apps loading
--lazy — set lazy mode: load apps in the workers instead of the master 😴
--lazy-apps — load apps in each worker instead of the master
--cheap — set cheap mode: workers only get spawned after the very first request 🪙
--cheaper — set cheaper mode, aka adaptive process spawning 📈
--cheaper-initial — set the initial number of processes to spawn in cheaper mode
--cheaper-algo — choose which algorithm gets used for adaptive process spawning
--cheaper-step — how many additional processes to spawn at each overload
--cheaper-overload — increase workers after the specified overload
--cheaper-algo-list — list the enabled cheapers algorithms
--cheaper-algos-list — list the enabled cheapers algorithms 🌈
--cheaper-list — list the enabled cheapers algorithms (yes, all three names, we love a triple threat)
--cheaper-rss-limit-soft — don't spawn new workers if the total resident memory usage of all workers is higher than this limit
--cheaper-rss-limit-hard — if the total workers resident memory usage is higher, try to stop workers 🛑
--idle — set idle mode: put uWSGI into cheap mode after a period of inactivity
--die-on-idle — shut uWSGI down when it goes idle. dramatic exit, respect 💀
--mount — load an application under a mountpoint
--worker-mount — load an application under a mountpoint in the specified worker, or after workers spawn
--threads — run each worker in prethreaded mode with the number of threads you specify 🧵
--thread-stacksize — set threads stacksize
--threads-stacksize — set threads stacksize
--thread-stack-size — set threads stacksize
--threads-stack-size — set threads stacksize (four aliases, one destiny ✨)
--vhost — enable virtualhosting mode, based on the SERVER_NAME variable
--vhost-host — enable virtualhosting mode, based on the HTTP_HOST variable

routing time, bestie, this is where it gets fun 🛣️

--route — add a route
--route-host — add a route based on the 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 a condition
--route-if-not — add a route based on a condition, but the 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 the 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 a condition
--final-route-if-not — add a final route based on a 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 the 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 a condition
--error-route-if-not — add an error route based on a 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 the 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 a condition
--response-route-if-not — add a response route based on a condition, negate version 🙃
--response-route-run — always run the specified response route action
--router-list — list the enabled routers 📋
--routers-list — list the enabled routers (same, just plural-coded)

--error-page-403 — add an error page (html) for the managed 403 response 🚫
--error-page-404 — add an error page (html) for the managed 404 response 🫥
--error-page-500 — add an error page (html) for the 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 the websockets ping/pong subsystem
--websocket-pong-tolerance — set the tolerance (in seconds) of the websockets ping/pong subsystem
--websockets-max-size — set the max allowed size of websocket messages, in Kbytes. default is 1024 📦
--websocket-max-size — set the max allowed size of websocket messages, in Kbytes. default is 1024
--chunked-input-limit — set the max size of a chunked input part. default is 1MB, in bytes
--chunked-input-timeout — set the default timeout for chunked input ⏳
--clock — set a clock source 🕰️
--clock-list — list the enabled clocks
--clocks-list — list the enabled clocks (plural edition, iconic)
--add-header — automatically add HTTP headers to the response
--rem-header — automatically remove the specified HTTP header from the response
--del-header — automatically remove the specified HTTP header from the response ✂️
--collect-header — store the specified response header in a request var. syntax: header var 🎀
--response-header-collect — bestie, this one stashes a response header into a request var 💾 syntax is header var — header first, var second, don't flip them or it's giving chaos.
--pull-header — same idea but feral: it stores the specified response header in a request var AND yoinks it out of the response entirely 😭 syntax again is header var.
--check-static — go look for static files in the directory you name. that's it, that's the whole vibe 🎀
--check-static-docroot — same energy but it checks the requested DOCUMENT_ROOT instead of a dir you picked ✨
--static-check — literally the twin of --check-static: check for static files in the specified directory 🦋
--static-map — maps a mountpoint to a static directory (or a file) 🗺️ iconic.
--static-map2 — like --static-map except it completely appends the requested resource to the docroot. no cap, that's the difference 👑
--static-skip-ext — skips the extension you name from staticfile checks 🙈
--static-index — if someone requests a directory, go search for the file you specified 💅
--static-safe — if the file lives under the path you give, skip the security checks. yes, really, that's what it does 🫶
--static-cache-paths — drops resolved paths into the uWSGI cache for however many seconds you say ⏱️
--static-cache-paths-name — use the cache you name for those static paths 🧺
--mimefile — sets the mime types file path, and the default is /etc/mime.types 📄
--mime-file — same thing, different spelling, default still /etc/mime.types 📄
--static-expires-type — sets the Expires header based on content type ⏳
--static-expires-type-mtime — sets the Expires header based on content type and the file mtime 🔥
--static-expires — sets the Expires header based on a filename regexp 🧚
--static-expires-mtime — Expires header based on filename regexp and file mtime, the deluxe combo ✨
--static-expires-uri — sets the Expires header based on a REQUEST_URI regexp 🌈
--static-expires-uri-mtime — Expires header based on REQUEST_URI regexp and file mtime 💖
--static-expires-path-info — sets the Expires header based on a PATH_INFO regexp 🌸
--static-expires-path-info-mtime — Expires header based on PATH_INFO regexp and file mtime, yes the pattern continues and yes we love consistency ⭐
--static-gzip — if the regexp you supply matches the static file translation, it goes looking for a gzip version 🗜️
--static-gzip-all — checks for a gzip version of all requested static files. all of them. every single one 💀
--static-gzip-dir — checks for a gzip version of all requested static files in the dir/prefix you specify 📁
--static-gzip-prefix — same deal: checks for a gzip version of all requested static files in the specified dir/prefix 📁
--static-gzip-ext — checks for a gzip version of all requested static files with the ext/suffix you give 🔖
--static-gzip-suffix — again, twin behavior: checks for a gzip version of all requested static files with the specified ext/suffix 🔖
--honour-range — turns on support for the HTTP Range header 📏
--offload-threads — sets how many offload threads to spawn — that's per-worker, and the default is 0 🧵
--offload-thread — the singular spelling of the exact same thing: offload threads to spawn, per-worker, default 0 🧵
--file-serve-mode — sets the static file serving mode 🍽️
--fileserve-mode — also sets the static file serving mode. same setting, no space in the name 🍽️
--disable-sendfile — kills sendfile() and makes you rely on the boring old read()/write() instead 😴
--check-cache — checks for response data in the cache you specify — leave it empty for the default cache 🗄️
--close-on-exec — sets close-on-exec on connection sockets. could be required if you're spawning processes in requests 👶
--close-on-exec2 — sets close-on-exec on server sockets. also possibly required for spawning processes in requests 👶
--mode — set uWSGI custom mode 🎛️
--env — set environment variable 🌱
--envdir — loads a daemontools compatible envdir 📂
--early-envdir — loads a daemontools compatible envdir ASAP, no waiting around ⚡
--unenv — unset environment variable 🚫
--vacuum — tries to remove all of the generated file/sockets 🧹 spring cleaning fr fr
--file-write — writes the content you specify to the file you specify (syntax: file=value) before privileges drop ⚠️ order matters here bestie.
--cgroup — puts the processes in the cgroup you name 🪆
--cgroup-opt — set value in specified cgroup option ⚙️
--cgroup-dir-mode — sets permission for the cgroup directory, and the default is 700 🔐
--namespace — run in a new namespace under the specified rootfs 🫧
--namespace-keep-mount — keeps the mountpoint you specify 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 — enables PROXY1 protocol support, and heads up: it's only for http parsers 📨
--reuse-port — enables the REUSE_PORT flag on the socket, and that's BSD only 🐡
--tcp-fast-open — enables the TCP_FASTOPEN flag on TCP sockets with the qlen value you specify 🚀
--tcp-fastopen — enables the TCP_FASTOPEN flag on TCP sockets with the specified qlen value 🚀
--tcp-fast-open-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if it's supported 🏎️
--tcp-fastopen-client — same: uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported 🏎️
--zerg — attach to a zerg server 🐛
--zerg-fallback — fall back to normal sockets if the zerg server isn't available 🪂
--zerg-server — enable the zerg server on the UNIX socket you specify 🐛
--cron — add a cron task ⏰
--cron2 — add a cron task with key=val syntax 🔑
--unique-cron — add a unique cron task 🌟
--cron-harakiri — sets the maximum time in seconds we wait for a cron command to complete ⌛
--legion-cron — adds a cron task that's runnable only when the instance is a lord of the specified legion 👑
--cron-legion — adds a cron task runnable only when the instance is a lord of the specified legion 👑
--unique-legion-cron — adds a unique cron task runnable only when the instance is a lord of the specified legion 🌟👑
--unique-cron-legion — adds a unique cron task runnable only when the instance is a lord of the specified legion 🌟👑
--loop — select the uWSGI loop engine 🔁
--loop-list — lists enabled loop engines 📋
--loops-list — lists enabled loop engines 📋
--worker-exec — run the command you specify as a worker 🏃
--worker-exec2 — run the specified command as worker, but this time after the post_fork hook 🪝
--attach-daemon — attaches a command/daemon to the master process, and important: the command has to not go in the background ⚠️
--attach-control-daemon — attaches a command/daemon to the master process (again, the command has to not go in background), and when the daemon dies, the master dies too 💀 lowkey dramatic but that's the deal.
--smart-attach-daemon — attaches a command/daemon to the master process managed by a pidfile, and here the command has to daemonize 🧠
--smart-attach-daemon2 — attaches a command/daemon to the master process managed by a pidfile, and here the command has to NOT daemonize 🧠
--legion-attach-daemon — same as --attach-daemon but the daemon runs only on the legion lord node 👑
--legion-smart-attach-daemon — same as --smart-attach-daemon but the daemon runs only on the legion lord node 👑
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2 but the daemon runs only on the legion lord node 👑
--daemons-honour-stdin — do not change the stdin of external daemons to /dev/null 🙅
--attach-daemon2 — the attach-daemon keyval variant, and yep it supports smart modes too 🔑
--plugins — load uWSGI plugins 🧩
--plugin — load uWSGI plugins 🧩
--need-plugins — load uWSGI plugins and exit on error 🚪
--need-plugin — load uWSGI plugins, exit on error 🚪
--plugins-dir — adds a directory to the uWSGI plugin search path 🔍
--plugin-dir — adds a directory to the uWSGI plugin search path 🔍
--plugins-list — lists enabled plugins 📋
--plugin-list — lists enabled plugins 📋
--autoload — tries to automatically load plugins when unknown options are found 🪄
--dlopen — blindly loads a shared library 🙈 no thoughts, just vibes.
--allowed-modifiers — comma separated list of allowed modifiers ✅
--remap-modifier — remaps a request modifier from one id to another 🔀
--dump-options — dumps the full list of available options 🗃️
--show-config — shows the current config reformatted as ini 📜
--binary-append-data — returns the content of a resource to stdout for appending to a uwsgi binary (for data:// usage) 📎
--print — simple print 🖨️
--iprint — simple print, but the immediate version ⚡
--exit — force exit() of the instance 🚪
--cflags — reports uWSGI CFLAGS, which is useful for building external plugins 🛠️
--dot-h — dumps the uwsgi.h used for building the core, useful for building external plugins 📦
--config-py — dumps the uwsgiconfig.py used for building the core, also useful for building external plugins 🐍
--build-plugin — builds a uWSGI plugin for the current binary 🔨
--version — prints the uWSGI version 🏷️
--response-headers-limit — sets the response header maximum size, default: 64k 📏
--wsgi-file — load a .wsgi file 🐍
--file — load a .wsgi file 🐍
--eval — eval python code 🧪
-w|--module — load a WSGI module 📦
-w|--wsgi — load a WSGI module 📦
--callable — set the 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 — adds a directory (or glob) to pythonpath 🛤️
--python-path — adds a directory (or glob) to pythonpath 🛤️
--pp — adds a directory (or glob) to pythonpath 🛤️
--pymodule-alias — add a python alias module 🪞
--post-pymodule-alias — adds 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 (yep, same vibe, different spelling, bestie)
--spooler-py-import — import a python module in the spooler (another alias, they really said “let me give you options”)
--spooler-python-import — import a python module in the spooler (the last of the spooler-import quadruplets)
--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 🐍

that's the whole manual page, bestie! this was UWSGI_PYTHON311(1) from uwsgi_python311 version 2.0.21-debian, dated May 2023. go forth and slay your python web apps 💅✨

📦 where this page comes from

debian bookworm: uwsgi-plugin-python3 2.0.21-5.1 · GPL-2.0-only
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-18: a language model's rewrite of the original, under its terms