UWSGI_PYTHON312(1)

📦 version 2.0.24, in ubuntu noble

✨ uwsgi_python312 ✨

okay bestie, gather round, because this is the manual page for uwsgi_python312 — a fast (pure C), self-healing, developer-friendly WSGI server. yes. all of that. at once. it's giving main character energy and it hasn't even started talking yet 💅

💖 NAME 💖

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

🦋 SYNOPSIS 🦋

uwsgi-core-local [options...]

🎀 DESCRIPTION 🎀

so like, this is a long list of options and I'm not skipping a single one, because you deserve the whole thing, periodt. let's go 🌈

🔌 sockets & protocols 🔌

-s, --socket — bind to the specified UNIX/TCP socket using default protocol
-s, --uwsgi-socket — bind to the specified UNIX/TCP socket using uwsgi protocol
--suwsgi-socket — bind to the specified UNIX/TCP socket using uwsgi protocol over SSL
--ssl-socket — bind to the specified UNIX/TCP socket using uwsgi protocol over SSL
--http-socket — bind to the specified UNIX/TCP socket using HTTP protocol
--http-socket-modifier1 — force the specified modifier1 when using HTTP protocol
--http-socket-modifier2 — force the specified modifier2 when using HTTP protocol
--http11-socket — bind to the specified UNIX/TCP socket using HTTP 1.1 (Keep-Alive) protocol
--https-socket — bind to the specified UNIX/TCP socket using HTTPS protocol
--https-socket-modifier1 — force the specified modifier1 when using HTTPS protocol
--https-socket-modifier2 — force the specified modifier2 when using HTTPS protocol
--fastcgi-socket — bind to the specified UNIX/TCP socket using FastCGI protocol
--fastcgi-nph-socket — bind to the specified UNIX/TCP socket using FastCGI protocol (nph mode)
--fastcgi-modifier1 — force the specified modifier1 when using FastCGI protocol
--fastcgi-modifier2 — force the specified modifier2 when using FastCGI protocol
--scgi-socket — bind to the specified UNIX/TCP socket using SCGI protocol
--scgi-nph-socket — bind to the specified UNIX/TCP socket using SCGI protocol (nph mode)
--scgi-modifier1 — force the specified modifier1 when using SCGI protocol
--scgi-modifier2 — force the specified modifier2 when using SCGI protocol
--raw-socket — bind to the specified UNIX/TCP socket using RAW protocol
--raw-modifier1 — force the specified modifier1 when using RAW protocol
--raw-modifier2 — force the specified modifier2 when using RAW protocol
--puwsgi-socket — bind to the specified UNIX/TCP socket using persistent uwsgi protocol (puwsgi)
--protocol — force the specified protocol for default sockets
--socket-protocol — force the specified protocol for default sockets
--shared-socket — create a shared socket for advanced jailing or ipc
--undeferred-shared-socket — create a shared socket for advanced jailing or ipc (undeferred mode)

👯 workers, timeouts & 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-graceful-timeout — interval between graceful harakiri attempt and a sigkill
--harakiri-graceful-signal — use this signal instead of sigterm for graceful harakiri attempts
--harakiri-queue-threshold — only trigger harakiri if queue is greater than this threshold
--harakiri-no-arh — do not enable harakiri during after-request-hook
--no-harakiri-arh — do not enable harakiri during after-request-hook
--no-harakiri-after-req-hook — do not enable harakiri during after-request-hook
--backtrace-depth — set backtrace depth
--mule-harakiri — set harakiri timeout for mule tasks

📜 configs & options magic 📜

-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 & error handling 🚦

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

🧩 templating & includes 🧩

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

🛠️ instance management 🛠️

-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 & internals ⚙️

-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

💫 process names & master 💫

