UWSGI_PYTHON3(1)

📦

version 2.0.31+6+0.0.3 · 4 versions

2.0.31+6+0.0.3 · ubuntu stonking (latest)
2.0.29+1build1+0.0.2build2 · ubuntu questing
2.0.31+3+0.0.2build4 · ubuntu resolute
2.0.28+8+0.0.2+b1 · debian trixie

🌸 UWSGI_PYTHON3 🌸

okay bestie, gather round 💖 this is the man page for uwsgi_python3 — a.k.a. the "fast (pure C), self-healing, developer-friendly WSGI server". Yes that is its whole personality. Pure C. Self-healing. Developer-friendly. It's giving main character energy and I'm obsessed 🫶

✨ SYNOPSIS ✨

uwsgi-core [options...]

That's it. That's the whole vibe. You just throw options at it and it does stuff. Slay.

💅 DESCRIPTION 💅

okay so this is the big section and it's literally just a giant list of every option you can pass. There are SO many. buckle up, we're going through all of them, no skipping, periodt. ✨

🦋 sockets (the "where do I listen" era)

-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 & harakiri (the chaos management era)

-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

ngl "harakiri" is a whole mood 💀 it's the thing that kills a worker that's taking too long. dramatic but necessary.

🎀 config loading & placeholders

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

ok "sytax" 💀 that is literally how it's spelled in here, I'm not making this up, I'm just the messenger bestie

🧚 opt logic (yes, there's a whole mini language in here)

--for — (opt logic) for cycle
--for-glob — (opt logic) for cycle (expand glob)
--for-times — (opt logic) for cycle (expand the specified num to a list starting from 1)
--for-readline — (opt logic) for cycle (expand the specified file to a list of lines)
--endfor — (opt logic) end for cycle
--end-for — (opt logic) end for cycle
--if-opt — (opt logic) check for option
--if-not-opt — (opt logic) check for option
--if-env — (opt logic) check for environment variable
--if-not-env — (opt logic) check for environment variable
--ifenv — (opt logic) check for environment variable
--if-reload — (opt logic) check for reload
--if-not-reload — (opt logic) check for reload
--if-hostname — (opt logic) check for hostname
--if-not-hostname — (opt logic) check for hostname
--if-hostname-match — (opt logic) try to match hostname against a regular expression
--if-not-hostname-match — (opt logic) try to match hostname against a regular expression
--if-exists — (opt logic) check for file/directory existence
--if-not-exists — (opt logic) check for file/directory existence
--ifexists — (opt logic) check for file/directory existence
--if-plugin — (opt logic) check for plugin
--if-not-plugin — (opt logic) check for plugin
--ifplugin — (opt logic) check for plugin
--if-file — (opt logic) check for file existence
--if-not-file — (opt logic) check for file existence
--if-dir — (opt logic) check for directory existence
--if-not-dir — (opt logic) check for directory existence
--ifdir — (opt logic) check for directory existence
--if-directory — (opt logic) check for directory existence
--endif — (opt logic) end if
--end-if — (opt logic) end if

periodt. that's a full if/for language living inside your config file. iconic behavior honestly 💜

💜 blacklist / whitelist

--blacklist — set options blacklist context
--end-blacklist — clear options blacklist context
--whitelist — set options whitelist context
--end-whitelist — clear options whitelist context

🔥 errors & signals (the "please stop yelling at me" era)

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

bestie note: the word "annoying" is their word, not mine, they're literally in the source. relatable tho 🙈

🩷 config templates & 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)

👑 daemon / 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 & sizing

-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

🎀 socket modes & permissions

-c, --cgi-mode — force CGI-mode for plugins supporting it
-a, --abstract-socket — force UNIX socket in abstract mode (Linux only)
-C, --chmod-socket — chmod-socket
-C, --chmod — chmod-socket
--chown-socket — chown unix sockets
--umask — set umask
--freebind — put socket in freebind mode
--map-socket — map sockets to specific workers

🫶 threads & process names

