UWSGI_PYTHON310(1)

📦 version 2.0.20, in ubuntu jammy

✨ NAME ✨

uwsgi_python310(1) — bestie, meet your new obsession: a fast (pure C), self-healing, developer-friendly WSGI server. Like, it's giving main character energy for your Python web apps. 💖

✨ SYNOPSIS ✨

uwsgi-core-local [options...]

✨ DESCRIPTION ✨

Okay so this is the part where we spill all the options. There are literally so many. Grab a boba, get comfy, and let's go through them one by one. No cap, every single flag matters. This is part 1 of 7, so buckle up. 🧚

-s|--socket — binds to the UNIX/TCP socket you specify, using the default protocol. Classic. ✨
-s|--uwsgi-socket — binds to the UNIX/TCP socket you specify, using the uwsgi protocol. Same socket vibe, different protocol. 💅
--suwsgi-socket — binds to the UNIX/TCP socket you specify, using the uwsgi protocol over SSL. Secure slay. 🔒
--ssl-socket — binds to the UNIX/TCP socket you specify, using the uwsgi protocol over SSL. Yes, it's the same as above — duplicate energy, still valid. 🌸
--http-socket — binds to the UNIX/TCP socket you specify, using HTTP protocol. The people's champ. 🌐
--http-socket-modifier1 — forces the modifier1 you specify when using HTTP protocol. Niche but iconic. 🎀
--http-socket-modifier2 — forces the modifier2 you specify when using HTTP protocol. Twin energy. 🦋
--http11-socket — binds to the UNIX/TCP socket you specify, using HTTP 1.1 (Keep-Alive) protocol. Your connections stay alive, bestie. 💖
--https-socket — binds to the UNIX/TCP socket you specify, using HTTPS protocol. The secure glow-up. 🔥
--https-socket-modifier1 — forces the modifier1 you specify when using HTTPS protocol. You know the drill. ✨
--https-socket-modifier2 — forces the modifier2 you specify when using HTTPS protocol. Periodt. 💅
--fastcgi-socket — binds to the UNIX/TCP socket you specify, using FastCGI protocol. Old school but still cute. 🍓
--fastcgi-nph-socket — binds to the UNIX/TCP socket you specify, using FastCGI protocol (nph mode). Niche flex. 🧚
--fastcgi-modifier1 — forces the modifier1 you specify when using FastCGI protocol. 🎀
--fastcgi-modifier2 — forces the modifier2 you specify when using FastCGI protocol. 🦋
--scgi-socket — binds to the UNIX/TCP socket you specify, using SCGI protocol. Underrated fr fr. 🌸
--scgi-nph-socket — binds to the UNIX/TCP socket you specify, using SCGI protocol (nph mode). We love a variant. 💜
--scgi-modifier1 — forces the modifier1 you specify when using SCGI protocol. 💅
--scgi-modifier2 — forces the modifier2 you specify when using SCGI protocol. ✨
--raw-socket — binds to the UNIX/TCP socket you specify, using RAW protocol. No filter, just vibes. 🔥
--raw-modifier1 — forces the modifier1 you specify when using RAW protocol. 🎀
--raw-modifier2 — forces the modifier2 you specify when using RAW protocol. 🦋
--puwsgi-socket — binds to the UNIX/TCP socket you specify, using persistent uwsgi protocol (puwsgi). Commitment issues? Not here. 💖
--protocol — forces the protocol you specify for default sockets. You're in charge. 👑
--socket-protocol — forces the protocol you specify for default sockets. Same as above. Twin flame. ✨
--shared-socket — creates a shared socket for advanced jailing or ipc. Big brain move. 🧠
--undeferred-shared-socket — creates a shared socket for advanced jailing or ipc (undeferred mode). The sequel. 💅
-p|--processes — spawns the number of workers/processes you specify. Pop off. 🌈
-p|--workers — spawns the number of workers/processes you specify. Same as above, just a different name. Slay. 💖
--thunder-lock — serializes accept() usage (if possible). Thunder lock, iconic. ⚡
-t|--harakiri — sets the harakiri timeout. Dramatic name, serious business. 🗡️
--harakiri-verbose — enables verbose mode for harakiri. It'll tell you everything. 😭
--harakiri-no-arh — does not enable harakiri during after-request-hook. Boundaries. 🚫
--no-harakiri-arh — does not enable harakiri during after-request-hook. Same boundary, different flag. 💅
--no-harakiri-after-req-hook — does not enable harakiri during after-request-hook. Third time's the charm. Still no harakiri there. ✨
--backtrace-depth — sets backtrace depth. For when you need the tea. 🍵
--mule-harakiri — sets harakiri timeout for mule tasks. Mule-specific drama. 🐴
-x|--xmlconfig — loads config from an XML file. Old school cool. 📜
-x|--xml — loads config from an XML file. Same XML config, shorter name. ✨
--config — loads configuration using the pluggable system. Flexible queen. 💅
--fallback-config — re-execs uwsgi with the config you specify when exit code is 1. Backup plan energy. 🛟
--strict — enables strict mode (placeholder cannot be used). Placeholders? Not allowed. No cap. 🚫
--skip-zero — skips check of file descriptor 0. Bye. 👋
--skip-atexit — skips atexit hooks (ignored by the master). Note: the master ignores this. 🙈
--skip-atexit-teardown — skips atexit teardown (ignored by the master). Master still ignores it. 💀
-S|--set — sets a placeholder or an option. Multitasking icon. 🎀
--set-placeholder — sets a placeholder. Just that. ✨
--set-ph — sets a placeholder. Placeholder setter, short version. 💅
--get — prints the option value you specify and exits. Hit and run. 🏃‍♀️
--declare-option — declares a new uWSGI custom option. DIY queen. 👑
--declare-option2 — declares a new uWSGI custom option (non-immediate). The sequel. 🦋
--resolve — places the result of a dns query in the placeholder you specify, sytax: placeholder=name (immediate option). Yes, 'sytax' is a typo, we're keeping it. 🌐
--for — (opt logic) for cycle. Loops, but make it fashion. 🔁
--for-glob — (opt logic) for cycle (expand glob). Fancy loop. ✨
--for-times — (opt logic) for cycle (expand the specified num to a list starting from 1). Math slay. 🔢
--for-readline — (opt logic) for cycle (expand the specified file to a list of lines). File-to-list pipeline. 📄
--endfor — (opt logic) end for cycle. Bye loop. 👋
--end-for — (opt logic) end for cycle. Same end, different spelling. 💅
--if-opt — (opt logic) check for option. Checks if an option exists. 👀
--if-not-opt — (opt logic) check for option. Checks if an option does NOT exist. Negative queen. 🚫
--if-env — (opt logic) check for environment variable. 🌱
--if-not-env — (opt logic) check for environment variable. Checks that an env var is not there. 🙅
--ifenv — (opt logic) check for environment variable. Same as --if-env, but shorter. ✨
--if-reload — (opt logic) check for reload. 🔄
--if-not-reload — (opt logic) check for reload. Checks for NOT reload. 🤔
--if-hostname — (opt logic) check for hostname. 🏠
--if-not-hostname — (opt logic) check for hostname. Checks that hostname doesn't match. 🚫
--if-hostname-match — (opt logic) try to match hostname against a regular expression. Regex bestie. 🔍
--if-not-hostname-match — (opt logic) try to match hostname against a regular expression. Regex match, but NOT. Inverse. 🔄
--if-exists — (opt logic) check for file/directory existence. 👀
--if-not-exists — (opt logic) check for file/directory existence. Checks if it does NOT exist. 🚫
--ifexists — (opt logic) check for file/directory existence. Same as --if-exists, shorter. ✨
--if-plugin — (opt logic) check for plugin. 🔌
--if-not-plugin — (opt logic) check for plugin. Checks for no plugin. 🚫
--ifplugin — (opt logic) check for plugin. Shorter plugin check. 💅
--if-file — (opt logic) check for file existance. Yes, 'existance' typo, keeping it. 📁
--if-not-file — (opt logic) check for file existance. Checks for file NOT existance. 🚫
--if-dir — (opt logic) check for directory existance. 📂
--if-not-dir — (opt logic) check for directory existance. Checks for directory NOT existance. 🚫
--ifdir — (opt logic) check for directory existance. Shorter directory check. ✨
--if-directory — (opt logic) check for directory existance. Even longer directory check. 💅
--endif — (opt logic) end if. Bye condition. 👋
--end-if — (opt logic) end if. Same end, hyphenated. ✨
--blacklist — sets options blacklist context. Denied. 🚫
--end-blacklist — clears options blacklist context. Freedom. 🕊️
--whitelist — sets options whitelist context. Allowed. ✅
--end-whitelist — clears options whitelist context. Bye. 👋
--ignore-sigpipe — does not report (annoying) SIGPIPE. We don't need that drama. 🙈
--ignore-write-errors — does not report (annoying) write()/writev() errors. Peace. ✌️
--write-errors-tolerance — sets the maximum number of allowed write errors (default: no tolerance). Zero chill. 💀
--write-errors-exception-only — only raises an exception on write errors, giving control to the app itself. Delegation. 🎤
--disable-write-exception — disables exception generation on write()/writev(). No exceptions. 🚫
--inherit — uses the file you specify as a config template. Inheritance but make it config. 👑
--include — includes the file you specify as immediate configuration. Right now. ⚡
--inject-before — injects a text file before the config file (advanced templating). 🧬
--inject-after — injects a text file after the config file (advanced templating). Advanced templating, part two. 🧬
-d|--daemonize — daemonizes uWSGI. Background vibes. 🌙
--daemonize2 — daemonizes uWSGI after app loading. Fashionably late. ⏰
--stop — stops an instance. Bye bestie. 👋
--reload — reloads an instance. Refresh. 🔄
--pause — pauses an instance. Timeout. ⏸️
--suspend — suspends an instance. Sleep mode. 😴
--resume — resumes an instance. Wake up. ☀️
--connect-and-read — connects to a socket and waits for data from it. Patient queen. ⏳
--extract — fetches/dumps any supported address to stdout. Data dump. 📤
-l|--listen — sets the socket listen queue size. Queue up. 🎟️
-v|--max-vars — sets the amount of internal iovec/vars structures. Internals. 🧠
--max-apps — sets the maximum number of per-worker applications. Limit. 🚧
-b|--buffer-size — sets internal buffer size. Buffer bestie. 🧺
-m|--memory-report — enables memory report. Receipts. 🧾
--profiler — enables the profiler you specify. Profile era. 📊
-c|--cgi-mode — forces CGI-mode for plugins supporting it. Retro. 📼
-a|--abstract-socket — forces UNIX socket in abstract mode (Linux only). Linux only, bestie. 🐧
-C|--chmod-socket — chmod-socket. Permissions slay. 🔐
-C|--chmod — chmod-socket. Same chmod, different name. ✨
--chown-socket — chowns unix sockets. Ownership. 👑
--umask — sets umask. Mask on. 🎭
--freebind — puts socket in freebind mode. Free to bind. 🕊️
--map-socket — maps sockets to specific workers. Matchmaker. 💘
-T|--enable-threads — enables threads. Thread party. 🧵
--no-threads-wait — does not wait for threads cancellation on quit/reload. No waiting. 🚫
--auto-procname — automatically sets processes name to something meaningful. Auto-naming. 🏷️
--procname-prefix — adds a prefix to the process names. Prefix era. 🔤
--procname-prefix-spaced — adds a spaced prefix to the process names. Space out. 🚀
--procname-append — appends a string to process names. Suffix. ➕
--procname — sets process names. Name it. 📛
--procname-master — sets master process name. Master's name. 👑
-i|--single-interpreter — does not use multiple interpreters (where available). Single and ready to mingle. 💃
--need-app — exits if no app can be loaded. No app, no service. 🚪
-M|--master — enables master process. Master mode. 🧙
--honour-stdin — does not remap stdin to /dev/null. Respect stdin. 🙌
--emperor — runs the Emperor. All hail. 👑
--emperor-proxy-socket — forces the vassal to became an Emperor proxy. Yes, 'became' typo, keeping it. 🏰
--emperor-wrapper — sets a binary wrapper for vassals. Wrap it up. 🎁
--emperor-wrapper-override — sets a binary wrapper for vassals to try before the default one. Override. 🥇
--emperor-wrapper-fallback — sets a binary wrapper for vassals to try as a last resort. Backup plan. 🛟
--emperor-nofollow — does not follow symlinks when checking for mtime. No follow. 🚫
--emperor-procname — sets the Emperor process name. Royal naming. 👑
--emperor-freq — sets the Emperor scan frequency (default 3 seconds). Tick tock. ⏰
--emperor-required-heartbeat — sets the Emperor tolerance about heartbeats. Heartbeat check. 💓
--emperor-curse-tolerance — sets the Emperor tolerance about cursed vassals. Cursed energy. 🧙‍♂️
--emperor-pidfile — writes the Emperor pid in the file you specify. PID file. 📝
--emperor-tyrant — puts the Emperor in Tyrant mode. Tyrant era. 👑
--emperor-tyrant-nofollow — does not follow symlinks when checking for uid/gid in Tyrant mode. No follow. 🚫
--emperor-stats — runs the Emperor stats server. Stats slay. 📊
--emperor-stats-server — runs the Emperor stats server. Same stats server, different flag. ✨
--early-emperor — spawn the emperor as soon as possibile 😭✨
--emperor-broodlord — run the emperor in BroodLord mode 👑
--emperor-throttle — set throttling level (in milliseconds) for bad behaving vassals (default 1000) 😤
--emperor-max-throttle — set max throttling level (in milliseconds) for bad behaving vassals (default 3 minutes) 🚦
--emperor-magic-exec — prefix vassals config files with exec:// if they have the executable bit 🪄
--emperor-on-demand-extension — search for text file (vassal name + extension) containing the on demand socket name 🔍
--emperor-on-demand-ext — search for text file (vassal name + extension) containing the on demand socket name 🔍
--emperor-on-demand-directory — enable on demand mode binding to the unix socket in the specified directory named like the vassal + .socket 📂
--emperor-on-demand-dir — enable on demand mode binding to the unix socket in the specified directory named like the vassal + .socket 📂
--emperor-on-demand-exec — use the output of the specified command as on demand socket name (the vassal name is passed as the only argument) 🖥️
--emperor-extra-extension — allows the specified extension in the Emperor (vassal will be called with --config) 📎
--emperor-extra-ext — allows the specified extension in the Emperor (vassal will be called with --config) 📎
--emperor-no-blacklist — disable Emperor blacklisting subsystem 🚫
--emperor-use-clone — use clone() instead of fork() passing the specified unshare() flags 🧬
--emperor-graceful-shutdown — use vassals graceful shutdown during ragnarok 🌋
--emperor-cap — set vassals capability 🎩
--vassals-cap — set vassals capability 🎩
--vassal-cap — set vassals capability 🎩
--imperial-monitor-list — list enabled imperial monitors 👀
--imperial-monitors-list — list enabled imperial monitors 👀
--vassals-inherit — add config templates to vassals config (uses --inherit) 📜
--vassals-include — include config templates to vassals config (uses --include instead of --inherit) 📜
--vassals-inherit-before — add config templates to vassals config (uses --inherit, parses before the vassal file) 📜
--vassals-include-before — include config templates to vassals config (uses --include instead of --inherit, parses before the vassal file) 📜
--vassals-start-hook — run the specified command before each vassal starts 🚀
--vassals-stop-hook — run the specified command after vassal's death ⚰️
--vassal-sos — ask emperor for reinforcement when overloaded 🆘
--vassal-sos-backlog — ask emperor for sos if backlog queue has more items than the value specified 📈
--vassals-set — automatically set the specified option (via --set) for every vassal ⚙️
--vassal-set — automatically set the specified option (via --set) for every vassal ⚙️
--heartbeat — announce healthiness to the emperor 💓
--reload-mercy — set the maximum time (in seconds) we wait for workers and other processes to die during reload/shutdown ⏳
--worker-reload-mercy — set the maximum time (in seconds) a worker can take to reload/shutdown (default is 60) ⏳
--mule-reload-mercy — set the maximum time (in seconds) a mule can take to reload/shutdown (default is 60) ⏳
--exit-on-reload — force exit even if a reload is requested 🚪
--die-on-term — exit instead of brutal reload on SIGTERM 💀
--force-gateway — force the spawn of the first registered gateway without a master 🌀
-h, --help — show this help 🆘
-h, --usage — show this help 🆘
--print-sym — print content of the specified binary symbol 🖨️
--print-symbol — print content of the specified binary symbol 🖨️
-r, --reaper — call waitpid(-1,...) after each request to get rid of zombies 🧟
-R, --max-requests — reload workers after the specified amount of managed requests 🔄
--min-worker-lifetime — number of seconds worker must run before being reloaded (default is 60) ⏱️
--max-worker-lifetime — reload workers after the specified amount of seconds (default is disabled) ⏱️
--max-worker-lifetime-delta — add (worker_id * delta) seconds to the max_worker_lifetime value of each worker ➕
-z, --socket-timeout — set internal sockets timeout ⏰
--no-fd-passing — disable file descriptor passing 🚫
--locks — create the specified number of shared locks 🔒
--lock-engine — set the lock engine 🔧
--ftok — set the ipcsem key via ftok() for avoiding duplicates 🔑
--persistent-ipcsem — do not remove ipcsem's on shutdown 🗑️
-A, --sharedarea — create a raw shared memory area of specified pages (note: it supports keyval too) 🧠
--safe-fd — do not close the specified file descriptor 🛡️
--fd-safe — do not close the specified file descriptor 🛡️
--cache — create a shared cache containing given elements 🗃️
--cache-blocksize — set cache blocksize 📦
--cache-store — enable persistent cache to disk 💾
--cache-store-sync — set frequency of sync for persistent cache 🔄
--cache-no-expire — disable auto sweep of expired items 🧹
--cache-expire-freq — set the frequency of cache sweeper scans (default 3 seconds) ⏲️
--cache-report-freed-items — constantly report the cache item freed by the sweeper (use only for debug) 🐛
--cache-udp-server — bind the cache udp server (used only for set/update/delete) to the specified socket 📡
--cache-udp-node — send cache update/deletion to the specified cache udp server 📤
--cache-sync — copy the whole content of another uWSGI cache server on server startup 📋
--cache-use-last-modified — update last_modified_at timestamp on every cache item modification (default is disabled) 🕒
--add-cache-item — add an item in the cache ➕
--load-file-in-cache — load a static file in the cache 📄
--load-file-in-cache-gzip — load a static file in the cache with gzip compression 🗜️
--cache2 — create a new generation shared cache (keyval syntax) 🆕
--queue — enable shared queue 📥
--queue-blocksize — set queue blocksize 📦
--queue-store — enable persistent queue to disk 💾
--queue-store-sync — set frequency of sync for persistent queue 🔄
-Q, --spooler — run a spooler on the specified directory 🧵
--spooler-external — map spoolers requests to a spooler directory managed by an external instance 🔗
--spooler-ordered — try to order the execution of spooler tasks 📋
--spooler-chdir — chdir() to specified directory before each spooler task 📂
--spooler-processes — set the number of processes for spoolers 👥
--spooler-quiet — do not be verbose with spooler tasks 🤫
--spooler-max-tasks — set the maximum number of tasks to run before recycling a spooler 🔄
--spooler-harakiri — set harakiri timeout for spooler tasks 🗡️
--spooler-frequency — set spooler frequency ⏱️
--spooler-freq — set spooler frequency ⏱️
--mule — add a mule 🐴
--mules — add the specified number of mules 🐴
--farm — add a mule farm 🚜
--mule-msg-size — set mule message buffer size 📨
--signal — send a uwsgi signal to a server 📶
--signal-bufsize — set buffer size for signal queue 📶
--signals-bufsize — set buffer size for signal queue 📶
--signal-timer — add a timer (syntax: <signal> <seconds>) ⏲️
--timer — add a timer (syntax: <signal> <seconds>) ⏲️
--signal-rbtimer — add a redblack timer (syntax: <signal> <seconds>) 🌳
--rbtimer — add a redblack timer (syntax: <signal> <seconds>) 🌳
--rpc-max — maximum number of rpc slots (default: 64) 📞
-L, --disable-logging — disable request logging 🚫
--flock — lock the specified file before starting, exit if locked 🔒
--flock-wait — lock the specified file before starting, wait if locked ⏳
--flock2 — lock the specified file after logging/daemon setup, exit if locked 🔒
--flock-wait2 — lock the specified file after logging/daemon setup, wait if locked ⏳
--pidfile — create pidfile (before privileges drop) 📄
--pidfile2 — create pidfile (after privileges drop) 📄
--safe-pidfile — create safe pidfile (before privileges drop) 🛡️
--safe-pidfile2 — create safe pidfile (after privileges drop) 🛡️
--chroot — chroot() to the specified directory 🏰
--pivot-root — pivot_root() to the specified directories (new_root and put_old must be separated with a space) 🔄
--pivot_root — pivot_root() to the specified directories (new_root and put_old must be separated with a space) 🔄
--uid — setuid to the specified user/uid 👤
--gid — setgid to the specified group/gid 👥
--add-gid — add the specified group id to the process credentials ➕
--immediate-uid — setuid to the specified user/uid IMMEDIATELY ⚡
--immediate-gid — setgid to the specified group/gid IMMEDIATELY ⚡
--no-initgroups — disable additional groups set via initgroups() 🚫
--cap — set process capability 🎩
--unshare — unshare() part of the processes and put it in a new namespace 🌌
--unshare2 — unshare() part of the processes and put it in a new namespace after rootfs change 🌌
--setns-socket — expose a unix socket returning namespace fds from /proc/self/ns 🔌
--setns-socket-skip — skip the specified entry when sending setns file descriptors ⏭️
--setns-skip — skip the specified entry when sending setns file descriptors ⏭️
--setns — join a namespace created by an external uWSGI instance 🔗
--setns-preopen — open /proc/self/ns as soon as possible and cache fds 📂
--jailed — mark the instance as jailed (force the execution of post_jail hooks) 🔒
--refork — fork() again after privileges drop. Useful for jailing systems 🍴
--re-fork — fork() again after privileges drop. Useful for jailing systems 🍴
--refork-as-root — fork() again before privileges drop. Useful for jailing systems 👑
--re-fork-as-root — fork() again before privileges drop. Useful for jailing systems 👑
--refork-post-jail — okay so this one does fork() again after jailing. Useful for jailing systems 💅
--re-fork-post-jail — same energy, literally: fork() again after jailing. Useful for jailing systems ✨
--hook-asap — run the specified hook as soon as possible ⚡️
--hook-pre-jail — run the specified hook before jailing 🔒
--hook-post-jail — run the specified hook after jailing 🚪
--hook-in-jail — run the specified hook in jail after initialization 🏠
--hook-as-root — run the specified hook before privileges drop 👑
--hook-as-user — run the specified hook after privileges drop 🧑‍💻
--hook-as-user-atexit — run the specified hook before app exit and reload 🚪
--hook-pre-app — run the specified hook before app loading 📦
--hook-post-app — run the specified hook after app loading ✅
--hook-post-fork — run the specified hook after each fork 🍴
--hook-accepting — run the specified hook after each worker enter the accepting phase 🎧
--hook-accepting1 — run the specified hook after the first worker enters the accepting phase 🥇
--hook-accepting-once — run the specified hook after each worker enter the accepting phase (once per-instance) 1️⃣
--hook-accepting1-once — run the specified hook after the first worker enters the accepting phase (once per instance) 1️⃣
--hook-master-start — run the specified hook when the Master starts 👑
--hook-touch — run the specified hook when the specified file is touched (syntax: <file> <action>) 👆
--hook-emperor-start — run the specified hook when the Emperor starts 👑✨
--hook-emperor-stop — run the specified hook when the Emperor send a stop message 🛑
--hook-emperor-reload — run the specified hook when the Emperor send a reload message 🔄
--hook-emperor-lost — run the specified hook when the Emperor connection is lost 💔
--hook-as-vassal — run the specified hook before exec()ing the vassal 🧚
--hook-as-emperor — run the specified hook in the emperor after the vassal has been started 👑
--hook-as-mule — run the specified hook in each mule 🐴
--hook-as-gateway — run the specified hook in each gateway 🌐
--after-request-hook — run the specified function/symbol after each request 🔁
--after-request-call — run the specified function/symbol after each request 🔁
--exec-asap — run the specified command as soon as possible ⚡️
--exec-pre-jail — run the specified command before jailing 🔒
--exec-post-jail — run the specified command after jailing 🚪
--exec-in-jail — run the specified command in jail after initialization 🏠
--exec-as-root — run the specified command before privileges drop 👑
--exec-as-user — run the specified command after privileges drop 🧑‍💻
--exec-as-user-atexit — run the specified command before app exit and reload 🚪
--exec-pre-app — run the specified command before app loading 📦
--exec-post-app — run the specified command after app loading ✅
--exec-as-vassal — run the specified command before exec()ing the vassal 🧚
--exec-as-emperor — run the specified command in the emperor after the vassal has been started 👑
--mount-asap — mount filesystem as soon as possible ⚡️
--mount-pre-jail — mount filesystem before jailing 🔒
--mount-post-jail — mount filesystem after jailing 🚪
--mount-in-jail — mount filesystem in jail after initialization 🏠
--mount-as-root — mount filesystem before privileges drop 👑
--mount-as-vassal — mount filesystem before exec()ing the vassal 🧚
--mount-as-emperor — mount filesystem in the emperor after the vassal has been started 👑
--umount-asap — unmount filesystem as soon as possible ⚡️
--umount-pre-jail — unmount filesystem before jailing 🔒
--umount-post-jail — unmount filesystem after jailing 🚪
--umount-in-jail — unmount filesystem in jail after initialization 🏠
--umount-as-root — unmount filesystem before privileges drop 👑
--umount-as-vassal — unmount filesystem before exec()ing the vassal 🧚
--umount-as-emperor — unmount filesystem in the emperor after the vassal has been started 👑
--wait-for-interface — wait for the specified network interface to come up before running root hooks 🌐
--wait-for-interface-timeout — set the timeout for wait-for-interface ⏳
--wait-interface — wait for the specified network interface to come up before running root hooks 🌐
--wait-interface-timeout — set the timeout for wait-for-interface ⏳
--wait-for-iface — wait for the specified network interface to come up before running root hooks 🌐
--wait-for-iface-timeout — set the timeout for wait-for-interface ⏳
--wait-iface — wait for the specified network interface to come up before running root hooks 🌐
--wait-iface-timeout — set the timeout for wait-for-interface ⏳
--wait-for-fs — wait for the specified filesystem item to appear before running root hooks 📁
--wait-for-file — wait for the specified file to appear before running root hooks 📄
--wait-for-dir — wait for the specified directory to appear before running root hooks 📂
--wait-for-mountpoint — wait for the specified mountpoint to appear before running root hooks 📌
--wait-for-fs-timeout — set the timeout for wait-for-fs/file/dir ⏳
--wait-for-socket — wait for the specified socket to be ready before loading apps 🔌
--wait-for-socket-timeout — set the timeout for wait-for-socket ⏳
--call-asap — call the specified function as soon as possible ⚡️
--call-pre-jail — call the specified function before jailing 🔒
--call-post-jail — call the specified function after jailing 🚪
--call-in-jail — call the specified function in jail after initialization 🏠
--call-as-root — call the specified function before privileges drop 👑
--call-as-user — call the specified function after privileges drop 🧑‍💻
--call-as-user-atexit — call the specified function before app exit and reload 🚪
--call-pre-app — call the specified function before app loading 📦
--call-post-app — call the specified function after app loading ✅
--call-as-vassal — call the specified function() before exec()ing the vassal 🧚
--call-as-vassal1 — call the specified function(char *) before exec()ing the vassal 🧚
--call-as-vassal3 — call the specified function(char *, uid_t, gid_t) before exec()ing the vassal 🧚
--call-as-emperor — call the specified function() in the emperor after the vassal has been started 👑
--call-as-emperor1 — call the specified function(char *) in the emperor after the vassal has been started 👑
--call-as-emperor2 — call the specified function(char *, pid_t) in the emperor after the vassal has been started 👑
--call-as-emperor4 — call the specified function(char *, pid_t, uid_t, gid_t) in the emperor after the vassal has been started 👑
--ini — load config from ini file 📄
-y|--yaml — load config from yaml file 🧾
-y|--yml — load config from yaml file 🧾
-j|--json — load config from json file 🧾
-j|--js — load config from json file 🧾
--weight — weight of the instance (used by clustering/lb/subscriptions) ⚖️
--auto-weight — set weight of the instance (used by clustering/lb/subscriptions) automatically ⚖️✨
--no-server — force no-server mode 🚫
--command-mode — force command mode ⌨️
--no-defer-accept — disable deferred-accept on sockets 🚫
--tcp-nodelay — enable TCP NODELAY on each request ⚡️
--so-keepalive — enable TCP KEEPALIVEs 💓
--so-send-timeout — set SO_SNDTIMEO ⏳
--socket-send-timeout — set SO_SNDTIMEO ⏳
--so-write-timeout — set SO_SNDTIMEO ⏳
--socket-write-timeout — set SO_SNDTIMEO ⏳
--socket-sndbuf — set SO_SNDBUF 📦
--socket-rcvbuf — set SO_RCVBUF 📥
--shutdown-sockets — force calling shutdown() in addition to close() when sockets are destroyed 💥
--limit-as — limit processes address space/vsz 🧠
--limit-nproc — limit the number of spawnable processes 🔢
--reload-on-as — reload if address space is higher than specified megabytes 🔄
--reload-on-rss — reload if rss memory is higher than specified megabytes 🔄
--evil-reload-on-as — force the master to reload a worker if its address space is higher than specified megabytes 😈
--evil-reload-on-rss — force the master to reload a worker if its rss memory is higher than specified megabytes 😈
--mem-collector-freq — set the memory collector frequency when evil reloads are in place 🧹
--reload-on-fd — reload if the specified file descriptor is ready 🔄
--brutal-reload-on-fd — brutal reload if the specified file descriptor is ready 💀
--ksm — enable Linux KSM 🐧
--pcre-jit — enable pcre jit (if available) ⚡️
--never-swap — lock all memory pages avoiding swapping 🔒
--touch-reload — reload uWSGI if the specified file is modified/touched 👆
--touch-workers-reload — trigger reload of (only) workers if the specified file is modified/touched 👷
--touch-mules-reload — reload mules if the specified file is modified/touched 🐴
--touch-spoolers-reload — reload spoolers if the specified file is modified/touched 🧵
--touch-chain-reload — trigger chain reload if the specified file is modified/touched ⛓️
--touch-logrotate — trigger logrotation if the specified file is modified/touched 📜
--touch-logreopen — trigger log reopen if the specified file is modified/touched 🔄
--touch-exec — run command when the specified file is modified/touched (syntax: file command) 👆
--touch-signal — signal when the specified file is modified/touched (syntax: file signal) 📶
--fs-reload — graceful reload when the specified filesystem object is modified 🌿
--fs-brutal-reload — brutal reload when the specified filesystem object is modified 💀
--fs-signal — raise a uwsgi signal when the specified filesystem object is modified (syntax: file signal) 📶
--check-mountpoint — destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management) 💀
--mountpoint-check — destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management)
--check-mount — destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management)
--mount-check — destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management)