--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 (yes, it's literally called that) 👑

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

and that's just part one bestie, hold on, more is coming 💖

--emperor-tyrant — puts the Emperor in Tyrant mode 👑💅
--emperor-tyrant-nofollow — when checking for uid/gid in Tyrant mode, do not follow symlinks 🚫🔗
--emperor-stats — runs the Emperor stats server 📊✨
--emperor-stats-server — runs the Emperor stats server 📊✨ (same vibe, different flag name, bestie)
--early-emperor — spawns the emperor as soon as possible 🏃‍♀️💨
--emperor-broodlord — runs the emperor in BroodLord mode 🦇👑
--emperor-throttle — sets throttling level (in milliseconds) for bad behaving vassals (default 1000) 😤⏱️
--emperor-max-throttle — sets max throttling level (in milliseconds) for bad behaving vassals (default 3 minutes) 🚨⏳
--emperor-magic-exec — prefixes vassals config files with exec:// if they have the executable bit 🪄✨
--emperor-on-demand-extension — searches for a text file (vassal name + extension) containing the on demand socket name 🔍📄
--emperor-on-demand-ext — searches for a text file (vassal name + extension) containing the on demand socket name 🔍📄 (same thing, shorter name, slay)
--emperor-on-demand-directory — enables on demand mode binding to the unix socket in the specified directory named like the vassal + .socket 📁🔌
--emperor-on-demand-dir — enables on demand mode binding to the unix socket in the specified directory named like the vassal + .socket 📁🔌 (yep, the alias)
--emperor-on-demand-exec — uses 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) 🗂️✨ (alias energy)
--emperor-no-blacklist — disables the Emperor blacklisting subsystem 🚫📝
--emperor-use-clone — uses clone() instead of fork() passing the specified unshare() flags 🧬🔀
--emperor-graceful-shutdown — uses vassals graceful shutdown during ragnarok 🌅🛑
--emperor-cap — sets vassals capability 🎚️🔐
--vassals-cap — sets vassals capability 🎚️🔐
--vassal-cap — sets vassals capability 🎚️🔐
--imperial-monitor-list — lists enabled imperial monitors 📋👀
--imperial-monitors-list — lists enabled imperial monitors 📋👀 (plural, same vibe)
--vassals-inherit — adds config templates to vassals config (uses --inherit) 📝🔗
--vassals-include — includes config templates to vassals config (uses --include instead of --inherit) 📝🔗
--vassals-inherit-before — adds config templates to vassals config (uses --inherit, parses before the vassal file) 📝⏪
--vassals-include-before — includes config templates to vassals config (uses --include instead of --inherit, parses before the vassal file) 📝⏪
--vassals-start-hook — runs the specified command before each vassal starts 🏁🏃‍♀️
--vassals-stop-hook — runs the specified command after vassal's death 💀🛑
--vassal-sos — asks emperor for reinforcement when overloaded 🆘👑
--vassal-sos-backlog — asks emperor for SOS if backlog queue has more items than the value specified 📬🆘
--vassals-set — automatically sets the specified option (via --set) for every vassal ⚙️✨
--vassal-set — automatically sets the specified option (via --set) for every vassal ⚙️✨
--heartbeat — announces healthiness to the emperor 💓👑
--reload-mercy — sets the maximum time (in seconds) we wait for workers and other processes to die during reload/shutdown ⏳💀
--worker-reload-mercy — sets the maximum time (in seconds) a worker can take to reload/shutdown (default is 60) ⏳👷
--mule-reload-mercy — sets the maximum time (in seconds) a mule can take to reload/shutdown (default is 60) ⏳🐴
--exit-on-reload — forces exit even if a reload is requested 🚪🚫
--die-on-term — exits instead of brutal reload on SIGTERM 💀📉
--force-gateway — forces the spawn of the first registered gateway without a master 🚪⚡
-h|--help — shows this help 🙋‍♀️✨
-h|--usage — shows this help 🙋‍♀️✨
--print-sym — prints content of the specified binary symbol 🖨️🔣
--print-symbol — prints content of the specified binary symbol 🖨️🔣
-r|--reaper — calls waitpid(-1,...) after each request to get rid of zombies 🧟‍♀️🔪
-R|--max-requests — reloads 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 — reloads workers after the specified amount of seconds (default is disabled) ⏱️🚫
--max-worker-lifetime-delta — adds (worker_id * delta) seconds to the max_worker_lifetime value of each worker ➕⏱️
-z|--socket-timeout — sets internal sockets timeout ⏱️🔌
--no-fd-passing — disables file descriptor passing 🚫📁
--locks — creates the specified number of shared locks 🔒🔢
--lock-engine — sets the lock engine ⚙️🔒
--ftok — sets the ipcsem key via ftok() for avoiding duplicates 🔑📝
--persistent-ipcsem — does not remove ipcsem's on shutdown 🚫🗑️
-A|--sharedarea — creates a raw shared memory area of specified pages (note: it supports keyval too) 🧠✨
--safe-fd — does not close the specified file descriptor 🚫🔒
--fd-safe — does not close the specified file descriptor 🚫🔒
--cache — creates a shared cache containing given elements 🗃️✨
--cache-blocksize — sets cache blocksize 📦🔢
--cache-store — enables persistent cache to disk 💾🗃️
--cache-store-sync — sets frequency of sync for persistent cache 🔄💾
--cache-no-expire — disables auto sweep of expired items 🚫🧹
--cache-expire-freq — sets the frequency of cache sweeper scans (default 3 seconds) ⏱️🧹
--cache-report-freed-items — constantly reports the cache item freed by the sweeper (use only for debug) 📢🐛
--cache-udp-server — binds the cache udp server (used only for set/update/delete) to the specified socket 🔌📡
--cache-udp-node — sends cache update/deletion to the specified cache udp server 📡🗑️
--cache-sync — copies the whole content of another uWSGI cache server on server startup 🔄🗃️
--cache-use-last-modified — updates last_modified_at timestamp on every cache item modification (default is disabled) ⏱️✏️
--add-cache-item — adds an item in the cache ➕🗃️
--load-file-in-cache — loads a static file in the cache 📂🗃️
--load-file-in-cache-gzip — loads a static file in the cache with gzip compression 🗜️📂
--cache2 — creates a new generation shared cache (keyval syntax) 🆕🗃️
--queue — enables shared queue 📬✨
--queue-blocksize — sets queue blocksize 📦🔢
--queue-store — enables persistent queue to disk 💾📬
--queue-store-sync — sets frequency of sync for persistent queue 🔄💾
-Q|--spooler — runs a spooler on the specified directory 📂🔄
--spooler-external — maps spoolers requests to a spooler directory managed by an external instance 🔗📂
--spooler-ordered — tries to order the execution of spooler tasks 🔢🔄
--spooler-chdir — chdir() to specified directory before each spooler task 📁🔄
--spooler-processes — sets the number of processes for spoolers 🔢👷
--spooler-quiet — does not be verbose with spooler tasks 🤫🔄
--spooler-max-tasks — sets the maximum number of tasks to run before recycling a spooler 🔄♻️
--spooler-harakiri — sets harakiri timeout for spooler tasks ⏱️🗡️
--spooler-frequency — sets spooler frequency ⏱️🔄
--spooler-freq — sets spooler frequency ⏱️🔄
--mule — adds a mule 🐴✨
--mules — adds the specified number of mules 🐴🐴🐴
--farm — adds a mule farm 🚜🐴
--mule-msg-size — sets mule message buffer size 📏🐴
--signal — sends a uwsgi signal to a server 📡✨
--signal-bufsize — sets buffer size for signal queue 📏📡
--signals-bufsize — sets buffer size for signal queue 📏📡
--signal-timer — adds a timer (syntax: <signal> <seconds>) ⏲️✨
--timer — adds a timer (syntax: <signal> <seconds>) ⏲️✨
--signal-rbtimer — adds a redblack timer (syntax: <signal> <seconds>) ⏲️🌳
--rbtimer — adds a redblack timer (syntax: <signal> <seconds>) ⏲️🌳
--rpc-max — maximum number of rpc slots (default: 64) 📞🔢
-L|--disable-logging — disables request logging 🚫📝
--flock — locks the specified file before starting, exits if locked 🔒🚪
--flock-wait — locks the specified file before starting, waits if locked 🔒⏳
--flock2 — locks the specified file after logging/daemon setup, exits if locked 🔒🚪
--flock-wait2 — locks the specified file after logging/daemon setup, waits if locked 🔒⏳
--pidfile — creates pidfile (before privileges drop) 📝🆔
--pidfile2 — creates pidfile (after privileges drop) 📝🆔
--safe-pidfile — creates safe pidfile (before privileges drop) 📝🔒
--safe-pidfile2 — creates safe pidfile (after privileges drop) 📝🔒
--chroot — chroot() to the specified directory 🏠🔒
--pivot-root — pivot_root() to the specified directories (new_root and put_old must be separated with a space) 🔄📁
--pivot_root — pivot_root() to the specified directories (new_root and put_old must be separated with a space) 🔄📁
--uid — setuid to the specified user/uid 👤🔑
--gid — setgid to the specified group/gid 👥🔑
--add-gid — adds 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 — disables additional groups set via initgroups() 🚫👥
--cap — sets process capability 🎚️🔐
--unshare — unshare() part of the processes and puts it in a new namespace 🌐🔀
--unshare2 — unshare() part of the processes and puts it in a new namespace after rootfs change 🌐🔀
--setns-socket — exposes a unix socket returning namespace fds from /proc/self/ns 🔌📁
--setns-socket-skip — skips the specified entry when sending setns file descriptors ⏭️📁
--setns-skip — skips the specified entry when sending setns file descriptors ⏭️📁
--setns — joins a namespace created by an external uWSGI instance 🔗🌐
--setns-preopen — opens /proc/self/ns as soon as possible and caches fds 🚀📁
--jailed — marks the instance as jailed (forces the execution of post_jail hooks) 🏷️🔒
--refork — fork() again after privileges drop. super useful for jailing systems, no cap 🫶
--re-fork — same vibe as --refork: fork() again after privileges drop. jailing systems love it 🦋
--refork-as-root — fork() again before privileges drop. still for jailing systems, bestie ✨
--re-fork-as-root — yep, another alias: fork() again before privileges drop. jailing systems, you know the drill 💜
--refork-post-jail — fork() again after jailing. jailing systems stay winning 🌸
--re-fork-post-jail — same as --refork-post-jail: fork() again after jailing. for jailing systems, fr fr 🍓
--hook-asap — run the hook you specified as soon as possible. like, immediately, bestie ⚡
--hook-pre-jail — run that hook before jailing. prep time, periodt 💅
--hook-post-jail — run that hook after jailing. clean up after yourself, queen 👑
--hook-in-jail — run that hook in jail after initialization. jail time but make it productive 😭
--hook-as-root — run that hook before privileges drop. root energy, but careful 🔥
--hook-as-user — run that hook after privileges drop. user vibes only 🫶
--hook-as-user-atexit — run that hook before app exit and reload. last words, bestie 💀
--hook-pre-app — run that hook before app loading. get ready for the main character ✨
--hook-post-app — run that hook after app loading. app is up, celebrate 🎀
--hook-post-fork — run that hook after each fork. every single time, no skips 🌈
--hook-accepting — run that hook after each worker enters the accepting phase. accepting era begins 💖
--hook-accepting1 — run that hook after the first worker enters the accepting phase. first one to the party 🎉
--hook-accepting-once — run that hook after each worker enters the accepting phase, but only once per-instance. special occasion vibes 🥳
--hook-accepting1-once — run that hook after the first worker enters the accepting phase, once per instance. one and done, bestie 💅
--hook-master-start — run that hook when the Master starts. the boss is here 👑
--hook-touch — run that hook when the specified file is touched. syntax: <file> <action>. touch grass? no, touch file 🌱
--hook-emperor-start — run that hook when the Emperor starts. all hail the emperor 🦋
--hook-emperor-stop — run that hook when the Emperor sends a stop message. stopping the empire, dramatic 😭
--hook-emperor-reload — run that hook when the Emperor sends a reload message. reload the empire, slay 💅
--hook-emperor-lost — run that hook when the Emperor connection is lost. gone but not forgotten 🕊️
--hook-as-vassal — run that hook before exec()ing the vassal. vassal prep, periodt ✨
--hook-as-emperor — run that hook in the emperor after the vassal has been started. emperor watching over, iconic 👑
--hook-as-mule — run that hook in each mule. mule squad, assemble 🐴
--hook-as-gateway — run that hook in each gateway. gateway gang, rise up 🌈
--after-request-hook — run the specified function/symbol after each request. aftercare, bestie 💖
--after-request-call — same as --after-request-hook: run that function/symbol after each request. you know the vibe 🫶
--exec-asap — run the specified command as soon as possible. ASAP, no waiting ⚡
--exec-pre-jail — run that command before jailing. prep work, queen 💅
--exec-post-jail — run that command after jailing. post-jail clarity ✨
--exec-in-jail — run that command in jail after initialization. jailhouse rock 🎸
--exec-as-root — run that command before privileges drop. root access, careful 🔥
--exec-as-user — run that command after privileges drop. user mode activated 🫶
--exec-as-user-atexit — run that command before app exit and reload. exit interview, bestie 💀
--exec-pre-app — run that command before app loading. pre-game, let's go 🎀
--exec-post-app — run that command after app loading. app is live, celebrate 🎉
--exec-as-vassal — run that command before exec()ing the vassal. vassal business, fr fr 🦋
--exec-as-emperor — run that command in the emperor after the vassal has been started. emperor's orders 👑
--mount-asap — mount filesystem as soon as possible. ASAP mounting, bestie ⚡
--mount-pre-jail — mount filesystem before jailing. prep the mount 🌸
--mount-post-jail — mount filesystem after jailing. post-jail mount, slay 💅
--mount-in-jail — mount filesystem in jail after initialization. jail mount, iconic ✨
--mount-as-root — mount filesystem before privileges drop. root mount, careful 🔥
--mount-as-vassal — mount filesystem before exec()ing the vassal. vassal mount, periodt 🦋
--mount-as-emperor — mount filesystem in the emperor after the vassal has been started. emperor mount 👑
--umount-asap — unmount filesystem as soon as possible. bye-bye mount, ASAP ⚡
--umount-pre-jail — unmount filesystem before jailing. clean up before jail 🌸
--umount-post-jail — unmount filesystem after jailing. post-jail cleanup, bestie 💅
--umount-in-jail — unmount filesystem in jail after initialization. jail unmount, fr fr ✨
--umount-as-root — unmount filesystem before privileges drop. root unmount, careful 🔥
--umount-as-vassal — unmount filesystem before exec()ing the vassal. vassal unmount, periodt 🦋
--umount-as-emperor — unmount filesystem in the emperor after the vassal has been started. emperor unmount 👑
--wait-for-interface — wait for the specified network interface to come up before running root hooks. patience, bestie 🧘
--wait-for-interface-timeout — set the timeout for --wait-for-interface. don't wait forever ⏳
--wait-interface — same as --wait-for-interface: wait for that network interface before running root hooks. waiting era 🌈
--wait-interface-timeout — set the timeout for --wait-for-interface (the alias version). time's up ⏰
--wait-for-iface — wait for the specified network interface to come up before running root hooks. iface vibes 🫶
--wait-for-iface-timeout — set the timeout for --wait-for-interface (iface edition). tick tock ⏳
--wait-iface — wait for the specified network interface to come up before running root hooks. iface, iface, baby 🎀
--wait-iface-timeout — set the timeout for --wait-for-interface (the iface alias). timeout, bestie ⏰
--wait-for-fs — wait for the specified filesystem item to appear before running root hooks. filesystem waiting game 🌸
--wait-for-file — wait for the specified file to appear before running root hooks. file, where you at? 💅
--wait-for-dir — wait for the specified directory to appear before running root hooks. directory, show up ✨
--wait-for-mountpoint — wait for the specified mountpoint to appear before running root hooks. mountpoint, please 🥺
--wait-for-fs-timeout — set the timeout for --wait-for-fs/file/dir. timeout for the waiting game ⏳
--wait-for-socket — wait for the specified socket to be ready before loading apps. socket, are you there? 🔌
--wait-for-socket-timeout — set the timeout for --wait-for-socket. socket timeout, bestie ⏰
--call-asap — call the specified function as soon as possible. ring ring, ASAP 📞
--call-pre-jail — call that function before jailing. pre-jail call 💖
--call-post-jail — call that function after jailing. post-jail call, slay 💅
--call-in-jail — call that function in jail after initialization. jail call, iconic ✨
--call-as-root — call that function before privileges drop. root call, careful 🔥
--call-as-user — call that function after privileges drop. user call, periodt 🫶
--call-as-user-atexit — call that function before app exit and reload. last call, bestie 💀
--call-pre-app — call that function before app loading. pre-app call, get ready 🎀
--call-post-app — call that function after app loading. app loaded, call made 🎉
--call-as-vassal — call the specified function() before exec()ing the vassal. vassal call, fr fr 🦋
--call-as-vassal1 — call the specified function(char *) before exec()ing the vassal. vassal call with a char pointer, fancy 💅
--call-as-vassal3 — call the specified function(char *, uid_t, gid_t) before exec()ing the vassal. vassal call with all the args, periodt ✨
--call-as-emperor — call the specified function() in the emperor after the vassal has been started. emperor call 👑
--call-as-emperor1 — call the specified function(char *) in the emperor after the vassal has been started. emperor call with a string, slay 💅
--call-as-emperor2 — call the specified function(char *, pid_t) in the emperor after the vassal has been started. emperor call with pid, iconic 🦋
--call-as-emperor4 — call the specified function(char *, pid_t, uid_t, gid_t) in the emperor after the vassal has been started. emperor call with everything, periodt 👑
--ini — load config from an ini file. old school but valid 💅
-y|--yaml — load config from a yaml file. yaml era, bestie ✨
-y|--yml — same as -y|--yaml: load config from a yaml file. yml, yaml, same vibe 🫶
-j|--json — load config from a json file. json, iconic 💖
-j|--js — same as -j|--json: load config from a json file. js, json, whatever 🌈
--weight — weight of the instance. used by clustering/lb/subscriptions. put some weight on it 💪
--auto-weight — set weight of the instance automatically. used by clustering/lb/subscriptions. auto-weight, slay ✨
--no-server — force no-server mode. no server, no problem 🙈
--command-mode — force command mode. command mode activated 💅
--no-defer-accept — disable deferred-accept on sockets. no deferring, bestie 🚫
--tcp-nodelay — enable TCP NODELAY on each request. no delay, we move fast ⚡
--so-keepalive — enable TCP KEEPALIVEs. keep it alive, periodt 🫶
--so-send-timeout — set SO_SNDTIMEO. send timeout, fr fr ⏰
--socket-send-timeout — set SO_SNDTIMEO. same as above, socket send timeout 💅
--so-write-timeout — set SO_SNDTIMEO. write timeout, bestie ✨
--socket-write-timeout — set SO_SNDTIMEO. socket write timeout, you know the vibe 🦋
--socket-sndbuf — set SO_SNDBUF. socket send buffer, iconic 🌸
--socket-rcvbuf — set SO_RCVBUF. socket receive buffer, slay 💖
--shutdown-sockets — force calling shutdown() in addition to close() when sockets are destroyed. shutdown and close, double trouble 💀
--limit-as — limit processes address space/vsz. keep it in check, bestie 📏
--limit-nproc — limit the number of spawnable processes. nproc limit, periodt 🚫
--reload-on-as — reload if address space is higher than specified megabytes. too much space, reload time 🔄
--reload-on-rss — reload if rss memory is higher than specified megabytes. rss too high, reload, slay 💅
--evil-reload-on-as — force the master to reload a worker if its address space is higher than specified megabytes. evil reload, dramatic 😈
--evil-reload-on-rss — force the master to reload a worker if its rss memory is higher than specified megabytes. evil rss reload, iconic 🔥
--mem-collector-freq — set the memory collector frequency when evil reloads are in place. collect that memory, bestie 🧹
--reload-on-fd — reload if the specified file descriptor is ready. fd ready, reload, periodt 🔄
--brutal-reload-on-fd — brutal reload if the specified file descriptor is ready. brutal, no mercy 💀
--ksm — enable Linux KSM. KSM, slay 🐧
--pcre-jit — enable pcre jit (if available). jit, if you can, bestie ✨
--never-swap — lock all memory pages avoiding swapping. no swap, no cap 🔒
--touch-reload — reload uWSGI if the specified file is modified/touched. touch it, reload it 💅
--touch-workers-reload — trigger reload of (only) workers if the specified file is modified/touched. workers only, periodt 🫶
--touch-mules-reload — reload mules if the specified file is modified/touched. mules reload, iconic 🐴
--touch-spoolers-reload — reload spoolers if the specified file is modified/touched. spoolers reload, slay ✨
--touch-chain-reload — trigger chain reload if the specified file is modified/touched. chain reaction, bestie ⛓️
--touch-logrotate — trigger logrotation if the specified file is modified/touched. logrotate, touch it 🔄
--touch-logreopen — trigger log reopen if the specified file is modified/touched. reopen those logs, periodt 📂
--touch-exec — run command when the specified file is modified/touched. syntax: file command. touch and run, iconic 💅
--touch-signal — signal when the specified file is modified/touched. syntax: file signal. touch and signal, slay 🚦
--fs-reload — bestie, this one watches a filesystem object and does a graceful reload the moment it gets modified. soft reset energy. 🦋
--fs-brutal-reload — same vibe check, but the reload is brutal instead of graceful. no chill. 💀
--fs-signal — when that filesystem object changes, it raises a uwsgi signal. syntax: file signal. very "text me when you're done" of it. ✨
--check-mountpoint — if a filesystem is no more reachable, this destroys the instance. it's giving reliable Fuse management, fr fr.
--mountpoint-check — literally the same thing as --check-mountpoint: destroy the instance if a filesystem is no more reachable. useful for reliable Fuse management. twins. 👯
--check-mount — bestie it's the same again: destroy the instance if a filesystem is no more reachable. useful for reliable Fuse management. 💅
--mount-check — and again! destroy the instance if a filesystem is no more reachable. useful for reliable Fuse management. iconic quadruple threat. 👑
--propagate-touch — the over-engineering option for systems with flaky signal management. she's extra and she knows it. 🎀

