UWSGI-CORE(1)

📦

version 2.0.31 · 7 versions

💖 uwsgi-core(1) 💖

okay bestie, welcome to the uwsgi-core manual page (that's the manual name, and no we're not gonna pretend we're above introducing it). this is part 1 of 6, so buckle up, hydrate, and let's get into it 🫶

✨ NAME ✨

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

like. it's a WSGI server. it's pure C. it heals itself. it's friendly to developers. the whole package, no notes 💅

🌸 SYNOPSIS 🌸

uwsgi-core [options...]

that's it. that's the whole invocation. you just throw options... at it and it goes ✨

🦋 DESCRIPTION 🦋

so basically uWSGI has a lot of options, and this is where they all live. think of this section as the group chat where every flag gets its moment. let's go one by one, no skipping, we do not leave anyone on read 💜

🔌 sockets, the main character energy 🔌

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

so many protocols bestie, it's giving versatility 🔥

👑 workers & harakiri (yes that's really the name) 👑

-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

"harakiri" is the timeout that takes a worker out back when it's acting up, and honestly? dramatic but fair 💀

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

ngl the word "sytax" is right there in the original and we are preserving it exactly, character for character, because facts stay facts even when they're a lil typo 🙈

🧚 opt logic, aka the if/for girlies 🧚

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

the way you can write conditionals and loops inside your config file?? it's giving programming language but make it config ✨

🎀 lists & write-error behaviour 🎀

--blacklist — set options blacklist context
--end-blacklist — clear options blacklist context
--whitelist — set options whitelist context
--end-whitelist — clear options whitelist context
--ignore-sigpipe — do not report (annoying) SIGPIPE
--ignore-write-errors — do not report (annoying) write()/writev() errors
--write-errors-tolerance — set the maximum number of allowed write errors (default: no tolerance)
--write-errors-exception-only — only raise an exception on write errors giving control to the app itself
--disable-write-exception — disable exception generation on write()/writev()

the default here is no tolerance, so if you want any wiggle room at all you gotta set it yourself. she is strict 💅

🌈 templating & includes 🌈

--inherit — use the specified file as config template
--include — include the specified file as immediate configuration
--inject-before — inject a text file before the config file (advanced templating)
--inject-after — inject a text file after the config file (advanced templating)

advanced templating bestie, we love a config that composes 🦋

💜 daemonizing & instance control 💜

-d, --daemonize — daemonize uWSGI
--daemonize2 — daemonize uWSGI after app loading
--stop — stop an instance
--reload — reload an instance
--pause — pause an instance
--suspend — suspend an instance
--resume — resume an instance
--connect-and-read — connect to a socket and wait for data from it
--extract — fetch/dump any supported address to stdout

main character energy: she can stop, reload, pause, suspend and resume herself. obsessed 😭

⭐ sizes, buffers & socket tweaks ⭐

-l, --listen — set the socket listen queue size
-v, --max-vars — set the amount of internal iovec/vars structures
--max-apps — set the maximum number of per-worker applications
-b, --buffer-size — set internal buffer size
-m, --memory-report — enable memory report
--profiler — enable the specified profiler
-c, --cgi-mode — force CGI-mode for plugins supporting it
-a, --abstract-socket — force UNIX socket in abstract mode (Linux only)
-C, --chmod-socket — chmod-socket
-C, --chmod — chmod-socket
--chown-socket — chown unix sockets
--umask — set umask
--freebind — put socket in freebind mode
--map-socket — map sockets to specific workers

-a is Linux only, so don't come crying to her on macOS about abstract sockets 🍓

🧵 process names & threading 🧵

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

not me pointing out that -T|--enable-threads is a stub option and it's true by default 🙈 girl, you don't even need to ask.

👑 the Emperor (yes, capital E) 👑

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

she has an Emperor, she has vassals, she has cursed vassals and a tolerance setting for them 💀 that's not a server, that's a whole monarchy.

and that's part 1, bestie — the sockets, the workers, the opt logic, the Emperor, all of it. part 2 is coming, so don't go anywhere 💖

--emperor-pidfile — bestie, this one writes the Emperor pid into the file you point at 📝💖
--emperor-tyrant — puts the Emperor in Tyrant mode, no cap 👑😈
--emperor-tyrant-nofollow — in Tyrant mode, do not follow symlinks when checking uid/gid 🚫🔗
--emperor-stats — runs the Emperor stats server, it's giving observability 📊✨
--emperor-stats-server — runs the Emperor stats server, same vibe 📊✨
--early-emperor — spawns the emperor as soon as possible, main character energy ⏩
--emperor-broodlord — runs the emperor in BroodLord mode 🐉
--emperor-throttle — sets throttling level (in milliseconds) for bad behaving vassals — default is 1000 😤
--emperor-max-throttle — sets max throttling level (in milliseconds) for bad behaving vassals — default is 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 the Emperor blacklisting subsystem 🚫
--emperor-use-clone — uses clone() instead of fork(), passing the specified unshare() flags 🧬
--emperor-graceful-shutdown — uses vassals graceful shutdown during ragnarok 🌸
--emperor-cap — sets vassals capability 🛡️
--vassals-cap — sets vassals capability 🛡️
--vassal-cap — sets vassals capability 🛡️
--imperial-monitor-list — lists enabled imperial monitors 👀
--imperial-monitors-list — lists enabled imperial monitors 👀
--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 — chdir()s to specified directory before each spooler task 📂
--spooler-processes — sets the number of processes for spoolers 🧑🍳
--spooler-quiet — does not be verbose with spooler tasks 🤫
--spooler-max-tasks — sets the maximum number of tasks to run before recycling a spooler ♻️
--spooler-harakiri — sets harakiri timeout for spooler tasks 🗡️
--spooler-frequency — sets spooler frequency 📶
--spooler-freq — sets spooler frequency 📶
--mule — adds a mule 🐴
--mules — adds the specified number of mules 🐴🐴
--farm — adds a mule farm 🚜
--mule-msg-size — sets mule message buffer size 📨
--signal — sends a uwsgi signal to a server 📶
--signal-bufsize — sets buffer size for signal queue 📦
--signals-bufsize — sets buffer size for signal queue 📦
--signal-timer — adds a timer (syntax: <signal> <seconds>) ⏲️
--timer — adds a timer (syntax: <signal> <seconds>) ⏲️
--signal-rbtimer — adds a redblack timer (syntax: <signal> <seconds>) 🌳
--rbtimer — adds a redblack timer (syntax: <signal> <seconds>) 🌳
--rpc-max — maximum number of rpc slots — default: 64 🎰
-L|--disable-logging — disables request logging 🤐
--flock — locks the specified file before starting, exits if locked 🔒
--flock-wait — locks the specified file before starting, waits if locked ⏳
--flock2 — locks the specified file after logging/daemon setup, exits if locked 🔐
--flock-wait2 — locks the specified file after logging/daemon setup, waits if locked ⏳
--pidfile — creates pidfile (before privileges drop) 📝
--pidfile2 — creates pidfile (after privileges drop) 📝
--safe-pidfile — creates safe pidfile (before privileges drop) 🛡️📝
--safe-pidfile2 — creates safe pidfile (after privileges drop) 🛡️📝
--chroot — chroot()s to the specified directory 🏠
--pivot-root — pivot_root()s to the specified directories (new_root and put_old must be separated with a space) 🔄
--pivot_root — pivot_root()s to the specified directories (new_root and put_old must be separated with a space) 🔄
--uid — setuid to the specified user/uid 👤
--gid — setgid to the specified group/gid 👥
--add-gid — adds the specified group id to the process credentials ➕
--immediate-uid — setuid to the specified user/uid IMMEDIATELY 🚨
--immediate-gid — setgid to the specified group/gid IMMEDIATELY 🚨
--no-initgroups — disables additional groups set via initgroups() 🚫
--cap — sets process capability 🎩
--unshare — unshare()s part of the processes and puts it in a new namespace 🧩
--unshare2 — unshare()s 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 🗂️

okay so we're still deep in OPTIONS and this chunk is giving life-cycle cinematic universe: hooks, execs, mounts, waits, calls, and all the tuning knobs. no skipping, bestie, every single flag is getting its moment. 💅

--jailed — mark the instance as jailed, which forces the execution of post_jail hooks. 👑
--refork — fork() again after privileges drop. useful for jailing systems. 🧚
--re-fork — fork() again after privileges drop. useful for jailing systems. 🧚
--refork-as-root — fork() again before privileges drop. useful for jailing systems. 🧚
--re-fork-as-root — fork() again before privileges drop. useful for jailing systems. 🧚
--refork-post-jail — fork() again after jailing. useful for jailing systems. 🧚
--re-fork-post-jail — fork() again after jailing. useful for jailing systems. 🧚

and now the hooks — every one of these is literally "run the specified hook" but at a different moment. the timing is the whole personality. 🎀

--hook-asap — run the specified hook as soon as possible. ⚡
--hook-pre-jail — run the specified hook before jailing. 🔒
--hook-post-jail — run the specified hook after jailing. 🔓
--hook-in-jail — run the specified hook in jail after initialization. 🏠
--hook-as-root — run the specified hook before privileges drop. 👑
--hook-as-user — run the specified hook after privileges drop. 🫶
--hook-as-user-atexit — run the specified hook before app exit and reload. 😭
--hook-pre-app — run the specified hook before app loading. 📦
--hook-post-app — run the specified hook after app loading. ✨
--hook-post-fork — run the specified hook after each fork. 🍴
--hook-accepting — run the specified hook after each worker enter the accepting phase. 🎧
--hook-accepting1 — run the specified hook after the first worker enters the accepting phase. 🥇
--hook-accepting-once — run the specified hook after each worker enter the accepting phase (once per-instance). 🔂
--hook-accepting1-once — run the specified hook after the first worker enters the accepting phase (once per instance). 🥇
--hook-master-start — run the specified hook when the Master starts. 👑
--hook-touch — run the specified hook when the specified file is touched (syntax: <file> <action>). 👆
--hook-emperor-start — run the specified hook when the Emperor starts. 👑
--hook-emperor-stop — run the specified hook when the Emperor send a stop message. 🛑
--hook-emperor-reload — run the specified hook when the Emperor send a reload message. 🔄
--hook-emperor-lost — run the specified hook when the Emperor connection is lost. 💔
--hook-as-vassal — run the specified hook before exec()ing the vassal. 🧳
--hook-as-emperor — run the specified hook in the emperor after the vassal has been started. 👑
--hook-as-mule — run the specified hook in each mule. 🐴
--hook-as-gateway — run the specified hook in each gateway. 🚪
--after-request-hook — run the specified function/symbol after each request. 🎯
--after-request-call — run the specified function/symbol after each request. 🎯

next up: exec flags. same timing energy, but instead of hooks you're running the specified command. 🏃‍♀️

--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 flags: mount filesystem at the stated moment. 🗂️

--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 flags: unmount filesystem, same timing buffet. 🗑️

--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 era: make root hooks wait for networking. 🌐

--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 flags: call the specified function at the chosen moment. 📞

--call-asap — call the specified function as soon as possible. ⚡
--call-pre-jail — call the specified function before jailing. 🔒
--call-post-jail — call the specified function after jailing. 🔓
--call-in-jail — call the specified function in jail after initialization. 🏠
--call-as-root — call the specified function before privileges drop. 👑
--call-as-user — call the specified function after privileges drop. 🫶
--call-as-user-atexit — call the specified function before app exit and reload. 😭
--call-pre-app — call the specified function before app loading. 📦
--call-post-app — call the specified function after app loading. ✨
--call-as-vassal — call the specified function() before exec()ing the vassal. 🧳
--call-as-vassal1 — call the specified function(char *) before exec()ing the vassal. 🧳
--call-as-vassal3 — call the specified function(char *, uid_t, gid_t) before exec()ing the vassal. 🧳
--call-as-emperor — call the specified function() in the emperor after the vassal has been started. 👑
--call-as-emperor1 — call the specified function(char *) in the emperor after the vassal has been started. 👑
--call-as-emperor2 — call the specified function(char *, pid_t) in the emperor after the vassal has been started. 👑
--call-as-emperor4 — call the specified function(char *, pid_t, uid_t, gid_t) in the emperor after the vassal has been started. 👑

config loading, bestie: pick your format. 📚

--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 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. ⏳
--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 — 👀 watch a file and fire off a signal the second it gets modified/touched. Syntax goes like file signal, bestie.
--fs-reload — if the filesystem object you named gets modified, do a graceful reload. Chill vibes, no drama.
--fs-brutal-reload — same energy but make it brutal reload when that filesystem object changes. No soft launch here.
--fs-signal — raise a uwsgi signal when the specified filesystem object is modified. Syntax: file signal ✨
--check-mountpoint — if a filesystem becomes unreachable, destroy the instance. Sounds harsh but it's literally useful for reliable Fuse management 💀
--mountpoint-check — same thing, different spelling: destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management).
--check-mount — yep, also destroys the instance when a filesystem goes unreachable (useful for reliable Fuse management).
--mount-check — the fourth twin 🫶 destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management).
--propagate-touch — described as an over-engineering option for system with flaky signal management. They said it, not me 😭
--limit-post — cap the request body. Put a limit on it, periodt.
--no-orphans — if the master dies, the workers get auto-killed too 🪦 but heads up, this can be dangerous for availability.
--prio — set the priority of your processes/threads. Main character scheduling energy 👑
--cpu-affinity — pin things to specific CPUs, set your cpu affinity 💅
--post-buffering — pick the size in bytes where stuff stops living in memory and gets buffered to disk instead.
--post-buffering-bufsize — set the buffer size for read() when you're in post buffering mode.
--body-read-warning — set the amount of allowed memory allocation, in megabytes, for the request body before it starts printing a warning at you. Like a lil "bestie…" alarm 🚨
--upload-progress — turn on creation of .json files in the directory you specify, all while a file upload is happening 📁
--no-default-app — do not fallback to the default app. Boundaries ✋
--manage-script-name — automatically rewrite SCRIPT_NAME and PATH_INFO for you. Iconic behaviour.
--ignore-script-name — ignore SCRIPT_NAME entirely. Not today.
--catch-exceptions — report the exception as http output. > Discouraged! Use only for testing, fr fr.
--reload-on-exception — an exception gets raised, the worker gets reloaded. Fresh start, glow up 🔄
--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 combo (language-specific) is raised.
--exception-handler — add an exception handler 🫶
--enable-metrics — switch on the metrics subsystem ✨
--metric — add a custom metric of your very own.
--metric-threshold — add a metric threshold/alarm 🚨
--metric-alarm — add a metric threshold/alarm (same deal, different name).
--alarm-metric — and again: add a metric threshold/alarm.
--metrics-dir — export your metrics as text files into the directory you name.
--metrics-dir-restore — restore the last value taken from the metrics dir. Glow-up from your past self 💖
--metric-dir — export metrics as text files to the specified directory (singular twin, same energy).
--metric-dir-restore — restore last value taken from the metrics dir.
--metrics-no-cores — stop generating cores-related metrics. No cores, no problem.
--udp — run the udp server on the address you specify 📡
--stats — enable the stats server on the specified address.
--stats-server — enable the stats server on the specified address (yes, again, it's the same option wearing a different name).
--stats-http — prefix the stats server json output with http headers.
--stats-minified — minify the statistics json output. Shrink it, slay it.
--stats-min — minify statistics json output. Same glow, shorter name.
--stats-push — push the stats json to whatever destination you name 🚀
--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. Leave them out of the group chat 🙈
--multicast — subscribe to the multicast group you specify 📻
--multicast-ttl — set the multicast ttl.
--multicast-loop — set multicast loop. Default is 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. Like joining a squad but for uWSGI 👑
--legion-mcast — become a member of a legion, but this one's a 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 — if one of the lord hooks fails, declare itself as a dead node for the specified amount of seconds 💀 dramatic but make it resilient.
--legion-skew-tolerance — set the clock skew tolerance of the legion subsystem. Default is 60 seconds.
--legion-lord — the action to call on Lord election 👑
--legion-unlord — the action to call on Lord dismiss.
--legion-setup — the action to call on legion setup.
--legion-death — the action to call on legion death, aka shutdown of the instance 🪦
--legion-join — the action to call on legion join (the first time quorum is reached).
--legion-node-joined — the action to call when a new node joins the legion 🫶
--legion-node-left — the 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 you're 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 subscription server you specify.
--st — subscribe to the specified subscription server. Tiny name, big job.
--subscribe — subscribe to the specified subscription server (yes bestie, it's the same thing again).
--subscribe2 — subscribe to the specified subscription server using advanced keyval syntax ✨
--subscribe-freq — send the subscription announce at the interval you specify.
--subscription-tolerance — set tolerance for subscription servers. Be patient with them 🫶
--unsubscribe-on-graceful-reload — force an unsubscribe request even during a graceful reload. No lingering subscriptions, periodt.
--start-unsubscribed — configure subscriptions but do not send them yet. Super 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. Spill the tea on every handshake problem ☕
--ssl-verify-depth — set the maximum certificate verification depth.
--sni — add an SNI-governed SSL context.
--sni-dir — check for cert/key/client_ca files in the specified directory and create a sni/ssl context on demand 💅
--sni-dir-ciphers — set the ssl ciphers for the sni-dir option.
--ssl-enable3 — > enable SSLv3. This one is insecure 🚨 you've been warned.
--ssl-enable-sslv3 — > enable SSLv3 (insecure). Same warning, longer name.
--ssl-enable-tlsv1 — > enable TLSv1. Also insecure. Proceed with caution, bestie.
--ssl-option — set a raw ssl option, as a numeric value.
--sni-regexp — add an SNI-governed SSL context where the key is a regexp 🧚
--ssl-tmp-dir — store ssl-related temp files in the directory you specify.
--check-interval — set the interval, in seconds, of master checks.
--forkbomb-delay — when a forkbomb gets detected, sleep for the specified number of seconds 😴
--binary-path — force the binary path.
--privileged-binary-patch — patch the uwsgi binary with a new command, and this happens before the privileges drop.
--unprivileged-binary-patch — patch the uwsgi binary with a new command, but this one runs after the 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 or udp address.
--logto2 — log to the specified file or udp address, but only after the privileges drop.
--log-format — set an advanced format for request logging 🎀
--logformat — set advanced format for request logging (the classic spelling).
--logformat-strftime — apply strftime to the logformat output.
--log-format-strftime — apply strftime to logformat output (dashed twin).
--logfile-chown — chown your logfiles.
--logfile-chmod — chmod your logfiles.
--log-syslog — log to syslog 📻
--log-socket — send logs to the socket you specify.
--req-logger — set/append a request logger.
--logger-req — set/append a request logger (same thing, flipped around).
--logger — set/append a logger.
--logger-list — list the enabled loggers 📋
--loggers-list — list enabled loggers (plural, same list).
--threaded-logger — offload log writing to a thread. Let the thread handle it 💅
--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, meaning 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. Could be useful for generating a core dump 💀
--alarm — create a new alarm. Syntax: <alarm> <plugin:args>

Okay so real talk bestie, we're deep in the option mines now and the alarm system is next up — it's giving "uWSGI will text you when something goes wrong" energy and I'm obsessed. 🌸

--alarm-cheap — use the main alarm thread instead of spinning up dedicated threads for curl-based alarms. Reuses the one thread, no new ones. Lowkey frugal queen 💅
--alarm-freq — tune the anti-loop alarm system (default 3 seconds)
--alarm-fd — raise the specified alarm when an fd is ready to read (by default it reads 1 byte, set 8 for eventfd)
--alarm-segfault — raise the specified alarm when the segmentation fault handler is executed
--segfault-alarm — raise the specified alarm when the segmentation fault handler is executed (same thing, different font ✨)
--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

Not me listing six whole flags that all do the exact same thing 😭 that's just how the listen-queue alarm rolls, bestie. Pick whichever spelling feels most like you, they're all going to the same place.

--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 version, for the plural girlies)
--alarm-msg-size — set the max size of an alarm message (default 8192)

Now we're onto logging, which is genuinely the main character of every debugging session, periodt. 🎀

--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 (tiny numbers, huge drama ✨)
--log-x-forwarded-for — use the ip from X-Forwarded-For header instead of REMOTE_ADDR

Privileges and directories, aka the "who am I and where am I standing" section 🦋

--master-as-root — leave master process running as root
--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)
--chdir — chdir to specified directory before apps loading
--chdir2 — chdir to specified directory after apps loading