bestie, yes, those are four separate options that all do the exact same thing. iconic behaviour. we don't question it, we just respect it. ✨

--propagate-touch — over-engineering option for system with flaky signal management 😭
--limit-post — limit request body
--no-orphans — automatically kill workers if master dies (can be dangerous for availability)

⚠️ read that again: can be dangerous for availability. it's giving "protective but also kind of a menace".

--prio — set processes/threads priority 👑
--cpu-affinity — set cpu affinity
--post-buffering — set size in bytes after which will buffer to disk instead of memory
--post-buffering-bufsize — set buffer size for read() in post buffering mode
--body-read-warning — set the amount of allowed memory allocation (in megabytes) for request body before starting printing a warning
--upload-progress — enable creation of .json files in the specified directory during a file upload 🍓
--no-default-app — do not fallback to default app
--manage-script-name — automatically rewrite SCRIPT_NAME and PATH_INFO
--ignore-script-name — ignore SCRIPT_NAME
--catch-exceptions — report exception as http output (discouraged, use only for testing)

🫶 discouraged, use only for testing — so like, don't ship this, bestie. testing only. no cap.

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

✨ METRICS, THE WHOLE VIBE ✨

--enable-metrics — enable metrics subsystem 📊
--metric — add a custom metric
--metric-threshold — add a metric threshold/alarm
--metric-alarm — add a metric threshold/alarm
--alarm-metric — add a metric threshold/alarm