--limit-post — limit the request body. that's it, that's the whole thing. 🍓
--no-orphans — automatically kill workers if the master dies. > heads up bestie: this can be dangerous for availability. so like, read the room before enabling it. 😭
--prio — set processes/threads priority. ⭐
--cpu-affinity — set cpu affinity. pin those threads down, periodt. 📌
--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 — sets the amount of allowed memory allocation (in megabytes) for the request body before it starts printing a warning. the gentle "girl... 👀" threshold.
--upload-progress — enable creation of .json files in the specified directory while a file upload is happening. progress updates, slay. ✨
--no-default-app — do not fallback to the default app. no safety net, we die like women. 💀
--manage-script-name — automatically rewrite SCRIPT_NAME and PATH_INFO. 🧚
--ignore-script-name — ignore SCRIPT_NAME. okay and? ignored. 🙈
--catch-exceptions — report the exception as http output. > bestie, this is discouraged — use it only for testing. do not ship this to prod i'm begging. 😭
--reload-on-exception — reload a worker whenever an exception is raised. spicy but valid. 🔥
--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. the full combo meal. 🍓
--exception-handler — add an exception handler. 🫶

--enable-metrics — enable the metrics subsystem. numbers girlies rise. 📊
--metric — add a custom metric. ✨
--metric-threshold — add a metric threshold/alarm. 🚨
--metric-alarm — add a metric threshold/alarm. same thing, different name, we love a repackage. 💅
--alarm-metric — add a metric threshold/alarm. third time's the charm bestie. 🎀
--metrics-dir — export metrics as text files to the specified directory. 🌸
--metrics-dir-restore — restore the last value taken from the metrics dir. memory unlocked. 🧠
--metric-dir — export metrics as text files to the specified directory. (yes this is the singular version, no we don't know why either, it's giving brand consistency) 🦋
--metric-dir-restore — restore the 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. same energy, different spelling. 💅
--stats-http — prefix the stats server json output with http headers. 🎀
--stats-minified — minify the statistics json output. skinny legend. 🌸
--stats-min — minify the statistics json output. her nickname. 🦋
--stats-push — push the stats json to the specified destination. yeet. 🚀
--stats-pusher-default-freq — set the default frequency of stats pushers. ⏰
--stats-pushers-default-freq — set the default frequency of stats pushers. (plural version, same deal) 💜
--stats-no-cores — disable generation of cores-related stats. 🚫
--stats-no-metrics — do not include metrics in the stats output. 🙈
--multicast — subscribe to the 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 — become a member of a legion. main character joining the group chat. 👑
--legion-mcast — become 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 the 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. dramatic exit, love that for her. 💀
--legion-skew-tolerance — set the clock skew tolerance of the 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 a new node joining the legion. 🫶
--legion-node-left — action to call on a node leaving the legion. 😭
--legion-quorum — set the quorum of a legion. 🔢
--legion-scroll — set the scroll of a legion. 📜
--legion-scroll-max-size — set the max size of the legion scroll buffer. 📏
--legion-scroll-list-max-size — set the max size of the legion scroll list buffer. 📐
--subscriptions-sign-check — set the digest algorithm and certificate directory for the secured subscription system. 🔐
--subscriptions-sign-check-tolerance — set the maximum tolerance (in seconds) of clock skew for the secured subscription system. ⏳
--subscriptions-sign-skip-uid — skip the 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 the load balancing algorithm for the subscription system. ⚖️
--subscription-dotsplit — try to fallback to the next part (dot based) in the 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. the glow-up sequel. 💅
--subscribe-freq — send a subscription announce at the specified interval. 📣
--subscription-tolerance — set tolerance for subscription servers. 💜
--unsubscribe-on-graceful-reload — force the unsubscribe request even during a graceful reload. no loose ends. 🧹
--start-unsubscribed — configure subscriptions but do not send them (useful with master fifo). lowkey lurking. 👀
--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. spill the tea, ssl. ☕
--ssl-verify-depth — set the maximum certificate verification depth. 📚
--sni — add an SNI-governed SSL context. 🎀
--sni-dir — check for cert/key/client_ca files in the specified directory and create an sni/ssl context on demand. 🪄
--sni-dir-ciphers — set ssl ciphers for the sni-dir option. 🔒
--ssl-enable3 — enable SSLv3. > bestie this is insecure. like, genuinely. 😭
--ssl-enable-sslv3 — enable SSLv3. > also insecure. same warning, different flag name. 💀
--ssl-enable-tlsv1 — enable TLSv1. > insecure bestie. why are we here. 🙈
--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. nap time, but make it a crisis. 😴
--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 the specified number of cores. ⚡
--max-fd — set the maximum number of file descriptors. > requires root privileges bestie, don't forget. 👑
--logto — set logfile/udp address. 📝
--logto2 — log to the specified file or udp address after privileges drop. 🪂
--log-format — set an advanced format for request logging. 🎨
--logformat — set an advanced format for request logging. same thing, no dash, still iconic. ✨
--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. her other name. 🎀
--logger — set/append a logger. 📋
--logger-list — list enabled loggers. 🗒️
--loggers-list — list enabled loggers. plural, same list. 🌸
--threaded-logger — offload log writing to a thread. multitasking queen. 🧵
--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. blocked. 🚫
--log-filter — show only log lines matching the specified regexp. the opposite of draining, bestie. 🔍
--log-route — log to the specified named logger if the regexp applied on the logline matches. 🚦
--log-req-route — log requests to the specified named logger if the regexp applied on the logline matches. 🚦
--use-abort — call abort() on segfault/fpe, which could be useful for generating a core dump. 💥
--alarm — create a new alarm. syntax: <alarm> <plugin:args>. ⏰
--alarm-cheap — use the main alarm thread rather than creating dedicated threads for curl-based alarms. budget-friendly alarm. 💸