-T, --enable-threads — enable threads (stub option this is true by default)
--no-threads-wait — do not wait for threads cancellation on quit/reload
--auto-procname — automatically set processes name to something meaningful
--procname-prefix — add a prefix to the process names
--procname-prefix-spaced — add a spaced prefix to the process names
--procname-append — append a string to process names
--procname — set process names
--procname-master — set master process name

⭐ app loading & master

-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 called that, and it's not beating the allegations)

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

"cursed vassals" 😭 that's a real option. I have no notes. absolute cinema.

ok that's part 1 bestie, and there is so much more coming — don't go anywhere 💖✨

okay so continuing the options, bestie — there's a LOT, but we're slaying through it 💅

--emperor-pidfile — writes the Emperor pid into the file u specify 📝
--emperor-tyrant — puts the Emperor in Tyrant mode 👑
--emperor-tyrant-nofollow — does not follow symlinks when checking for uid/gid in Tyrant mode 🚫🔗
--emperor-stats — runs the Emperor stats server 📊
--emperor-stats-server — runs the Emperor stats server ✨
--early-emperor — spawns the emperor as soon as possible 🐣
--emperor-broodlord — runs the emperor in BroodLord mode 🐝
--emperor-throttle — sets the throttling level (in milliseconds) for bad behaving vassals (default 1000) ⏳
--emperor-max-throttle — sets the 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 🧐
--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 🪄
--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) 💫
--emperor-no-blacklist — disables 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 🗂️
--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 🔄
--max-requests-delta — adds (worker_id * delta) to the max_requests value of each worker 🔢
--min-worker-lifetime — number of seconds worker must run before being reloaded (default is 10) ⏳
--max-worker-lifetime — 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 — does 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 — does chroot() to the specified directory 📦
--pivot-root — does pivot_root() to the specified directories (new_root and put_old must be separated with a space) 🔄
--pivot_root — does pivot_root() to the specified directories (new_root and put_old must be separated with a space) 🌀
--uid — does setuid to the specified user/uid 👤
--gid — does setgid to the specified group/gid 👥
--add-gid — adds the specified group id to the process credentials ➕👥
--immediate-uid — does setuid to the specified user/uid IMMEDIATELY ⚡
--immediate-gid — does setgid to the specified group/gid IMMEDIATELY ⚡👥
--no-initgroups — disables additional groups set via initgroups() 🚫
--cap — sets process capability 🎩
--unshare — does unshare() part of the processes and puts it in a new namespace 🌌
--unshare2 — does 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 this whole instance as jailed ✨ (which means the post_jail hooks get forced to actually run, no skipping).
--refork — does a fork() all over again after privileges drop. Super handy for jailing systems.
--re-fork — bestie this is literally the same thing as --refork: fork() again after privileges drop, for jailing systems. 💅
--refork-as-root — fork() again, but this time before privileges drop. Jailing systems love this one.
--re-fork-as-root — same vibe as --refork-as-root, spelled different: fork() again before privileges drop, for jailing systems.
--refork-post-jail — fork() again after jailing. Yes, again for jailing systems. It's giving fork-obsessed. 🍴
--re-fork-post-jail — the twin of --refork-post-jail: fork() again after jailing, for jailing systems.
--hook-asap — runs whatever hook you specified as soon as possible. No waiting. Girlies with no chill. ⚡
--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 inside the jail, after initialization.
--hook-as-root — run the specified hook before privileges drop (so, as root 👑).
--hook-as-user — run the specified hook after privileges drop (hi, unprivileged era).
--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 every single fork. 🍴✨
--hook-accepting — run the specified hook after each worker enters the accepting phase.
--hook-accepting1 — run the specified hook after the first worker enters the accepting phase.
--hook-accepting-once — run the specified hook after each worker enters the accepting phase, but only once per-instance.
--hook-accepting1-once — run the specified hook after the first worker enters the accepting phase, once per instance. One and done, periodt.
--hook-master-start — run the specified hook when the Master starts. 🫡
--hook-touch — run the specified hook when the specified file is touched. Syntax is literally: <file> <action>
--hook-emperor-start — run the specified hook when the Emperor starts. 👑✨
--hook-emperor-stop — run the specified hook when the Emperor sends a stop message.
--hook-emperor-reload — run the specified hook when the Emperor sends a reload message.
--hook-emperor-lost — run the specified hook when the Emperor connection is lost. 😭
--hook-as-vassal — run the specified hook before exec()ing the vassal.
--hook-as-emperor — run the specified hook in the emperor after the vassal has been started.
--hook-as-mule — run the specified hook in each mule. 🐴
--hook-as-gateway — run the specified hook in each gateway.
--after-request-hook — run the specified function/symbol after each request.
--after-request-call — run the specified function/symbol after each request. (Same energy, different flag name.)