three names, one destiny. threshold/alarm gang. 💅

--metrics-dir — export metrics as text files to the specified directory
--metrics-dir-restore — restore last value taken from the metrics dir
--metric-dir — export metrics as text files to the specified directory
--metric-dir-restore — restore last value taken from the metrics dir
--metrics-no-cores — disable generation of cores-related metrics
--udp — run the udp server on the specified address
--stats — enable the stats server on the specified address
--stats-server — enable the stats server on the specified address
--stats-http — prefix stats server json output with http headers
--stats-minified — minify statistics json output
--stats-min — minify statistics json output
--stats-push — push the stats json to the specified destination
--stats-pusher-default-freq — set the default frequency of stats pushers
--stats-pushers-default-freq — set the default frequency of stats pushers
--stats-no-cores — disable generation of cores-related stats
--stats-no-metrics — do not include metrics in stats output
--multicast — subscribe to specified multicast group
--multicast-ttl — set multicast ttl
--multicast-loop — set multicast loop (default 1)
--master-fifo — enable the master fifo 🌈
--notify-socket — enable the notification socket
--subscription-notify-socket — set the notification socket for subscriptions

✨ LEGION (yes it's really called that) ✨

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

--subscriptions-sign-check — set digest algorithm and certificate directory for secured subscription system
--subscriptions-sign-check-tolerance — set the maximum tolerance (in seconds) of clock skew for secured subscription system
--subscriptions-sign-skip-uid — skip signature check for the specified uid when using unix sockets credentials
--subscriptions-credentials-check — add a directory to search for subscriptions key credentials
--subscriptions-use-credentials — enable management of SCM_CREDENTIALS in subscriptions UNIX sockets
--subscription-algo — set load balancing algorithm for the subscription system
--subscription-dotsplit — try to fallback to the next part (dot based) in subscription key
--subscribe-to — subscribe to the specified subscription server
--st — subscribe to the specified subscription server
--subscribe — subscribe to the specified subscription server
--subscribe2 — subscribe to the specified subscription server using advanced keyval syntax
--subscribe-freq — send subscription announce at the specified interval
--subscription-tolerance — set tolerance for subscription servers
--unsubscribe-on-graceful-reload — force unsubscribe request even during graceful reload
--start-unsubscribed — configure subscriptions but do not send them (useful with master fifo)
--subscribe-with-modifier1 — force the specififed modifier1 when subscribing

ok so "specififed" is literally spelled that way in here and we are preserving it. historical artefact. do not touch. 🎀

✨ SNMP + SSL ✨

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

bestie. insecure. all three of them. it's giving "please don't". we're just the messenger. 😭

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

✨ LOGGING ✨

--logto — set logfile/udp address
--logto2 — log to specified file or udp address after privileges drop
--log-format — set advanced format for request logging
--logformat — set advanced format for request logging
--logformat-strftime — apply strftime to logformat output
--log-format-strftime — apply strftime to logformat output
--logfile-chown — chown logfiles
--logfile-chmod — chmod logfiles
--log-syslog — log to syslog
--log-socket — send logs to the specified socket
--req-logger — set/append a request logger
--logger-req — set/append a request logger
--logger — set/append a logger
--logger-list — list enabled loggers
--loggers-list — list enabled loggers
--threaded-logger — offload log writing to a thread 🧵
--log-encoder — add an item in the log encoder chain
--log-req-encoder — add an item in the log req encoder chain
--log-drain — drain (do not show) log lines matching the specified regexp
--log-filter — show only log lines matching the specified regexp
--log-route — log to the specified named logger if regexp applied on logline matches
--log-req-route — log requests to the specified named logger if regexp applied on logline matches
--use-abort — call abort() on segfault/fpe, could be useful for generating a core dump
--alarm — create a new alarm, syntax: <alarm> <plugin:args> ⏰
--alarm-cheap — use main alarm thread rather than create dedicated threads for curl-based alarms
--alarm-freq — tune the anti-loop alarm system (default 3 seconds)
--alarm-fd — raise the specified alarm when an fd is read for read (by default it reads 1 byte, set 8 for eventfd)
--alarm-segfault — raise the specified alarm when the segmentation fault handler is executed
--segfault-alarm — fires off the alarm you specify the moment the segmentation fault handler gets executed 💀 (yeah, that handler, the one nobody wants to meet)
--alarm-backlog — raises the specified alarm when the socket backlog queue is full
--backlog-alarm — same energy, same job: 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

okay so yes, that's six whole spellings of the same idea. the backlog is full, the alarm goes off, pick whichever name your fingers like 💅

--log-alarm — raises the specified alarm when a log line matches the regexp you gave, syntax: <alarm>[,alarm...] <regexp>
--alarm-log — raises the specified alarm when a log line matches the regexp you gave, syntax: <alarm>[,alarm...] <regexp>
--not-log-alarm — skips the specified alarm when a log line matches the regexp you gave, syntax: <alarm>[,alarm...] <regexp> (the hater version)
--not-alarm-log — skips the specified alarm when a log line matches the regexp you gave, syntax: <alarm>[,alarm...] <regexp>
--alarm-list — lists every enabled alarm ✨
--alarms-list — lists every enabled alarm (plural gang)
--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 will get truncated bestie, so size accordingly
--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 a reload 🔄
--log-truncate — truncates the log on startup
--log-maxsize — sets the maximum logfile size
--log-backupname — sets the logfile name used after rotation
--logdate — prefixes logs with a date, or with a strftime string
--log-date — prefixes logs with a date, or with a strftime string
--log-prefix — prefixes logs with a string you choose

--log-zero — logs responses that have no body
--log-slow — logs requests slower than the number of milliseconds you specify 🐌
--log-4xx — logs requests with a 4xx response
--log-5xx — logs requests with a 5xx response
--log-big — logs requests bigger than the size you specify
--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, and it's superseded by drop-after-apps
--drop-after-apps — runs the privileges drop after apps loading, and it's superseded by master-as-root
--force-cwd — forces the initial working directory to the value you specify
--binsh — overrides /bin/sh (this is what exec hooks use, and 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 (apps load in the workers instead of the master) 😴
--lazy-apps — loads apps in each worker instead of the master
--cheap — sets cheap mode (workers only spawn 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 — picks 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 overload you specify
--cheaper-algo-list — lists the enabled cheapers algorithms
--cheaper-algos-list — lists the enabled cheapers algorithms
--cheaper-list — lists the enabled cheapers algorithms
--cheaper-rss-limit-soft — doesn'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, it tries to stop workers 🛑
--idle — sets idle mode (puts uWSGI into cheap mode after inactivity)
--die-on-idle — shuts uWSGI down when idle 💀

--mount — loads an application under a mountpoint
--worker-mount — loads an application under a mountpoint in the specified worker, or after workers spawn
--threads — runs each worker in prethreaded mode with the number of threads you specify 🧵
--thread-stacksize — sets the threads stacksize
--threads-stacksize — sets the threads stacksize
--thread-stack-size — sets the threads stacksize
--threads-stack-size — sets the threads stacksize

four names, one stacksize. they all do the exact same thing, bestie, go wild 🌸

--vhost — enables virtualhosting mode (it keys off the SERVER_NAME variable)
--vhost-host — enables virtualhosting mode (it keys off 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 a condition
--route-if-not — adds a route based on a condition (the negate version)
--route-run — always runs the route action you specify

--final-route — adds a final route
--final-route-status — adds a final route for the status you specify
--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 a condition
--final-route-if-not — adds a final route based on a condition (the negate version)
--final-route-run — always runs the final route action you specify

--error-route — adds an error route
--error-route-status — adds an error route for the status you specify
--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 a condition
--error-route-if-not — adds an error route based on a condition (the negate version)
--error-route-run — always runs the error route action you specify

--response-route — adds a response route
--response-route-status — adds a response route for the status you specify
--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 a condition
--response-route-if-not — adds a response route based on a condition (the negate version)
--response-route-run — always runs the response route action you specify

--router-list — lists the enabled routers 🛣️
--routers-list — lists the enabled routers

--error-page-403 — adds an error page (html) for the managed 403 response
--error-page-404 — adds an error page (html) for the managed 404 response
--error-page-500 — adds an error page (html) for the 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 the enabled clocks
--clocks-list — lists the enabled clocks

--add-header — automatically adds HTTP headers to the response ✨
--rem-header — automatically removes the specified HTTP header from the response
--del-header — automatically removes the specified HTTP header from the response
--collect-header — stores the specified response header in a request var, syntax: <header> <var>
--response-header-collect — stash the response header you name into a request var (syntax: header var) 💖
--pull-header — same energy as above but it also yeets that header out of the response entirely (syntax: header var) ✨

🎀 static file serving, the whole saga 🎀

--check-static — peek for static files inside the directory you give it
--check-static-docroot — peek for static files in the requested DOCUMENT_ROOT
--static-check — peek for static files in the directory you give it (yes bestie, same vibe as --check-static)
--static-map — map a mountpoint to a static directory (or file)
--static-map2 — like static-map but it fully appends the requested resource to the docroot
--static-skip-ext — skip the extension you specify when doing staticfile checks
--static-index — go look for the file you name if a directory is what got requested
--static-safe — skip security checks when the file lives under the path you specify
--static-cache-paths — drop resolved paths into the uWSGI cache for however many seconds you say
--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 — set the mime types file path (default /etc/mime.types) (the same thing, spelled cuter)
--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 your regexp matches the static file translation, it'll go hunting for a gzip version 🌸
--static-gzip-all — check for a gzip version of literally every requested static file
--static-gzip-dir — check for a gzip version of all requested static files in the dir/prefix you specify
--static-gzip-prefix — check for a gzip version of all requested static files in the dir/prefix you specify (twin flame of the one above 💅)
--static-gzip-ext — check for a gzip version of all requested static files with the ext/suffix you give
--static-gzip-suffix — check for a gzip version of all requested static files with the ext/suffix you give (again, same but different name, iykyk)
--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 — set how many offload threads to spawn (per-worker, default 0) (singular edition, same deal)
--file-serve-mode — set the static file serving mode
--fileserve-mode — set the static file serving mode (no hyphen, same mode)
--disable-sendfile — disable sendfile() and go rely on boring read()/write() 😭
--check-cache — check for response data in the cache you specify (leave it empty for the default cache)
--close-on-exec — set close-on-exec on connection sockets (might be required for spawning processes in requests)
--close-on-exec2 — set close-on-exec on server sockets (might be required for spawning processes in requests)

🦋 modes, env, and other little rituals 🦋

--mode — set uWSGI custom mode
--env — set environment variable
--envdir — load a daemontools compatible envdir
--early-envdir — load a daemontools compatible envdir ASAP
--unenv — unset environment variable
--vacuum — try to remove all of the generated file/sockets 🧹
--file-write — write the content you specify to the file you specify (syntax: file=value) before privileges drop
--cgroup — put the processes in the cgroup you name
--cgroup-opt — set a value in the cgroup option you name
--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 specify in your namespace
--ns — run in a new namespace under the rootfs you specify (short lil alias 💜)
--namespace-net — add network namespace
--ns-net — add network namespace
--enable-proxy-protocol — enable PROXY1 protocol support (only for http parsers)
--reuse-port — enable the REUSE_PORT flag on the socket (BSD only, bestie, don't come for me)
--tcp-fast-open — enable the TCP_FASTOPEN flag on TCP sockets with the qlen value you give
--tcp-fastopen — enable the TCP_FASTOPEN flag on TCP sockets with the qlen value you give (hyphen walked so this could run ✨)
--tcp-fast-open-client — use sendto(..., MSG_FASTOPEN, ...) instead of connect() if it's supported
--tcp-fastopen-client — use sendto(..., MSG_FASTOPEN, ...) instead of connect() if it's supported (same, no hyphen)
--zerg — attach to a zerg server 🐛
--zerg-fallback — fallback 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 (key=val syntax)
--unique-cron — add a unique cron task
--cron-harakiri — set the maximum 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 legion you specify 👑
--cron-legion — add a cron task that only runs when the instance is a lord of the legion you specify
--unique-legion-cron — add a unique cron task that only runs when the instance is a lord of the legion you specify
--unique-cron-legion — add a unique cron task that only runs when the instance is a lord of the legion you specify
--loop — select the uWSGI loop engine
--loop-list — list enabled loop engines
--loops-list — list enabled loop engines (plural, same list)
--worker-exec — run the command you specify as a worker
--worker-exec2 — run the command you specify as a worker (after the post_fork hook)
--attach-daemon — attach a command/daemon to the master process (the command has to not go in background)
--attach-control-daemon — attach a command/daemon to the master process (the command has to not go in background); when the daemon dies, the master dies too 💀
--smart-attach-daemon — attach a command/daemon to the master process managed by a pidfile (the command has to daemonize)
--smart-attach-daemon2 — attach a command/daemon to the master process managed by a pidfile (the command has to NOT daemonize)
--legion-attach-daemon — same as --attach-daemon but 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 — do not change the stdin of external daemons to /dev/null
--attach-daemon2 — the attach-daemon keyval variant (supports smart modes too)
--plugins — load uWSGI plugins 🔌
--plugin — load uWSGI plugins
--need-plugins — load uWSGI plugins (exit on error)
--need-plugin — load uWSGI plugins (exit on error)
--plugins-dir — add a directory to the uWSGI plugin search path
--plugin-dir — add a directory to the uWSGI plugin search path
--plugins-list — list enabled plugins
--plugin-list — list enabled plugins (you get the pattern by now, bestie 💅)
--autoload — try to automatically load plugins when unknown options show up
--dlopen — blindly load a shared library 🙈
--allowed-modifiers — 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 (useful for building external plugins)
--dot-h — dump the uwsgi.h used for building the core (useful for building external plugins)
--config-py — dump the uwsgiconfig.py used for building the core (useful for building external plugins)
--build-plugin — build a uWSGI plugin for the current binary
--version — print uWSGI version
--response-headers-limit — set response header maximum size (default: 64k)

🌈 python options, the moment you've been waiting for 🌈

--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 — add a directory (or glob) to pythonpath
--python-path — add a directory (or glob) to pythonpath
--pp — add a directory (or glob) to pythonpath (the short lil king 👑)
--pymodule-alias — add a python alias module
--post-pymodule-alias — add a python module alias after uwsgi module initialization
--import — import a python module
--pyimport — import a python module
--py-import — import a python module
--python-import — import a python module
--shared-import — import a python module in all of the processes
--shared-pyimport — import a python module in all of the processes
--shared-py-import — import a python module in all of the processes
--shared-python-import — import a python module in all of the processes
--spooler-import — bestie, this one imports a python module in the spooler ✨
--spooler-pyimport — same energy, imports a python module in the spooler 💅
--spooler-py-import — yes it's the same thing again, imports a python module in the spooler 🫶
--spooler-python-import — the fourth twin!! also imports a python module in the spooler 🎀

four spellings, one job, we love an alias moment 🦋

--pyargv — manually set sys.argv. you're the one writing the script's origin story now, no cap 📝
-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 a uwsgi section 💖
--ini-paste-logged — load a paste.deploy config file containing a uwsgi section, and load the loggers too 🗂️
--reload-os-env — force reload of os.environ at each request 😮‍💨 literally every single request, she's thorough
--no-site — do not import the site module 🚫
--pyshell — run an interactive python shell in the uWSGI environment 🐚 so iconic
--pyshell-oneshot — run an interactive python shell in the uWSGI environment, but the one-shot variant 🎯
--python — run a python script in the uWSGI environment 🐍
--py — run a python script in the uWSGI environment (short king version) 👑
--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, bestie. this is not a production girlie 🙈

--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 the auto-reload scan. can be specified multiple times, so go off, list as many as you want 📝✨
--wsgi-env-behaviour — set the strategy for allocating/deallocating the WSGI env 🧠
--wsgi-env-behavior — set the strategy for allocating/deallocating the WSGI env (american spelling said hi) 🇺🇸
--start_response-nodelay — send WSGI http headers as soon as possible

heads up, this is a PEP violation ⚠️ iconic of her honestly

--wsgi-strict — try to be fully PEP compliant by 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 (plural edition, same vibes) 🧺🧺
--wsgi-disable-file-wrapper — disable the wsgi.file_wrapper feature 🚫📦
--python-version — report python version 🔢
--python-raw — load a python file for managing raw requests 🪵
--py-sharedarea — create a sharedarea from a python bytearray object of the specified size 🧩
--py-call-osafterfork — enable child processes running cpython to trap OS signals 🪤
--python-worker-override — override worker with the specified python script 🔄
--py-executable — override sys.executable value 🛠️
--py-sys-executable — override sys.executable value (same thing, different name, we love a duo) 🛠️🛠️

and that's a wrap on the whole page, bestie!! 🎀 you just read the manual for uwsgi_python310, version 2.0.20-debian, dated March 2022 — go forth, run your python, and remember: no auto-reload in production, that's the rule 💖✨🦋

📦 where this page comes from

ubuntu jammy: uwsgi-plugin-python3 2.0.20-4 · 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