okay we're still deep in the flags bestie, buckle up, this stretch is long but every single one of these is real and they all matter 💖

--alarm-freq — tunes the anti-loop alarm system (default 3 seconds) so it's not out here screaming at you constantly ✨
--alarm-fd — raises the specified alarm when an fd gets read (by default it reads 1 byte, set it to 8 for eventfd) 🎀
--alarm-segfault — raises the specified alarm when the segmentation fault handler fires 💀
--segfault-alarm — same thing, raises the specified alarm when the segmentation fault handler runs
--alarm-backlog — raises the specified alarm when the socket backlog queue is full 😭
--backlog-alarm — raises the specified alarm when the socket backlog queue is full
--lq-alarm — raises the specified alarm when the socket backlog queue is full
--alarm-lq — raises the specified alarm when the socket backlog queue is full
--alarm-listen-queue — raises the specified alarm when the socket backlog queue is full
--listen-queue-alarm — raises the specified alarm when the socket backlog queue is full
--log-alarm — raises the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp> 🔥
--alarm-log — raises the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp>
--not-log-alarm — skips the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp> 🙈
--not-alarm-log — skips the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp>
--alarm-list — lists enabled alarms 👑
--alarms-list — lists enabled alarms
--alarm-msg-size — sets the max size of an alarm message (default 8192) ✨
--log-master — delegates logging to the master process 💅
--log-master-bufsize — sets the buffer size for the master logger; bigger log messages get truncated ✂️
--log-master-stream — creates the master logpipe as SOCK_STREAM 🌸
--log-master-req-stream — creates the master requests logpipe as SOCK_STREAM
--log-reopen — reopens the log after reload 🦋
--log-truncate — truncates the log on startup
--log-maxsize — sets the maximum logfile size
--log-backupname — sets the logfile name after rotation
--logdate — prefixes logs with a date or a strftime string 📅
--log-date — prefixes logs with a date or a strftime string
--log-prefix — prefixes logs with a string
--log-zero — logs responses without a body
--log-slow — logs requests slower than the specified number of milliseconds 🐢
--log-4xx — logs requests with a 4xx response
--log-5xx — logs requests with a 5xx response
--log-big — logs requests bigger than the specified size
--log-sendfile — logs sendfile requests
--log-ioerror — logs requests with io errors 💀
--log-micros — reports response time in microseconds instead of milliseconds ⏱️
--log-x-forwarded-for — uses the ip from the X-Forwarded-For header instead of REMOTE_ADDR 🌈
--master-as-root — leaves the master process running as root 👀
--drop-after-init — runs the privileges drop after plugin initialization, superseded by drop-after-apps
--drop-after-apps — runs the privileges drop after apps loading, superseded by master-as-root
--force-cwd — forces the initial working directory to the specified value
--binsh — overrides /bin/sh (used by exec hooks, it always falls back to /bin/sh) 🐚
--chdir — chdirs to the specified directory before apps loading
--chdir2 — chdirs to the specified directory after apps loading
--lazy — sets lazy mode (load apps in workers instead of master) 😴
--lazy-apps — loads apps in each worker instead of the master
--cheap — sets cheap mode (spawn workers only after the first request) 💸
--cheaper — sets cheaper mode (adaptive process spawning)
--cheaper-initial — sets the initial number of processes to spawn in cheaper mode
--cheaper-algo — chooses the algorithm used for adaptive process spawning 🧠
--cheaper-step — the number of additional processes to spawn at each overload
--cheaper-overload — increases workers after the specified overload
--cheaper-algo-list — lists enabled cheapers algorithms 📋
--cheaper-algos-list — lists enabled cheapers algorithms
--cheaper-list — lists enabled cheapers algorithms
--cheaper-rss-limit-soft — won't spawn new workers if the total resident memory usage of all workers is higher than this limit 🛑
--cheaper-rss-limit-hard — if total workers resident memory usage is higher, tries to stop workers
--idle — sets idle mode (puts uWSGI in cheap mode after inactivity) 💤
--die-on-idle — shuts down uWSGI when idle ⚰️
--mount — loads the application under a mountpoint
--worker-mount — loads the application under a mountpoint in the specified worker or after workers spawn
--threads — runs each worker in prethreaded mode with the specified number of threads 🧵
--thread-stacksize — sets threads stacksize
--threads-stacksize — sets threads stacksize
--thread-stack-size — sets threads stacksize
--threads-stack-size — sets threads stacksize
--vhost — enables virtualhosting mode (based on the SERVER_NAME variable) 🏠
--vhost-host — enables virtualhosting mode (based on the HTTP_HOST variable)
--route — adds a route 🛣️
--route-host — adds a route based on the Host header
--route-uri — adds a route based on REQUEST_URI
--route-qs — adds a route based on QUERY_STRING
--route-remote-addr — adds a route based on REMOTE_ADDR
--route-user-agent — adds a route based on HTTP_USER_AGENT
--route-remote-user — adds a route based on REMOTE_USER
--route-referer — adds a route based on HTTP_REFERER
--route-label — adds a routing label (for use with goto) 🏷️
--route-if — adds a route based on condition
--route-if-not — adds a route based on condition (negate version) 🙃
--route-run — always runs the specified route action
--final-route — adds a final route 🏁
--final-route-status — adds a final route for the specified status
--final-route-host — adds a final route based on the Host header
--final-route-uri — adds a final route based on REQUEST_URI
--final-route-qs — adds a final route based on QUERY_STRING
--final-route-remote-addr — adds a final route based on REMOTE_ADDR
--final-route-user-agent — adds a final route based on HTTP_USER_AGENT
--final-route-remote-user — adds a final route based on REMOTE_USER
--final-route-referer — adds a final route based on HTTP_REFERER
--final-route-label — adds a final routing label (for use with goto) 🏷️
--final-route-if — adds a final route based on condition
--final-route-if-not — adds a final route based on condition (negate version) 🙃
--final-route-run — always runs the specified final route action
--error-route — adds an error route 🚨
--error-route-status — adds an error route for the specified status
--error-route-host — adds an error route based on the Host header
--error-route-uri — adds an error route based on REQUEST_URI
--error-route-qs — adds an error route based on QUERY_STRING
--error-route-remote-addr — adds an error route based on REMOTE_ADDR
--error-route-user-agent — adds an error route based on HTTP_USER_AGENT
--error-route-remote-user — adds an error route based on REMOTE_USER
--error-route-referer — adds an error route based on HTTP_REFERER
--error-route-label — adds an error routing label (for use with goto) 🏷️
--error-route-if — adds an error route based on condition
--error-route-if-not — adds an error route based on condition (negate version) 🙃
--error-route-run — always runs the specified error route action
--response-route — adds a response route 💌
--response-route-status — adds a response route for the specified status
--response-route-host — adds a response route based on the Host header
--response-route-uri — adds a response route based on REQUEST_URI
--response-route-qs — adds a response route based on QUERY_STRING
--response-route-remote-addr — adds a response route based on REMOTE_ADDR
--response-route-user-agent — adds a response route based on HTTP_USER_AGENT
--response-route-remote-user — adds a response route based on REMOTE_USER
--response-route-referer — adds a response route based on HTTP_REFERER
--response-route-label — adds a response routing label (for use with goto) 🏷️
--response-route-if — adds a response route based on condition
--response-route-if-not — adds a response route based on condition (negate version) 🙃
--response-route-run — always runs the specified response route action
--router-list — lists enabled routers 📋
--routers-list — lists enabled routers
--error-page-403 — adds an error page (html) for a managed 403 response
--error-page-404 — adds an error page (html) for a managed 404 response
--error-page-500 — adds an error page (html) for a managed 500 response
--websockets-ping-freq — sets the frequency (in seconds) of websockets automatic ping packets 🏓
--websocket-ping-freq — sets the frequency (in seconds) of websockets automatic ping packets
--websockets-pong-tolerance — sets the tolerance (in seconds) of the websockets ping/pong subsystem
--websocket-pong-tolerance — sets the tolerance (in seconds) of the websockets ping/pong subsystem
--websockets-max-size — sets the max allowed size of websocket messages (in Kbytes, default 1024) 📦
--websocket-max-size — sets the max allowed size of websocket messages (in Kbytes, default 1024)
--chunked-input-limit — sets the max size of a chunked input part (default 1MB, in bytes) 🧩
--chunked-input-timeout — sets the default timeout for chunked input ⏳
--clock — sets a clock source 🕰️
--clock-list — lists enabled clocks
--clocks-list — lists enabled clocks
--add-header — automatically adds HTTP headers to the response ✨