Note the supersede chain, bestie — --drop-after-init gets overridden by drop-after-apps, and drop-after-apps gets overridden by master-as-root. It's a whole succession drama. 👑

Worker spawning, lazy mode, and the cheaper family — this is the load-management lore and honestly it ate 🌈

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

Apps and mounting and threads, oh my 🧚

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

Four spellings of the thread stacksize flag. Four!! The way that uWSGI said "we'll accept literally any of these" and moved on 💀 Pick your fave, they're all valid.

--vhost — enable virtualhosting mode (based on SERVER_NAME variable)
--vhost-host — enable virtualhosting mode (based on HTTP_HOST variable)

Okay now the routing section, which is long and iconic and I need you to stay with me bestie, we're going the distance 💖

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

Then the final routes, the ones that get the last word:

--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 routes next, for when things go sideways (and they will, no cap):

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

And response routes, the ones that shape what the client actually gets back:

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

See the pattern? Every routing family comes in the same shape: plain, -status, -host, -uri, -qs, -remote-addr, -user-agent, -remote-user, -referer, -label, -if, -if-not, -run. Once you clock the pattern you can basically speedrun the whole list 🔥

--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 and chunked input, the ✨streaming✨ era:

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

And finally, the clocks 🕰️ — yes, clock sources, because time is a construct and uWSGI still wants to know which one you're using:

--clock — set a clock source
--clock-list — list enabled clocks

Bestie, if you've made it this far you are genuinely built different 💜 We are not done yet though — more is coming, so don't go anywhere.

--clocks-list — list enabled clocks. show me the clocks bestie ⏰✨
--add-header — automatically add HTTP headers to response. it just slides them in there 💅
--rem-header — automatically remove specified HTTP header from the response. bye bye header 🫶
--del-header — automatically remove specified HTTP header from the response. same remove-the-header energy, different name fr fr
--collect-header — store the specified response header in a request var (syntax: header var). save that header for later 📥
--response-header-collect — store the specified response header in a request var (syntax: header var). twin flame behavior 💞
--pull-header — store the specified response header in a request var and remove it from the response (syntax: header var). snatch it, stash it, and yeet it from the response 🧲
--check-static — check for static files in the specified directory. static file vibe check 🔍
--check-static-docroot — check for static files in the requested DOCUMENT_ROOT. it looks where the request says 👀
--static-check — check for static files in the specified directory. same static check, living its truth 💫
--static-map — map mountpoint to static directory (or file). map it, slay it 🗺️
--static-map2 — like static-map but completely appending the requested resource to the docroot. extra append energy ✨
--static-skip-ext — skip specified extension from staticfile checks. not today, extension 🙅‍♀️
--static-index — search for specified file if a directory is requested. directory requested? go find the index bestie 📂
--static-safe — skip security checks if the file is under the specified path. trusted path, no security check needed 🔐
--static-cache-paths — put resolved paths in the uWSGI cache for the specified amount of seconds. cache those paths for N seconds ⏳
--static-cache-paths-name — use the specified cache for static paths. name that cache 🏷️
--mimefile — set mime types file path (default /etc/mime.types). mime file location, default is iconic 💖
--mime-file — set mime types file path (default /etc/mime.types). same but with a hyphen, periodt 💅
--static-expires-type — set the Expires header based on content type. expire by content type ⏰
--static-expires-type-mtime — set the Expires header based on content type and file mtime. content type + mtime = expiration math 🧮
--static-expires — set the Expires header based on filename regexp. filename regexp decides Expires 🔥
--static-expires-mtime — set the Expires header based on filename regexp and file mtime. filename regexp + mtime, combo meal 🍔
--static-expires-uri — set the Expires header based on REQUEST_URI regexp. REQUEST_URI regexp for Expires 🌈
--static-expires-uri-mtime — set the Expires header based on REQUEST_URI regexp and file mtime. REQUEST_URI regexp + mtime, yes ma’am 🫡
--static-expires-path-info — set the Expires header based on PATH_INFO regexp. PATH_INFO regexp for Expires 🛣️
--static-expires-path-info-mtime — set the Expires header based on PATH_INFO regexp and file mtime. PATH_INFO regexp + mtime, the full package 📦
--static-gzip — if the supplied regexp matches the static file translation it will search for a gzip version. regexp match? go find the gzip twin 🗜️
--static-gzip-all — check for a gzip version of all requested static files. every static file gets a gzip check, all of them 💯
--static-gzip-dir — check for a gzip version of all requested static files in the specified dir/prefix. gzip check in that dir/prefix 📁
--static-gzip-prefix — check for a gzip version of all requested static files in the specified dir/prefix. same as --static-gzip-dir, just named prefix 💫
--static-gzip-ext — check for a gzip version of all requested static files with the specified ext/suffix. gzip check with that ext/suffix 📎
--static-gzip-suffix — check for a gzip version of all requested static files with the specified ext/suffix. ext/suffix twin, same vibe 🪞
--honour-range — enable support for the HTTP Range header. range requests? honoured, bestie 🎯
--offload-threads — set the number of offload threads to spawn (per-worker, default 0). offload threads, per-worker, default 0 🧵
--offload-thread — set the number of offload threads to spawn (per-worker, default 0). singular name, same setting, no cap 🧶
--file-serve-mode — set static file serving mode. pick your file serving mode 🎛️
--fileserve-mode — set static file serving mode. same mode, no hyphen needed 💅
--disable-sendfile — disable sendfile() and rely on boring read()/write(). goodbye sendfile(), hello old-school read()/write() 😴
--check-cache — check for response data in the specified cache (empty for default cache). look in that cache, empty means default 🕵️‍♀️
--close-on-exec — set close-on-exec on connection sockets (could be required for spawning processes in requests). connection sockets get close-on-exec, maybe needed for spawning in requests 🚪
--close-on-exec2 — set close-on-exec on server sockets (could be required for spawning processes in requests). server sockets this time, same maybe-needed energy 🖥️
--mode — set uWSGI custom mode. custom mode activated 😎
--env — set environment variable. env var, set it 🌱
--envdir — load a daemontools compatible envdir. daemontools-compatible envdir loading 📂
--early-envdir — load a daemontools compatible envdir ASAP. same but ASAP, no waiting ⚡
--unenv — unset environment variable. unset that env var, bye 👋
--vacuum — try to remove all of the generated file/sockets. try to clean up generated files/sockets 🧹
--file-write — write the specified content to the specified file (syntax: file=value) before privileges drop. write file=value before privileges drop ✍️
--cgroup — put the processes in the specified cgroup. cgroup placement, slay 🧺
--cgroup-opt — set value in specified cgroup option. set that cgroup option value 🎚️
--cgroup-dir-mode — set permission for cgroup directory (default is 700). cgroup dir permission, default 700 🔒
--namespace — run in a new namespace under the specified rootfs. new namespace under that rootfs 🌌
--namespace-keep-mount — keep the specified mountpoint in your namespace. keep that mountpoint in your namespace 🏔️
--ns — run in a new namespace under the specified rootfs. short king --ns, same namespace energy 👑
--namespace-net — add network namespace. add a network namespace 🌐
--ns-net — add network namespace. network namespace, short name edition 📡
--enable-proxy-protocol — enable PROXY1 protocol support (only for http parsers). PROXY1 support, but only for http parsers 🧼
--reuse-port — enable REUSE_PORT flag on socket (BSD only). REUSE_PORT on socket, BSD only 🐡
--tcp-fast-open — enable TCP_FASTOPEN flag on TCP sockets with the specified qlen value. TCP_FASTOPEN with that qlen value 🚀
--tcp-fastopen — enable TCP_FASTOPEN flag on TCP sockets with the specified qlen value. no hyphen, same fast open vibe 💨
--tcp-fast-open-client — use sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported. client side uses sendto(..., MSG_FASTOPEN, ...) instead of connect() when supported 🧲
--tcp-fastopen-client — use sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported. same thing, hyphenless name 🪄
--zerg — attach to a zerg server. zerg rush, attach 🐛
--zerg-fallback — fallback to normal sockets if the zerg server is not available. no zerg server? fallback to normal sockets 🛟
--zerg-server — enable the zerg server on the specified UNIX socket. zerg server on that UNIX socket 🐜
--cron — add a cron task. cron task added ⏰
--cron2 — add a cron task (key=val syntax). cron task with key=val syntax 🔑
--unique-cron — add a unique cron task. unique cron task, one of a kind 💎
--cron-harakiri — set the maximum time (in seconds) we wait for cron command to complete. cron harakiri timeout in seconds ⏳
--legion-cron — add a cron task runnable only when the instance is a lord of the specified legion. legion cron, only for the lord of that legion 👑
--cron-legion — add a cron task runnable only when the instance is a lord of the specified legion. same legion lord cron, different name 🏰
--unique-legion-cron — add a unique cron task runnable only when the instance is a lord of the specified legion. unique + legion + cron, triple threat 🎀
--unique-cron-legion — add a unique cron task runnable only when the instance is a lord of the specified legion. same as above, name flipped 🔄
--loop — select the uWSGI loop engine. pick your loop engine 🔁
--loop-list — list enabled loop engines. show me the loop engines 📋
--loops-list — list enabled loop engines. plural loops, same list 🪞
--worker-exec — run the specified command as worker. worker runs that command 🏃
--worker-exec2 — run the specified command as worker (after post_fork hook). same but after post_fork hook 🪝
--attach-daemon — attach a command/daemon to the master process (the command has to not go in background). attach daemon to master, 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. if daemon dies, 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 with pidfile, 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). pidfile managed, but command has to NOT daemonize 🚫
--legion-attach-daemon — same as --attach-daemon but daemon runs only on legion lord node. legion lord only daemon 👑
--legion-smart-attach-daemon — same as --smart-attach-daemon but daemon runs only on legion lord node. smart + legion lord only 🧠👑
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2 but daemon runs only on legion lord node. smart2 + legion lord only 🧠👑2
--daemons-honour-stdin — do not change the stdin of external daemons to /dev/null. leave external daemon stdin alone, don’t send it to /dev/null 🙅
--attach-daemon2 — attach-daemon keyval variant (supports smart modes too). keyval attach-daemon, smart modes supported too 🗝️
--plugins — load uWSGI plugins. load those plugins 🧩
--plugin — load uWSGI plugins. singular plugin, same loading 🧩
--need-plugins — load uWSGI plugins (exit on error). need plugins, exit on error 🚪
--need-plugin — load uWSGI plugins (exit on error). singular need plugin, exit on error 🚪
--plugins-dir — add a directory to uWSGI plugin search path. add plugin search path dir 📁
--plugin-dir — add a directory to uWSGI plugin search path. singular plugin dir, same path 📂
--plugins-list — list enabled plugins. list plugins 📜
--plugin-list — list enabled plugins. singular plugin list, same list 📋
--autoload — try to automatically load plugins when unknown options are found. unknown option? try autoloading plugins 🤖
--dlopen — blindly load a shared library. blindly load that shared library 🙈
--allowed-modifiers — comma separated list of allowed modifiers. allowed modifiers, comma separated 🧾
--remap-modifier — remap request modifier from one id to another. remap modifier id to another 🔀
--dump-options — dump the full list of available options. dump all the options 📦
--show-config — show the current config reformatted as ini. show config as ini 📄
--binary-append-data — return the content of a resource to stdout for appending to a uwsgi binary (for data:// usage). stdout content for appending to uwsgi binary, for data:// usage 🧬
--print — simple print. simple print 🖨️
--iprint — simple print (immediate version). simple print but immediate ⚡
--exit — force exit() of the instance. force exit() on the instance 🚪
--cflags — report uWSGI CFLAGS (useful for building external plugins). report CFLAGS, useful for external plugins 🔧
--dot-h — dump the uwsgi.h used for building the core (useful for building external plugins). dump uwsgi.h, useful for external plugins 📜
--config-py — dump the uwsgiconfig.py used for building the core (useful for building external plugins). dump uwsgiconfig.py, useful for external plugins 🐍
--build-plugin — build a uWSGI plugin for the current binary. build a plugin for current binary 🔨
--version — print uWSGI version. print version 🏷️
--response-headers-limit — set response header maximum size (default: 64k). response header max size, default 64k 📏

and that’s the whole options buffet, bestie 💖 this page was from uwsgi-core 2.0.31-debian, dated January 2026, and it’s UWSGI-CORE(1) — periodt. ✨🫶

📦 where this page comes from

ubuntu resolute: uwsgi-core 2.0.31-2 · 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