--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 the 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 the filesystem as soon as possible. ⚡
--mount-pre-jail — mount the filesystem before jailing.
--mount-post-jail — mount the filesystem after jailing.
--mount-in-jail — mount the filesystem in the jail, after initialization.
--mount-as-root — mount the filesystem before privileges drop.
--mount-as-vassal — mount the filesystem before exec()ing the vassal.
--mount-as-emperor — mount the filesystem in the emperor after the vassal has been started.
--umount-asap — unmount the filesystem as soon as possible. 🫶
--umount-pre-jail — unmount the filesystem before jailing.
--umount-post-jail — unmount the filesystem after jailing.
--umount-in-jail — unmount the filesystem in the jail, after initialization.
--umount-as-root — unmount the filesystem before privileges drop.
--umount-as-vassal — unmount the filesystem before exec()ing the vassal.
--umount-as-emperor — unmount the 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. (Same thing, shorter name.)
--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. (Yes, another alias. They're multiplying.)
--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 the 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.

See the pattern? The number in the name is how many args your function takes. 1 = one arg, 3 = three, 4 = four, and no number = no args. iykyk 🧚

--ini — load config from an ini file. (The classic.)
-y, --yaml — load config from a yaml file. 🌸
-y, --yml — load config from a yaml file. (Same short flag -y, same vibe.)
-j, --json — load config from a json file.
-j, --js — load config from a json file. (Yeah, --js is just --json wearing a different fit.)
--weight — weight of the instance (used by clustering/lb/subscriptions).
--auto-weight — set the weight of the instance automatically (used by clustering/lb/subscriptions). 🤖
--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. (Four flags, one syscall option. It's giving "we couldn't pick a name". 💀)
--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 the specified megabytes.
--reload-on-rss — reload if rss memory is higher than the specified megabytes.
--evil-reload-on-as — force the master to reload a worker if its address space is higher than the specified megabytes. 😈
--evil-reload-on-rss — force the master to reload a worker if its rss memory is higher than the 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) the 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 a command when the specified file is modified/touched. Syntax: file command

Not me noticing that the whole touch-* crew is just "poke a file, get a behaviour". Chef's kiss. 👑

--touch-signal — watcher vibes ✨ when the file you named gets modified/touched, it fires a signal (syntax: file signal)
--fs-reload — when that filesystem object gets modified, we do a graceful reload 💅
--fs-brutal-reload — same energy but brutal reload when the filesystem object changes 😤
--fs-signal — raise a uwsgi signal when the filesystem object is modified (syntax: file signal)
--check-mountpoint — if a filesystem is no longer reachable, the instance gets destroyed. Lowkey perfect for reliable Fuse management 🫶
--mountpoint-check — same thing, different name: destroy the instance if a filesystem is no more reachable (handy for reliable Fuse management)
--check-mount — yep, also the same: destroy the instance if a filesystem is no more reachable (great for reliable Fuse management)
--mount-check — one more alias, bestie: destroy the instance if a filesystem is no more reachable (for reliable Fuse management) 🦋
--propagate-touch — the over-engineering option, periodt. For systems with flaky signal management 🙈
--limit-post — cap the request body, no exceptions
--no-orphans — automatically kill workers if the master dies (ngl this can be dangerous for availability ⚠️)
--prio — set processes/threads priority
--cpu-affinity — set cpu affinity, pin those babies down 📌
--post-buffering — set the size in bytes after which it will buffer to disk instead of memory 💾
--post-buffering-bufsize — set the buffer size for read() in post buffering mode
--body-read-warning — set the amount of allowed memory allocation (in megabytes) for a request body before it starts printing a warning 👀
--upload-progress — turns on creation of .json files in the directory you specify, during a file upload
--no-default-app — do not fallback to the default app
--manage-script-name — automatically rewrite SCRIPT_NAME and PATH_INFO
--ignore-script-name — ignore SCRIPT_NAME
--catch-exceptions — report the exception as http output (discouraged, use only for testing 🧪)
--reload-on-exception — reload a worker when an exception is raised
--reload-on-exception-type — reload a worker when a specific exception type is raised
--reload-on-exception-value — reload a worker when a specific exception value is raised
--reload-on-exception-repr — reload a worker when a specific exception type+value (language-specific) is raised
--exception-handler — add an exception handler 🫶
--enable-metrics — turn on the metrics subsystem
--metric — add a custom metric ✨
--metric-threshold — add a metric threshold/alarm 🚨
--metric-alarm — add a metric threshold/alarm (same thing, different outfit)
--alarm-metric — add a metric threshold/alarm (third alias, iconic)
--metrics-dir — export metrics as text files into the directory you name
--metrics-dir-restore — restore the 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 address you give it 📡
--stats — enable the stats server on the specified address
--stats-server — enable the stats server on the specified address (twin flame behavior 💜)
--stats-http — prefix stats server json output with http headers
--stats-minified — minify the statistics json output
--stats-min — minify statistics json output (same, shorter, cuter)
--stats-push — push the stats json to the destination you specify
--stats-pusher-default-freq — set the default frequency of stats pushers
--stats-pushers-default-freq — set the default frequency of stats pushers (plural edition 🎀)
--stats-no-cores — disable generation of cores-related stats
--stats-no-metrics — do not include metrics in 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 👑
--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 💀
--legion-skew-tolerance — set the clock skew tolerance of the legion subsystem (default 60 seconds)
--legion-lord — action to call on Lord election
--legion-unlord — action to call on Lord dismiss
--legion-setup — action to call on legion setup
--legion-death — action to call on legion death (shutdown of the instance)
--legion-join — action to call on legion join (the first time quorum is reached)
--legion-node-joined — action to call when a new node joins the legion
--legion-node-left — action to call when a node leaves 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 (shortest king 👑)
--subscribe — subscribe to the specified subscription server
--subscribe2 — subscribe to the specified subscription server using advanced keyval syntax ✨
--subscribe-freq — send the 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
--start-unsubscribed — configure subscriptions but do not send them (so useful with master fifo)
--subscribe-with-modifier1 — force the specified modifier1 when subscribing
--snmp — enable the embedded snmp server
--snmp-community — set the snmp community string
--ssl-verbose — be verbose about SSL errors 📢
--ssl-verify-depth — set the maximum certificate verification depth
--sni — add an SNI-governed SSL context
--sni-dir — check for the cert/key/client_ca file in the specified directory and create a sni/ssl context on demand
--sni-dir-ciphers — set the ssl ciphers for the sni-dir option
--ssl-enable3 — enable SSLv3 (insecure ⚠️)
--ssl-enable-sslv3 — enable SSLv3 (insecure ⚠️)
--ssl-enable-tlsv1 — enable TLSv1 (insecure ⚠️)
--ssl-option — set a raw ssl option (numeric value, bestie 🔢)
--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 the 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 number of cores you specify
--max-fd — set the maximum number of file descriptors (requires root privileges 🔐)
--logto — set the logfile/udp address
--logto2 — log to the specified file or udp address after privileges drop
--log-format — set the advanced format for request logging
--logformat — set the advanced format for request logging (alias bestie)
--logformat-strftime — apply strftime to logformat output
--log-format-strftime — apply strftime to logformat output (same thing, different spelling 💅)
--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 the enabled loggers 🗒️
--loggers-list — list the 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 (i.e. do not show) log lines matching the regexp you give
--log-filter — show only the log lines matching the specified regexp
--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> 🚨

okay so the options keep coming and now we're deep in alarm + logging + routing territory, so grab a snack bestie, we're going through every single one 💖

--alarm-cheap — use the main alarm thread instead of spinning up dedicated threads for curl-based alarms (no extra thread babies, the main one handles it) 🧵
--alarm-freq — tune the anti-loop alarm system (default 3 seconds). yes it's literally watching out for loops, iconic behaviour tbh
--alarm-fd — raise the specified alarm when an fd is read for read. by default it reads 1 byte, so set 8 for eventfd 💅
--alarm-segfault — raise the specified alarm when the segmentation fault handler is executed 😭
--segfault-alarm — raise the specified alarm when the segmentation fault handler is executed (same vibe, different spelling, she contains multitudes)
--alarm-backlog — raise the specified alarm when the socket backlog queue is full 🫠
--backlog-alarm — raise the specified alarm when the socket backlog queue is full
--lq-alarm — raise the specified alarm when the socket backlog queue is full
--alarm-lq — raise the specified alarm when the socket backlog queue is full
--alarm-listen-queue — raise the specified alarm when the socket backlog queue is full
--listen-queue-alarm — raise the specified alarm when the socket backlog queue is full (six names, one job, that's range ✨)
--log-alarm — raise the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp>
--alarm-log — raise the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp>
--not-log-alarm — skip the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp>
--not-alarm-log — skip the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp>
--alarm-list — list enabled alarms 🔔
--alarms-list — list enabled alarms (plural bestie, we love options)
--alarm-msg-size — set the max size of an alarm message (default 8192)

--log-master — delegate logging to the master process 👑
--log-master-bufsize — set the buffer size for the master logger. bigger log messages will be truncated 💀
--log-master-stream — create the master logpipe as SOCK_STREAM
--log-master-req-stream — create the master requests logpipe as SOCK_STREAM
--log-reopen — reopen log after reload 🦋
--log-truncate — truncate log on startup
--log-maxsize — set maximum logfile size
--log-backupname — set logfile name after rotation
--logdate — prefix logs with date or a strftime string 📅
--log-date — prefix logs with date or a strftime string
--log-prefix — prefix logs with a string
--log-zero — log responses without body
--log-slow — log requests slower than the specified number of milliseconds 🐌
--log-4xx — log requests with a 4xx response
--log-5xx — log requests with a 5xx response
--log-big — log requests bigger than the specified size
--log-sendfile — log sendfile requests
--log-ioerror — log requests with io errors
--log-micros — report response time in microseconds instead of milliseconds ⏱️
--log-x-forwarded-for — use the ip from X-Forwarded-For header instead of REMOTE_ADDR

--master-as-root — leave master process running as root. (yes, everyone's fave thing to do, proceed accordingly) 🔥
--drop-after-init — run privileges drop after plugin initialization, superseded by drop-after-apps
--drop-after-apps — run privileges drop after apps loading, superseded by master-as-root
--force-cwd — force the initial working directory to the specified value
--binsh — override /bin/sh (used by exec hooks, it always fallback to /bin/sh, so don't stress)
--chdir — chdir to specified directory before apps loading
--chdir2 — chdir to specified directory after apps loading
--lazy — set lazy mode (load apps in workers instead of master) 😴
--lazy-apps — load apps in each worker instead of the master
--cheap — set cheap mode (spawn workers only after the first request) 💸
--cheaper — set cheaper mode (adaptive process spawning)
--cheaper-initial — set the initial number of processes to spawn in cheaper mode
--cheaper-algo — choose to algorithm used for adaptive process spawning
--cheaper-step — number of additional processes to spawn at each overload
--cheaper-overload — increase workers after specified overload
--cheaper-algo-list — list enabled cheapers algorithms
--cheaper-algos-list — list enabled cheapers algorithms
--cheaper-list — list enabled cheapers algorithms
--cheaper-rss-limit-soft — don't spawn new workers if total resident memory usage of all workers is higher than this limit
--cheaper-rss-limit-hard — if total workers resident memory usage is higher try to stop workers
--idle — set idle mode (put uWSGI in cheap mode after inactivity) 🛋️
--die-on-idle — shutdown uWSGI when idle 💀
--mount — load application under mountpoint
--worker-mount — load application under mountpoint in the specified worker or after workers spawn
--threads — run each worker in prethreaded mode with the specified number of threads 🧵
--thread-stacksize — set threads stacksize
--threads-stacksize — set threads stacksize
--thread-stack-size — set threads stacksize
--threads-stack-size — set threads stacksize
--vhost — enable virtualhosting mode (based on SERVER_NAME variable) 🏠
--vhost-host — enable virtualhosting mode (based on HTTP_HOST variable)

okay now the routing section, and bestie there are so many of these. every single one is here, we are not skipping a crumb 🍓

--route — add a route 🛤️
--route-host — add a route based on Host header
--route-uri — add a route based on REQUEST_URI
--route-qs — add a route based on QUERY_STRING
--route-remote-addr — add a route based on REMOTE_ADDR
--route-user-agent — add a route based on HTTP_USER_AGENT
--route-remote-user — add a route based on REMOTE_USER
--route-referer — add a route based on HTTP_REFERER
--route-label — add a routing label (for use with goto)
--route-if — add a route based on condition
--route-if-not — add a route based on condition (negate version) 🙃
--route-run — always run the specified route action
--final-route — add a final route 🏁
--final-route-status — add a final route for the specified status
--final-route-host — add a final route based on Host header
--final-route-uri — add a final route based on REQUEST_URI
--final-route-qs — add a final route based on QUERY_STRING
--final-route-remote-addr — add a final route based on REMOTE_ADDR
--final-route-user-agent — add a final route based on HTTP_USER_AGENT
--final-route-remote-user — add a final route based on REMOTE_USER
--final-route-referer — add a final route based on HTTP_REFERER
--final-route-label — add a final routing label (for use with goto)
--final-route-if — add a final route based on condition
--final-route-if-not — add a final route based on condition (negate version)
--final-route-run — always run the specified final route action
--error-route — add an error route 🚨
--error-route-status — add an error route for the specified status
--error-route-host — add an error route based on Host header
--error-route-uri — add an error route based on REQUEST_URI
--error-route-qs — add an error route based on QUERY_STRING
--error-route-remote-addr — add an error route based on REMOTE_ADDR
--error-route-user-agent — add an error route based on HTTP_USER_AGENT
--error-route-remote-user — add an error route based on REMOTE_USER
--error-route-referer — add an error route based on HTTP_REFERER
--error-route-label — add an error routing label (for use with goto)
--error-route-if — add an error route based on condition
--error-route-if-not — add an error route based on condition (negate version)
--error-route-run — always run the specified error route action
--response-route — add a response route 💌
--response-route-status — add a response route for the specified status
--response-route-host — add a response route based on Host header
--response-route-uri — add a response route based on REQUEST_URI
--response-route-qs — add a response route based on QUERY_STRING
--response-route-remote-addr — add a response route based on REMOTE_ADDR
--response-route-user-agent — add a response route based on HTTP_USER_AGENT
--response-route-remote-user — add a response route based on REMOTE_USER
--response-route-referer — add a response route based on HTTP_REFERER
--response-route-label — add a response routing label (for use with goto)
--response-route-if — add a response route based on condition
--response-route-if-not — add a response route based on condition (negate version)
--response-route-run — always run the specified response route action
--router-list — list enabled routers 📋
--routers-list — list enabled routers

--error-page-403 — add an error page (html) for managed 403 response
--error-page-404 — add an error page (html) for managed 404 response
--error-page-500 — add an error page (html) for managed 500 response

--websockets-ping-freq — set the frequency (in seconds) of websockets automatic ping packets 🏓
--websocket-ping-freq — set the frequency (in seconds) of websockets automatic ping packets
--websockets-pong-tolerance — set the tolerance (in seconds) of websockets ping/pong subsystem
--websocket-pong-tolerance — set the tolerance (in seconds) of websockets ping/pong subsystem
--websockets-max-size — set the max allowed size of websocket messages (in Kbytes, default 1024) 📦
--websocket-max-size — set the max allowed size of websocket messages (in Kbytes, default 1024)
--chunked-input-limit — set the max size of a chunked input part (default 1MB, in bytes)
--chunked-input-timeout — set default timeout for chunked input ⏳
--clock — set a clock source 🕰️
--clock-list — list enabled clocks

and we are still going, don't go anywhere bestie, there's more coming 💜

--clocks-list — lists all the enabled clocks, fr fr ⏰
--add-header — auto-magically adds HTTP headers to the response ✨
--rem-header, --del-header — both remove a specified HTTP header from the response, no cap 🚫
--collect-header, --response-header-collect — stashes the specified response header in a request var (syntax: header var) 📥
--pull-header — stashes the specified response header in a request var AND removes it from the response (syntax: header var) 💅
--check-static, --static-check — checks for static files in the specified directory 🔍
--check-static-docroot — checks for static files in the requested DOCUMENT_ROOT 📂
--static-map — maps a mountpoint to a static directory (or file) 🗺️
--static-map2 — like --static-map but completely appends the requested resource to the docroot, periodt 🗂️
--static-skip-ext — skips the specified extension from static file checks 🙈
--static-index — searches for the specified file if a directory is requested 🔎
--static-safe — skips security checks if the file is under the specified path 🛡️
--static-cache-paths — puts resolved paths in the uWSGI cache for the specified amount of seconds ⏳
--static-cache-paths-name — uses the specified cache for static paths 🏷️
--mimefile, --mime-file — sets the mime types file path (default /etc/mime.types) 📄
--static-expires-type — sets the Expires header based on content type 📅
--static-expires-type-mtime — sets the Expires header based on content type and file mtime 🕰️
--static-expires — sets the Expires header based on filename regexp 🗓️
--static-expires-mtime — sets the Expires header based on filename regexp and file mtime ⏲️
--static-expires-uri — sets the Expires header based on REQUEST_URI regexp 🌐
--static-expires-uri-mtime — sets the Expires header based on REQUEST_URI regexp and file mtime 🕒
--static-expires-path-info — sets the Expires header based on PATH_INFO regexp 🛤️
--static-expires-path-info-mtime — sets the Expires header based on PATH_INFO regexp and file mtime ⏱️
--static-gzip — if the supplied regexp matches the static file translation, it will search for a gzip version 🗜️
--static-gzip-all — checks for a gzip version of all requested static files, all of them 💯
--static-gzip-dir, --static-gzip-prefix — checks for a gzip version of all requested static files in the specified dir/prefix 📁
--static-gzip-ext, --static-gzip-suffix — checks for a gzip version of all requested static files with the specified ext/suffix 📎
--honour-range — enables support for the HTTP Range header 📏
--offload-threads, --offload-thread — sets the number of offload threads to spawn (per-worker, default 0) 🧵
--file-serve-mode, --fileserve-mode — sets the static file serving mode 🖥️
--disable-sendfile — disables sendfile() and relies on boring read()/write() 😴
--check-cache — checks for response data in the specified cache (empty for default cache) 🗃️
--close-on-exec — sets close-on-exec on connection sockets (could be required for spawning processes in requests) 🔒
--close-on-exec2 — sets close-on-exec on server sockets (could be required for spawning processes in requests) 🔐
--mode — sets uWSGI custom mode 🎛️
--env — sets an environment variable 🌍
--envdir — loads a daemontools compatible envdir 📂
--early-envdir — loads a daemontools compatible envdir ASAP ⚡
--unenv — unsets an environment variable 🚫
--vacuum — tries to remove all of the generated file/sockets 🧹
--file-write — writes the specified content to the specified file (syntax: file=value) before privileges drop ✍️
--cgroup — puts the processes in the specified cgroup 👨‍👩‍👧‍👦
--cgroup-opt — sets a value in the specified cgroup option ⚙️
--cgroup-dir-mode — sets permission for cgroup directory (default is 700) 🔑
--namespace, --ns — runs in a new namespace under the specified rootfs 🪐
--namespace-keep-mount — keeps the specified mountpoint in your namespace 📌
--namespace-net, --ns-net — adds a network namespace 🌐
--enable-proxy-protocol — enables PROXY1 protocol support (only for http parsers) 🔀
--reuse-port — enables REUSE_PORT flag on the socket (BSD only) 🔄
--tcp-fast-open, --tcp-fastopen — enables TCP_FASTOPEN flag on TCP sockets with the specified qlen value 🚀
--tcp-fast-open-client, --tcp-fastopen-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported 📡
--zerg — attaches to a zerg server 👾
--zerg-fallback — falls back to normal sockets if the zerg server is not available 🏳️
--zerg-server — enables the zerg server on the specified UNIX socket 🐛
--cron — adds a cron task ⏰
--cron2 — adds a cron task (key=val syntax) 🔑
--unique-cron — adds a unique cron task 🦄
--cron-harakiri — sets the maximum time (in seconds) we wait for a cron command to complete ⏳
--legion-cron, --cron-legion — adds a cron task runnable only when the instance is a lord of the specified legion 👑
--unique-legion-cron, --unique-cron-legion — adds a unique cron task runnable only when the instance is a lord of the specified legion 🦄👑
--loop — selects the uWSGI loop engine 🔁
--loop-list, --loops-list — lists enabled loop engines 📋
--worker-exec — runs the specified command as a worker 🏃
--worker-exec2 — runs the specified command as a worker (after post_fork hook) 🏃‍♀️
--attach-daemon — attaches a command/daemon to the master process (the command has to not go in background) 👯
--attach-control-daemon — attaches 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 — attaches a command/daemon to the master process managed by a pidfile (the command has to daemonize) 🧠
--smart-attach-daemon2 — attaches 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 runs only on legion lord node 👑
--legion-smart-attach-daemon — same as --smart-attach-daemon but the daemon runs only on legion lord node 👑🧠
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2 but the daemon runs only on legion lord node 👑🧠🚫
--daemons-honour-stdin — does not change the stdin of external daemons to /dev/null 🎤
--attach-daemon2 — attach-daemon keyval variant (supports smart modes too) 🗝️
--plugins, --plugin — loads uWSGI plugins 🔌
--need-plugins, --need-plugin — loads uWSGI plugins (exit on error) 🔌💥
--plugins-dir, --plugin-dir — adds a directory to the uWSGI plugin search path 📁
--plugins-list, --plugin-list — lists enabled plugins 📃
--autoload — tries to automatically load plugins when unknown options are found 🤖
--dlopen — blindly loads a shared library 🎲
--allowed-modifiers — comma separated list of allowed modifiers ✅
--remap-modifier — remaps request modifier from one id to another 🔀
--dump-options — dumps the full list of available options 📜
--show-config — shows the current config reformatted as ini 📝
--binary-append-data — returns the content of a resource to stdout for appending to a uwsgi binary (for data:// usage) 📎
--print — simple print 🖨️
--iprint — simple print (immediate version) 🖨️⚡
--exit — forces exit() of the instance 🚪
--cflags — reports uWSGI CFLAGS (useful for building external plugins) 🛠️
--dot-h — dumps the uwsgi.h used for building the core (useful for building external plugins) 📄
--config-py — dumps the uwsgiconfig.py used for building the core (useful for building external plugins) 🐍
--build-plugin — builds a uWSGI plugin for the current binary 🏗️
--version — prints uWSGI version 🏷️
--response-headers-limit — sets response header maximum size (default: 64k) 📏

and that's a wrap, bestie! this was uwsgi_python3 2.0.31-6 from July 2026 — go slay some uWSGI configs, mwah 💋✨

📦 where this page comes from

ubuntu stonking: uwsgi-plugin-python3 2.0.31+6+0.0.3 · GPL-3.0-or-later
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-11-02: a language model's rewrite of the original, under its terms