and yes bestie there's still more coming, don't you dare close the tab 💖

--rem-header — bestie, this one just yeets a specified HTTP header right out of the response 💅
--del-header — same energy, same job: automatically remove the specified HTTP header from the response
--collect-header — stash a specified response header into a request var ✨ syntax goes header var
--response-header-collect — literally the same thing: store the specified response header in a request var, syntax header var
--pull-header — store that specified response header in a request var AND remove it from the response, double duty 😌 syntax: header var
--check-static — peek for static files in the directory you name 🌸
--check-static-docroot — check for static files in the requested DOCUMENT_ROOT
--static-check — yep, check for static files in the specified directory (twin of --check-static, no cap)
--static-map — map a mountpoint onto a static directory (or a file) 🗺️
--static-map2 — like --static-map, but it completely appends the requested resource to the docroot
--static-skip-ext — skip the extension you name when doing staticfile checks
--static-index — if someone asks for a directory, search for the file you specified instead 🎀
--static-safe — skip security checks if the file lives under the path you give it (iykyk, be careful with this one)
--static-cache-paths — drop resolved paths into the uWSGI cache for however many seconds you specify ⏱️
--static-cache-paths-name — use the cache you name for static paths
--mimefile — set the mime types file path (default /etc/mime.types)
--mime-file — the exact same thing: set the 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 a filename regexp
--static-expires-mtime — set the Expires header based on a filename regexp and file mtime
--static-expires-uri — set the Expires header based on a REQUEST_URI regexp
--static-expires-uri-mtime — set the Expires header based on a REQUEST_URI regexp and file mtime
--static-expires-path-info — set the Expires header based on a PATH_INFO regexp
--static-expires-path-info-mtime — set the Expires header based on a PATH_INFO regexp and file mtime
--static-gzip — if the regexp you supply matches the static file translation, it'll go hunt for a gzip version 👑
--static-gzip-all — check for a gzip version of every single requested static file
--static-gzip-dir — check for a gzip version of all requested static files in the dir/prefix you name
--static-gzip-prefix — same vibes: 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 ext/suffix you give
--static-gzip-suffix — twin of the above: check for a gzip version of all requested static files with the specified ext/suffix
--honour-range — turn on support for the HTTP Range header 🔥
--offload-threads — set how many offload threads to spawn (per-worker, default 0)
--offload-thread — same deal: set the number of offload threads to spawn (per-worker, default 0)
--file-serve-mode — set the static file serving mode
--fileserve-mode — literally identical: set static file serving mode
--disable-sendfile — turn off sendfile() and just rely on boring old read()/write() 😭
--check-cache — check for response data in the specified cache (leave it empty for the default cache)
--close-on-exec — set close-on-exec on connection sockets (could be required for spawning processes inside requests)
--close-on-exec2 — set close-on-exec on server sockets (could be required for spawning processes in requests)
--mode — set a uWSGI custom mode
--env — set an environment variable 🌈
--envdir — load a daemontools compatible envdir
--early-envdir — load a daemontools compatible envdir ASAP ⚡
--unenv — unset an environment variable
--vacuum — try to remove all of the generated file/sockets 🧹
--file-write — write the specified content to the specified file before privileges drop, syntax file=value ✍️
--cgroup — put the processes into the cgroup you name
--cgroup-opt — set a value in the specified cgroup option
--cgroup-dir-mode — set permission for the cgroup directory (default is 700)
--namespace — run in a new namespace under the rootfs you specify 🦋
--namespace-keep-mount — keep the mountpoint you name inside your namespace
--ns — run in a new namespace under the specified rootfs (same as --namespace)
--namespace-net — add a network namespace
--ns-net — add a network namespace (yep, the short twin)
--enable-proxy-protocol — enable PROXY1 protocol support (only for http parsers)
--reuse-port — enable the REUSE_PORT flag on a socket (BSD only 🍓)
--tcp-fast-open — enable the TCP_FASTOPEN flag on TCP sockets with the qlen value you give
--tcp-fastopen — same thing: enable TCP_FASTOPEN on TCP sockets with the specified qlen value
--tcp-fast-open-client — use sendto(..., MSG_FASTOPEN, ...) instead of connect() if it's supported 💫
--tcp-fastopen-client — identical: use 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, but key=val syntax this time
--unique-cron — add a unique cron task
--cron-harakiri — set the max time (in seconds) we wait for a cron command to complete
--legion-cron — add a cron task that only runs when the instance is a lord of the specified legion 👑
--cron-legion — same as --legion-cron: 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 — same vibe: add a unique cron task runnable only when the instance is a lord of the specified legion
--loop — pick the uWSGI loop engine 🔄
--loop-list — list all the enabled loop engines
--loops-list — list enabled loop engines (same thing, extra s)
--worker-exec — run the command you give as a worker
--worker-exec2 — run the specified command as a worker, but after the post_fork hook
--attach-daemon — attach a command/daemon to the master process (heads up: the command has to NOT go into background) ⚠️
--attach-control-daemon — attach a command/daemon to the master process (the command has to not go in background), and 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, except the daemon only runs on the legion lord node
--legion-smart-attach-daemon — same as --smart-attach-daemon, but the daemon only runs on the legion lord node
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2, but the daemon only runs on the legion lord node
--daemons-honour-stdin — don't swap the stdin of external daemons over to /dev/null
--attach-daemon2 — the keyval variant of attach-daemon (it supports smart modes too) ✨
--plugins — load uWSGI plugins 🧩
--plugin — load uWSGI plugins (singular spelling, same job)
--need-plugins — load uWSGI plugins, and exit on error
--need-plugin — load uWSGI plugins (exit on error), singular flavor
--plugins-dir — add a directory to the uWSGI plugin search path
--plugin-dir — add a directory to uWSGI plugin search path (same thing)
--plugins-list — list the enabled plugins
--plugin-list — list enabled plugins (identical)
--autoload — try to automatically load plugins whenever unknown options show up
--dlopen — blindly load a shared library (no thoughts, just vibes)
--allowed-modifiers — a comma separated list of allowed modifiers
--remap-modifier — remap a 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 (super 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 the uWSGI version ⭐
--response-headers-limit — set the max response header size (default: 64k)
--wsgi-file — load a .wsgi file 🐍
--file — load a .wsgi file (same)
--eval — eval python code
-w|--module — load a WSGI module
-w|--wsgi — load a WSGI module (the other name for it)
--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 the python program name
--py-program-name — set python program name (same)
--pythonpath — add a directory (or glob) to pythonpath
--python-path — add directory (or glob) to pythonpath (twin)
--pp — add a directory (or glob) to pythonpath (short and sweet)
--pymodule-alias — add a python alias module
--post-pymodule-alias — add a python module alias after the uwsgi module is initialized
--import — import a python module
--pyimport — import a python module
--py-import — import a python module
--python-import — import a python module (yes bestie, four whole spellings of the same option, iconic)
--shared-import, --shared-pyimport, --shared-py-import, --shared-python-import — import a python module in all of the processes ✨
--spooler-import, --spooler-pyimport, --spooler-py-import, --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, --py, --pyrun — run a python script in the uWSGI environment 📜
--py-tracebacker — enable the uWSGI python tracebacker 🔍
--py-auto-reload, --py-autoreload, --python-auto-reload, --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, --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, --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, --py-sys-executable — override sys.executable value 🐍

💖 That's the whole page, bestie. Source: uwsgi_python312, version 2.0.24-debian, dated April 2024. Now go be iconic with your options 💅✨

📦 where this page comes from

ubuntu noble: uwsgi-plugin-python3 2.0.24-2ubuntu10 · 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