UWSGI_LUA(1)

📦

version 2.0.31+2+0.0.2build2 · 3 versions

2.0.31+2+0.0.2build2 · ubuntu resolute, ubuntu stonking (latest)
2.0.29+1build1+0.0.2build1 · ubuntu questing
2.0.28+8+0.0.2 · debian trixie

👑 UWSGI_LUA — the manual, but make it make sense

okay bestie, welcome to UWSGI_LUA(1) 💖 this is the page for uwsgi_lua, and yeah it lives under User Commands like the rest of the gang. grab a strawberry 🍓, sit down, we're doing the whole thing.

✨ NAME ✨

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

like... it's giving pure C, self-healing, developer-friendly and honestly? obsessed. 💅

🌸 SYNOPSIS 🌸

uwsgi-core [options...]

that's it, that's the whole vibe. you throw options at it, it does the thing. 🦋

🎀 DESCRIPTION 🎀

so this section is literally just the options, and there are so many of them, so buckle up. no skipping, no summarising, we're doing every single one fr fr. 😭

💅 sockets & protocols (the networking era)

-s, --socket — bind to the specified UNIX/TCP socket using default protocol. the classic. the main character. ✨
-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, processes & harakiri (the drama section)

-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. yes it's named that. yes it means what you think. 💀
--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

🍓 config loading & option logic (the nerdy but iconic part)

-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, syntax: placeholder=name (immediate option)
--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
--blacklist — set options blacklist context
--end-blacklist — clear options blacklist context
--whitelist — set options whitelist context
--end-whitelist — clear options whitelist context

💜 error handling & templating (soft launch of the responsible 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()
--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 control & 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

🦋 limits, buffers & tuning

-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 perms & process naming

-c, --cgi-mode — force CGI-mode for plugins supporting it
-a, --abstract-socket — force UNIX socket in abstract mode (Linux only) 🐧
-C, --chmod-socket — chmod-socket
-C, --chmod — chmod-socket
--chown-socket — chown unix sockets
--umask — set umask
--freebind — put socket in freebind mode
--map-socket — map sockets to specific workers
-T, --enable-threads — enable threads (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

👑 the Emperor era (vassals, wrappers, heartbeats)

--emperor — run the Emperor
--emperor-proxy-socket — force the vassal to became an Emperor proxy
--emperor-wrapper — set a binary wrapper for vassals
--emperor-wrapper-override — set a binary wrapper for vassals to try before the default one
--emperor-wrapper-fallback — set a binary wrapper for vassals to try as a last resort
--emperor-nofollow — do not follow symlinks when checking for mtime
--emperor-procname — set the Emperor process name
--emperor-freq — set the Emperor scan frequency (default 3 seconds)
--emperor-required-heartbeat — set the Emperor tolerance about heartbeats
--emperor-curse-tolerance — set the Emperor tolerance about cursed vassals 💀
--emperor-pidfile — bestie, this writes the Emperor pid into the file you point at 📝✨
--emperor-tyrant — puts the Emperor into Tyrant mode 👑😤
--emperor-tyrant-nofollow — no symlink-following when checking uid/gid in Tyrant mode, okay? 🚫🔗
--emperor-stats — runs the Emperor stats server 📊✨
--emperor-stats-server — also runs the Emperor stats server, because why not 💅📊
--early-emperor — spawns the emperor ASAP, like right now bestie ⏰💨
--emperor-broodlord — runs the emperor in BroodLord mode 🦋👑
--emperor-throttle — sets the throttling level in milliseconds for vassals acting up 😤 default is 1000 ⏳
--emperor-max-throttle — max throttling level in ms for misbehaving vassals, default is 3 minutes 🛑⏲️
--emperor-magic-exec — if a vassal config file has the executable bit, it gets prefixed with exec:// like magic ✨🪄
--emperor-on-demand-extension — searches for a text file named vassal name + extension that holds the on demand socket name 🔍📄
--emperor-on-demand-ext — same vibe, searches for that text file with the on demand socket name 🫶🔍
--emperor-on-demand-directory — turns on on-demand mode, binding to a unix socket in the dir you specify, named like the vassal + .socket 🔌📁
--emperor-on-demand-dir — yep, enables on-demand mode with that unix socket in your chosen dir, vassal + .socket 🫶🔌
--emperor-on-demand-exec — uses the output of the command you give as the on-demand socket name; the vassal name is the only argument passed 🖥️🔌
--emperor-extra-extension — lets the Emperor accept the extension you specify; the vassal gets called with --config ✅📂
--emperor-extra-ext — same deal, allows that extra extension and calls the vassal with --config 💅📂
--emperor-no-blacklist — disables the Emperor blacklisting subsystem, no cap 🚫📋
--emperor-use-clone — uses clone() instead of fork(), passing the unshare() flags you specify 🧬🔁
--emperor-graceful-shutdown — vassals get a graceful shutdown during ragnarok 🌋🕊️
--emperor-cap — sets the vassals capability 🔐👑
--vassals-cap — also sets the vassals capability, bestie 🔐🫶
--vassal-cap — sets vassals capability too, periodt 🔐💅
--imperial-monitor-list — lists all enabled imperial monitors 📜👀
--imperial-monitors-list — lists enabled imperial monitors, yes plural ✨📜
--vassals-inherit — adds config templates to vassals config using --inherit 📝🧬
--vassals-include — includes config templates to vassals config, but uses --include instead of --inherit 📝🔀
--vassals-inherit-before — adds config templates using --inherit, and parses them before the vassal file ⏮️📝
--vassals-include-before — includes config templates with --include instead of --inherit, and parses before the vassal file ⏮️📝
--vassals-start-hook — runs your command before each vassal starts 🏁🪝
--vassals-stop-hook — runs your command after a vassal dies 💀🪝
--vassal-sos — when overloaded, the vassal asks the emperor for reinforcements 🆘👑
--vassal-sos-backlog — asks the emperor for SOS if the backlog queue has more items than your value 📈🆘
--vassals-set — automatically sets the option you specify via --set for every vassal 🤖⚙️
--vassal-set — same auto-set via --set for every vassal, fr fr 🤖💅
--heartbeat — announces healthiness to the emperor 💓👑
--reload-mercy — max time in seconds we wait for workers and other processes to die during reload/shutdown ⏳💀
--worker-reload-mercy — max time in seconds a worker can take to reload/shutdown; default is 60 ⏲️👷
--mule-reload-mercy — max 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 doing a brutal reload on SIGTERM 💀📡
--force-gateway — forces the spawn of the first registered gateway without a master 🚪⚡
-h|--help — shows this help, bestie 🆘💖
-h|--usage — also shows this help, same energy 🆘✨
--print-sym — prints the content of the binary symbol you specify 🔍🧬
--print-symbol — prints that binary symbol content too, iconic 🫶🔍
-r|--reaper — calls waitpid(-1,...) after each request to yeet 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 a 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 the 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() to avoid duplicates 🔑🧬
--persistent-ipcsem — does NOT remove ipcsem's on shutdown, keep them around 🚫🗑️
-A|--sharedarea — creates a raw shared memory area of the specified pages; note: it supports keyval too 🧠✨
--safe-fd — does not close the file descriptor you specify 🙅‍♀️📁
--fd-safe — same vibe, keeps that file descriptor open 🫶📁
--cache — creates a shared cache containing the elements you give 🗃️✨
--cache-blocksize — sets the cache blocksize 🧱🗃️
--cache-store — enables persistent cache to disk 💾🗃️
--cache-store-sync — sets how often the persistent cache syncs ⏱️💾
--cache-no-expire — disables the auto sweep of expired items 🚫🧹
--cache-expire-freq — sets the frequency of cache sweeper scans; default is 3 seconds 🧹⏲️
--cache-report-freed-items — constantly reports cache items freed by the sweeper; use only for debug 🐛📢
--cache-udp-server — binds the cache UDP server (only for set/update/delete) to the socket you specify 📡🔌
--cache-udp-node — sends cache update/deletion to the cache UDP server you specify 📤📡
--cache-sync — copies the whole content of another uWSGI cache server on 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 with keyval syntax ✨🗃️
--queue — enables shared queue 📋✨
--queue-blocksize — sets queue blocksize 🧱📋
--queue-store — enables persistent queue to disk 💾📋
--queue-store-sync — sets sync frequency for persistent queue ⏱️💾
-Q|--spooler — runs a spooler on the directory you specify 🌀📁
--spooler-external — maps spooler 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 the directory you specify before each spooler task 📂🌀
--spooler-processes — sets the number of processes for spoolers 👯🌀
--spooler-quiet — no verbose spooler task chatter, shhh 🤫🌀
--spooler-max-tasks — max number of tasks to run before recycling a spooler 🔄🌀
--spooler-harakiri — sets harakiri timeout for spooler tasks ⏳🌀
--spooler-frequency — sets spooler frequency 📶🌀
--spooler-freq — same, sets spooler frequency 🫶📶
--mule — adds a mule 🐴✨
--mules — adds the number of mules you specify 🐴🐴
--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 the signal queue 📦📡
--signals-bufsize — same, sets buffer size for signal queue 🫶📦
--signal-timer — adds a timer, syntax: <signal> <seconds> ⏲️📡
--timer — adds a timer too, syntax: <signal> <seconds> 🫶⏲️
--signal-rbtimer — adds a redblack timer, syntax: <signal> <seconds> 🌳⏲️
--rbtimer — adds a redblack timer, same syntax: <signal> <seconds> 🫶🌳
--rpc-max — maximum number of rpc slots; default: 64 📞🔢
-L|--disable-logging — disables request logging 🚫📝
--flock — locks the file you specify before starting, and exits if it's already locked 🔒🚪
--flock-wait — locks the file before starting, but waits if it's already locked ⏳🔒
--flock2 — locks the file after logging/daemon setup, exits if locked 🔒🚪
--flock-wait2 — locks after logging/daemon setup, waits if locked ⏳🔒
--pidfile — creates a pidfile before privileges drop 📝🔽
--pidfile2 — creates a pidfile after privileges drop 📝⬇️
--safe-pidfile — creates a safe pidfile before privileges drop 🛡️📝
--safe-pidfile2 — creates a safe pidfile after privileges drop 🛡️⬇️
--chroot — chroot()s to the directory you specify 🏰📁
--pivot-root — pivot_root()s to the specified directories; new_root and put_old must be separated with a space 🔄📁
--pivot_root — same thing, pivot_root() to those dirs with a space between new_root and put_old 🫶🔄
--uid — setuid to the user/uid you specify 👤🆔
--gid — setgid to the group/gid you specify 👥🆔
--add-gid — adds the specified group id to the process credentials ➕👥
--immediate-uid — setuid to the user/uid IMMEDIATELY 🏃‍♀️👤
--immediate-gid — setgid to the group/gid IMMEDIATELY 🏃‍♀️👥
--no-initgroups — disables additional groups set via initgroups() 🚫👥
--cap — sets process capability 🔐✨
--unshare — unshare()s part of the processes and puts them in a new namespace 🧬🌌
--unshare2 — unshare()s part of the processes into a new namespace after rootfs change 🧬🔄
--setns-socket — exposes a unix socket returning namespace fds from /proc/self/ns 🔌📂
--setns-socket-skip — skips the entry you specify when sending setns file descriptors 🚫📤
--setns-skip — same, skips that 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 instance as jailed, which forces the post_jail hooks to actually fire. like, "yes bestie, we ARE in the box, run the things" 💅
--refork — fork()s again after privileges drop. super useful for jailing systems.
--re-fork — same exact thing as --refork: fork() again after privileges drop. useful for jailing systems. two names, one vibe 🫶
--refork-as-root — fork()s again before privileges drop. again: jailing systems, you know the drill.
--re-fork-as-root — the twin of --refork-as-root. fork() again before privileges drop, useful for jailing systems. identical, no cap.
--refork-post-jail — fork()s again after jailing. useful for jailing systems ✨
--re-fork-post-jail — same as --refork-post-jail: fork() again after jailing. useful for jailing systems.

okay now the HOOKS. this is the part where uWSGI lets you inject your little scripts at exactly the right moment. it's giving main character energy for your setup scripts 🔥

--hook-asap — runs the specified hook as soon as possible.
--hook-pre-jail — runs the specified hook before jailing.
--hook-post-jail — runs the specified hook after jailing.
--hook-in-jail — runs the specified hook in jail, after initialization.
--hook-as-root — runs the specified hook before privileges drop.
--hook-as-user — runs the specified hook after privileges drop.
--hook-as-user-atexit — runs the specified hook before app exit and reload.
--hook-pre-app — runs the specified hook before app loading.
--hook-post-app — runs the specified hook after app loading.
--hook-post-fork — runs the specified hook after each fork.
--hook-accepting — runs the specified hook after each worker enters the accepting phase.
--hook-accepting1 — runs the specified hook after the first worker enters the accepting phase.
--hook-accepting-once — runs the specified hook after each worker enters the accepting phase, but once per-instance.
--hook-accepting1-once — runs the specified hook after the first worker enters the accepting phase, once per instance.
--hook-master-start — runs the specified hook when the Master starts 👑
--hook-touch — runs the specified hook when the specified file is touched. syntax: <file> <action>
--hook-emperor-start — runs the specified hook when the Emperor starts.
--hook-emperor-stop — runs the specified hook when the Emperor sends a stop message.
--hook-emperor-reload — runs the specified hook when the Emperor sends a reload message.
--hook-emperor-lost — runs the specified hook when the Emperor connection is lost 😭
--hook-as-vassal — runs the specified hook before exec()ing the vassal.
--hook-as-emperor — runs the specified hook in the emperor after the vassal has been started.
--hook-as-mule — runs the specified hook in each mule.
--hook-as-gateway — runs the specified hook in each gateway.
--after-request-hook — runs the specified function/symbol after each request.
--after-request-call — runs the specified function/symbol after each request. (yep, same energy as the one above 💜)

and now the exec family — same timing slots, but it's running a whole command instead of a hook:

--exec-asap — runs the specified command as soon as possible.
--exec-pre-jail — runs the specified command before jailing.
--exec-post-jail — runs the specified command after jailing.
--exec-in-jail — runs the specified command in jail after initialization.
--exec-as-root — runs the specified command before privileges drop.
--exec-as-user — runs the specified command after privileges drop.
--exec-as-user-atexit — runs the specified command before app exit and reload.
--exec-pre-app — runs the specified command before app loading.
--exec-post-app — runs the specified command after app loading.
--exec-as-vassal — runs the specified command before exec()ing the vassal.
--exec-as-emperor — runs the specified command in the emperor after the vassal has been started.

mount time 🌸 same timing slots, now for mounting filesystems:

--mount-asap — mounts filesystem as soon as possible.
--mount-pre-jail — mounts filesystem before jailing.
--mount-post-jail — mounts filesystem after jailing.
--mount-in-jail — mounts filesystem in jail after initialization.
--mount-as-root — mounts filesystem before privileges drop.
--mount-as-vassal — mounts filesystem before exec()ing the vassal.
--mount-as-emperor — mounts filesystem in the emperor after the vassal has been started.

and the reverse, because what goes up must come down 💅

--umount-asap — unmounts filesystem as soon as possible.
--umount-pre-jail — unmounts filesystem before jailing.
--umount-post-jail — unmounts filesystem after jailing.
--umount-in-jail — unmounts filesystem in jail after initialization.
--umount-as-root — unmounts filesystem before privileges drop.
--umount-as-vassal — unmounts filesystem before exec()ing the vassal.
--umount-as-emperor — unmounts filesystem in the emperor after the vassal has been started.

waiting era 🦋 these ones make uWSGI sit patiently like a good bestie until the thing you need actually shows up:

--wait-for-interface — waits for the specified network interface to come up before running root hooks.
--wait-for-interface-timeout — sets the timeout for wait-for-interface.
--wait-interface — waits for the specified network interface to come up before running root hooks. (alias, same vibe ✨)
--wait-interface-timeout — sets the timeout for wait-for-interface.
--wait-for-iface — waits for the specified network interface to come up before running root hooks. (another alias, iconic)
--wait-for-iface-timeout — sets the timeout for wait-for-interface.
--wait-iface — waits for the specified network interface to come up before running root hooks. (fourth one, yes really 🙈)
--wait-iface-timeout — sets the timeout for wait-for-interface.
--wait-for-fs — waits for the specified filesystem item to appear before running root hooks.
--wait-for-file — waits for the specified file to appear before running root hooks.
--wait-for-dir — waits for the specified directory to appear before running root hooks.
--wait-for-mountpoint — waits for the specified mountpoint to appear before running root hooks.
--wait-for-fs-timeout — sets the timeout for wait-for-fs/file/dir.
--wait-for-socket — waits for the specified socket to be ready before loading apps.
--wait-for-socket-timeout — sets the timeout for wait-for-socket.

call family 🎀 same slots as exec/hook, except it's calling a function:

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

--ini — load config from an ini file.
-y|--yaml — load config from a yaml file.
-y|--yml — load config from a yaml file. (same flag, same file, different spelling bestie)
-j|--json — load config from a json file.
-j|--js — load config from a json file. (also the same, don't panic)
--weight — weight of the instance, used by clustering/lb/subscriptions.
--auto-weight — sets the weight of the instance automatically, used by clustering/lb/subscriptions.
--no-server — forces no-server mode.
--command-mode — forces command mode.
--no-defer-accept — disables deferred-accept on sockets.
--tcp-nodelay — enables TCP NODELAY on each request.
--so-keepalive — enables TCP KEEPALIVEs.
--so-send-timeout — sets SO_SNDTIMEO.
--socket-send-timeout — sets SO_SNDTIMEO.
--so-write-timeout — sets SO_SNDTIMEO.
--socket-write-timeout — sets SO_SNDTIMEO.
--socket-sndbuf — sets SO_SNDBUF.
--socket-rcvbuf — sets SO_RCVBUF.
--shutdown-sockets — forces calling shutdown() in addition to close() when sockets are destroyed.
--limit-as — limits processes address space/vsz.
--limit-nproc — limits the number of spawnable processes.
--reload-on-as — reloads if address space is higher than the specified megabytes.
--reload-on-rss — reloads if rss memory is higher than the specified megabytes.
--evil-reload-on-as — forces the master to reload a worker if its address space is higher than the specified megabytes 😈
--evil-reload-on-rss — forces the master to reload a worker if its rss memory is higher than the specified megabytes.
--mem-collector-freq — sets the memory collector frequency when evil reloads are in place.
--reload-on-fd — reloads if the specified file descriptor is ready.
--brutal-reload-on-fd — brutal reload if the specified file descriptor is ready 💀
--ksm — enables Linux KSM.
--pcre-jit — enables pcre jit, if available.
--never-swap — locks all memory pages, avoiding swapping.
--touch-reload — reloads uWSGI if the specified file is modified/touched.
--touch-workers-reload — triggers a reload of (only) workers if the specified file is modified/touched.
--touch-mules-reload — reloads mules if the specified file is modified/touched.
--touch-spoolers-reload — reloads spoolers if the specified file is modified/touched.
--touch-chain-reload — triggers a chain reload if the specified file is modified/touched.
--touch-logrotate — triggers logrotation if the specified file is modified/touched.
--touch-logreopen — triggers log reopen if the specified file is modified/touched.
--touch-exec — runs a command when the specified file is modified/touched. syntax: file command

okay bestie we're still deep in the option list, hydrate 💧 and keep scrolling, because the filesystem-watcher girlies are up first ✨

--touch-signal — clock a file getting modified or touched and fire off a signal when it happens. Syntax: file signal
--fs-reload — the specified filesystem object gets modified → graceful reload, no drama, no dropped vibes
--fs-brutal-reload — same energy, but the reload is brutal 😤
--fs-signal — the filesystem object changes and uwsgi raises a signal, like a little poke. Syntax: file signal
--check-mountpoint — if a filesystem stops being reachable, the instance just dies. Rude but reliable, and honestly iconic for solid Fuse management
--mountpoint-check — literally the same thing as --check-mountpoint 💅
--check-mount — yep, also the same. destroy the instance when a filesystem goes unreachable
--mount-check — the fourth alias, same behaviour, same Fuse reliability agenda 🫶
--propagate-touch — the original literally calls this an "over-engineering option for system with flaky signal management" and we respect the honesty
--limit-post — cap the request body. set that ceiling, protect the vibe
--no-orphans — when the master dies, the workers get taken out too, automatically. heads up though — this can be dangerous for availability 😭
--prio — set the priority of processes/threads
--cpu-affinity — set cpu affinity, let your processes pick their favourite core 🎀
--post-buffering — the size in bytes at which stuff gets buffered to disk instead of memory
--post-buffering-bufsize — sets the buffer size for read() when you're in post buffering mode
--body-read-warning — how much memory (in megabytes) a request body is allowed to allocate before uwsgi starts printing a warning at you 📢
--upload-progress — turns on creation of .json files in the directory you name, so you can watch a file upload happening in real time 🌸
--no-default-app — no falling back to the default app. we're not doing that today
--manage-script-name — automatically rewrites SCRIPT_NAME and PATH_INFO for you
--ignore-script-name — just straight up ignores SCRIPT_NAME
--catch-exceptions — reports the exception as http output. discouraged — use only for testing, it's giving debug-mode energy, not production 💀
--reload-on-exception — a worker raises an exception → that worker gets reloaded
--reload-on-exception-type — reload the worker when one specific exception type gets raised
--reload-on-exception-value — reload the worker when a specific exception value shows up
--reload-on-exception-repr — reload when a specific exception type+value combo is raised (language-specific, iykyk)
--exception-handler — add an exception handler
--enable-metrics — turn on the whole metrics subsystem 📊
--metric — add a custom metric of your very own, main character metric
--metric-threshold — add a metric threshold/alarm
--metric-alarm — add a metric threshold/alarm (same thing, different spelling of the same dream)
--alarm-metric — add a metric threshold/alarm, third alias edition 💅
--metrics-dir — export metrics as text files into the directory you specify
--metrics-dir-restore — restores the last value taken from the metrics dir
--metric-dir — export metrics as text files to the specified directory (the singular-flavoured alias)
--metric-dir-restore — restore last value taken from the metrics dir
--metrics-no-cores — stop generating the 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 (same vibe, second name)
--stats-http — prefixes the stats server json output with http headers
--stats-minified — minify the statistics json output, compact queen
--stats-min — minify the statistics json output, yes again ✨
--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 version, same deal)
--stats-no-cores — disable generation of cores-related stats
--stats-no-metrics — keeps metrics out of the stats output entirely
--multicast — subscribe to the multicast group you specify
--multicast-ttl — set multicast ttl
--multicast-loop — set multicast loop, and the 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 time 🫡 this is the swarm/cluster arc and it goes hard

--legion — you become a member of a legion
--legion-mcast — also become a member of a legion, this is the 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 a dead node for however many seconds you specify
--legion-skew-tolerance — clock skew tolerance for the legion subsystem, default 60 seconds ⏰
--legion-lord — the action to call on Lord election 👑
--legion-unlord — the action to call on Lord dismiss
--legion-setup — action to call on legion setup
--legion-death — action to call on legion death, aka the shutdown of the instance 💀
--legion-join — action to call on legion join, i.e. 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 — max size of the legion scroll buffer
--legion-scroll-list-max-size — 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 — max tolerance (in seconds) of clock skew for the secured subscription system
--subscriptions-sign-skip-uid — skip the signature check for the uid you name, when unix sockets credentials are in play
--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 — tries to fall back 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
--subscribe2 — subscribe to the specified subscription server, but using the advanced keyval syntax
--subscribe-freq — send the subscription announce at the interval you set
--subscription-tolerance — set tolerance for subscription servers
--unsubscribe-on-graceful-reload — forces the unsubscribe request through even during a graceful reload
--start-unsubscribed — configure the subscriptions but don't actually send them. genuinely useful with master fifo
--subscribe-with-modifier1 — force the specified modifier1 when subscribing

snmp + ssl arc, aka the "lock it down" chapter 🔒

--snmp — enable the embedded snmp server
--snmp-community — set the snmp community string
--ssl-verbose — be loud and verbose about SSL errors 📢
--ssl-verify-depth — set the maximum certificate verification depth
--sni — add an SNI-governed SSL context
--sni-dir — checks for cert/key/client_ca files in the directory you name and creates a sni/ssl context on demand, whenever it's needed ✨
--sni-dir-ciphers — set ssl ciphers for the sni-dir option
--ssl-enable3 — enable SSLv3. insecure, bestie, we're saying it out loud 😭
--ssl-enable-sslv3 — enable SSLv3, also insecure
--ssl-enable-tlsv1 — enable TLSv1, also insecure
--ssl-option — set a raw ssl option, and it takes a numeric value
--sni-regexp — add an SNI-governed SSL context, but here the key is a regexp 🧚
--ssl-tmp-dir — store ssl-related temp files in the directory you specify
--check-interval — the interval, in seconds, between master checks
--forkbomb-delay — when a forkbomb is detected, sleep for the number of seconds you specify 😴
--binary-path — force the binary path
--privileged-binary-patch — patch the uwsgi binary with a new command, done before the privileges drop
--unprivileged-binary-patch — patch the uwsgi binary with a new command, done 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 however many 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 file or udp address you name, but after the privileges drop
--log-format — set an advanced format for request logging
--logformat — set an advanced format for request logging (short version, same glow)
--logformat-strftime — apply strftime to the logformat output
--log-format-strftime — apply strftime to the logformat output
--logfile-chown — chown the logfiles
--logfile-chmod — chmod the 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 (flipped name, same energy)
--logger — set/append a logger
--logger-list — list the enabled loggers
--loggers-list — list the enabled loggers, plural girlies rise 🫶
--threaded-logger — offload the log writing to a thread, so it doesn't block your whole life
--log-encoder — add an item into the log encoder chain
--log-req-encoder — add an item into the log req encoder chain
--log-drain — drain (aka do not show) log lines matching the regexp you give it
--log-filter — show only the log lines matching the specified regexp
--log-route — if the regexp applied on the logline matches, log to the named logger you specified
--log-req-route — if the regexp applied on the logline matches, log the requests to the named logger you specified
--use-abort — calls abort() on segfault/fpe, which could genuinely be useful for generating a core dump 💀
--alarm — create a new alarm. Syntax: <alarm> <plugin:args> ⏰

and that's part 4, no cap — more incoming, don't go anywhere 💖

--alarm-cheap — okay so instead of birthing a whole dedicated thread for each curl-based alarm, just run them on the main alarm thread. cheap in the best way. 💸
--alarm-freq — tune the anti-loop alarm system. the default is 3 seconds, and yes you can change it. 🔁
--alarm-fd — raise the specified alarm when an fd is read for read. by default it reads 1 byte — set it to 8 if you're doing eventfd. 🎀
--alarm-segfault — raise the specified alarm the moment the segmentation fault handler runs. 😭
--segfault-alarm — same thing as --alarm-segfault, fr: raise the specified alarm when the segmentation fault handler is executed.
--alarm-backlog — raise the specified alarm when the socket backlog queue is full. 💀
--backlog-alarm — identical energy to --alarm-backlog: raise the specified alarm when the socket backlog queue is full.
--lq-alarm — raise the specified alarm when the socket backlog queue is full. (yes, this is the same alarm again, the backlog queue is that girl.) 🦋
--alarm-lq — raise the specified alarm when the socket backlog queue is full. same as --lq-alarm, just spelled the other way around.
--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. no cap, same behaviour, different name order.
--log-alarm — raise the specified alarm whenever a log line matches the regexp you give it. syntax is exactly: <alarm>[,alarm...] <regexp> ✨
--alarm-log — raise the specified alarm when a log line matches the specified regexp. syntax: <alarm>[,alarm...] <regexp>. same as --log-alarm, different outfit. 💅
--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>. same as --not-log-alarm.
--alarm-list — list enabled alarms. go off, show me the roster. 📋
--alarms-list — list enabled alarms. (plural edition, same tea.) 🍵
--alarm-msg-size — set the max size of an alarm message. default is 8192. 📏
--log-master — delegate logging to the master process. hand it over, queen. 👑
--log-master-bufsize — set the buffer size for the master logger. heads up bestie: bigger log messages will be truncated. ✂️
--log-master-stream — create the master logpipe as SOCK_STREAM. 🌊
--log-master-req-stream — create the master requests logpipe as SOCK_STREAM. 🌊
--log-reopen — reopen the log after a reload. 🔄
--log-truncate — truncate the log on startup. fresh page, clean slate. 🧼
--log-maxsize — set the maximum logfile size. 📦
--log-backupname — set the logfile name used after rotation. 🌀
--logdate — prefix logs with a date, or with a strftime string. 🗓️
--log-date — prefix logs with a date or a strftime string. same as --logdate.
--log-prefix — prefix logs with a string of your choosing. 🎀
--log-zero — log responses that have no body. zero body, still logged. 👻
--log-slow — log requests slower than the number of milliseconds you specify. 🐌
--log-4xx — log requests with a 4xx response. 🙈
--log-5xx — log requests with a 5xx response. 🔥
--log-big — log requests bigger than the size you specify. 🐘
--log-sendfile — log sendfile requests. 📤
--log-ioerror — log requests that hit io errors. 😵
--log-micros — report response time in microseconds instead of milliseconds. precision era. ⏱️
--log-x-forwarded-for — use the ip from the X-Forwarded-For header instead of REMOTE_ADDR. 🕵️
--master-as-root — leave the master process running as root. periodt. 🫅
--drop-after-init — run privileges drop after plugin initialization. heads up: this one is superseded by drop-after-apps. ⚠️
--drop-after-apps — run privileges drop after apps loading. heads up again: this one is superseded by master-as-root. ⚠️
--force-cwd — force the initial working directory to the value you specify. 📌
--binsh — override /bin/sh. this is what the exec hooks use, and it always falls back to /bin/sh. 🐚
--chdir — chdir to the specified directory before apps loading. 📁
--chdir2 — chdir to the specified directory after apps loading. 📂
--lazy — set lazy mode: load apps in the workers instead of the master. 🦥
--lazy-apps — load apps in each worker instead of the master. 🐣
--cheap — set cheap mode: spawn workers only after the first request. 💸
--cheaper — set cheaper mode, aka adaptive process spawning. 📈
--cheaper-initial — set the initial number of processes to spawn in cheaper mode. 🌱
--cheaper-algo — choose the algorithm used for adaptive process spawning. 🧠
--cheaper-step — the number of additional processes to spawn at each overload. ➕
--cheaper-overload — increase workers after the specified overload. 🚀
--cheaper-algo-list — list enabled cheapers algorithms. 📜
--cheaper-algos-list — list enabled cheapers algorithms. (plural algo edition.) 📜
--cheaper-list — list enabled cheapers algorithms. same roster, shorter name. 📜
--cheaper-rss-limit-soft — don't spawn new workers if the total resident memory usage of all workers is higher than this limit. 🧯
--cheaper-rss-limit-hard — if total workers resident memory usage is higher, try to stop workers. yikes, dramatic but correct. 💀
--idle — set idle mode: put uWSGI into cheap mode after inactivity. 😴
--die-on-idle — shutdown uWSGI when idle. rip bestie. ⚰️
--mount — load application under a mountpoint. ⛰️
--worker-mount — load application under a 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. same as --thread-stacksize. 📚
--thread-stack-size — set threads stacksize. same thing, extra dash, still iconic. 📚
--threads-stack-size — set threads stacksize. yes, all four spellings exist. 💅
--vhost — enable virtualhosting mode, based on the SERVER_NAME variable. 🏠
--vhost-host — enable virtualhosting mode, based on the HTTP_HOST variable. 🏡

--route — add a route. 🛣️
--route-host — add a route based on the Host header. 🏷️
--route-uri — add a route based on REQUEST_URI. 🔗
--route-qs — add a route based on QUERY_STRING. ❓
--route-remote-addr — add a route based on REMOTE_ADDR. 🌐
--route-user-agent — add a route based on HTTP_USER_AGENT. 🕶️
--route-remote-user — add a route based on REMOTE_USER. 🙋
--route-referer — add a route based on HTTP_REFERER. ↩️
--route-label — add a routing label, for use with goto. 🏁
--route-if — add a route based on a condition. 🤔
--route-if-not — add a route based on a condition, negate version. 🙃
--route-run — always run the specified route action. ▶️
--final-route — add a final route. 🏁
--final-route-status — add a final route for the specified status. 🔢
--final-route-host — add a final route based on the Host header. 🏷️
--final-route-uri — add a final route based on REQUEST_URI. 🔗
--final-route-qs — add a final route based on QUERY_STRING. ❓
--final-route-remote-addr — add a final route based on REMOTE_ADDR. 🌐
--final-route-user-agent — add a final route based on HTTP_USER_AGENT. 🕶️
--final-route-remote-user — add a final route based on REMOTE_USER. 🙋
--final-route-referer — add a final route based on HTTP_REFERER. ↩️
--final-route-label — add a final routing label, for use with goto. 🏁
--final-route-if — add a final route based on a condition. 🤔
--final-route-if-not — add a final route based on a condition, negate version. 🙃
--final-route-run — always run the specified final route action. ▶️
--error-route — add an error route. 🚨
--error-route-status — add an error route for the specified status. 🔢
--error-route-host — add an error route based on the Host header. 🏷️
--error-route-uri — add an error route based on REQUEST_URI. 🔗
--error-route-qs — add an error route based on QUERY_STRING. ❓
--error-route-remote-addr — add an error route based on REMOTE_ADDR. 🌐
--error-route-user-agent — add an error route based on HTTP_USER_AGENT. 🕶️
--error-route-remote-user — add an error route based on REMOTE_USER. 🙋
--error-route-referer — add an error route based on HTTP_REFERER. ↩️
--error-route-label — add an error routing label, for use with goto. 🏁
--error-route-if — add an error route based on a condition. 🤔
--error-route-if-not — add an error route based on a condition, negate version. 🙃
--error-route-run — always run the specified error route action. ▶️
--response-route — add a response route. 📨
--response-route-status — add a response route for the specified status. 🔢
--response-route-host — add a response route based on the Host header. 🏷️
--response-route-uri — add a response route based on REQUEST_URI. 🔗
--response-route-qs — add a response route based on QUERY_STRING. ❓
--response-route-remote-addr — add a response route based on REMOTE_ADDR. 🌐
--response-route-user-agent — add a response route based on HTTP_USER_AGENT. 🕶️
--response-route-remote-user — add a response route based on REMOTE_USER. 🙋
--response-route-referer — add a response route based on HTTP_REFERER. ↩️
--response-route-label — add a response routing label, for use with goto. 🏁
--response-route-if — add a response route based on a condition. 🤔
--response-route-if-not — add a response route based on a condition, negate version. 🙃
--response-route-run — always run the specified response route action. ▶️
--router-list — list enabled routers. 📡
--routers-list — list enabled routers. same list, plural spelling. 📡
--error-page-403 — add an error page (html) for the managed 403 response. 🚫
--error-page-404 — add an error page (html) for the managed 404 response. 🫥
--error-page-500 — add an error page (html) for the managed 500 response. 💥
--websockets-ping-freq — set the frequency (in seconds) of websockets automatic ping packets. 🏓
--websocket-ping-freq — set the frequency (in seconds) of websockets automatic ping packets. same vibe, singular websocket. 🏓
--websockets-pong-tolerance — set the tolerance (in seconds) of the websockets ping/pong subsystem. 🎾
--websocket-pong-tolerance — set the tolerance (in seconds) of the websockets ping/pong subsystem. same, singular edition. 🎾
--websockets-max-size — set the max allowed size of websocket messages, in Kbytes. default is 1024. 📦
--websocket-max-size — set the max allowed size of websocket messages, in Kbytes. default 1024. same thing, one fewer s. 📦
--chunked-input-limit — set the max size of a chunked input part. default is 1MB, and it's in bytes. 🧩
--chunked-input-timeout — set the default timeout for chunked input. ⏳
--clock — set a clock source. 🕰️
--clock-list — list enabled clocks. 🕰️✨

okay bestie, we're in the final stretch of the options list and honestly? it's giving "static files, daemons and cursed kernel flags" and I'm obsessed 💖 stay with me, every single flag is still here, no cap.

--clocks-list — lists all the clocks that are enabled ⏰
--add-header — automatically adds HTTP headers to the response
--rem-header — automatically removes the HTTP header you specify from the response
--del-header — automatically removes the HTTP header you specify from the response (yes bestie, it's the same job as --rem-header, they're twins 🫶)
--collect-header — stores the response header you specify in a request var (syntax: header var)
--response-header-collect — stores the response header you specify in a request var (syntax: header var) — same vibe, different name
--pull-header — stores the response header you specify in a request var and removes it from the response (syntax: header var)

🌸 static files era 🌸

--check-static — checks for static files in the directory you specify
--check-static-docroot — checks for static files in the requested DOCUMENT_ROOT
--static-check — checks for static files in the directory you specify
--static-map — maps a mountpoint to a static directory (or file)
--static-map2 — like --static-map but it completely appends the requested resource to the docroot
--static-skip-ext — skips the extension you specify from staticfile checks
--static-index — searches for the file you specify if a directory is requested
--static-safe — skips security checks if the file is under the path you specify
--static-cache-paths — puts resolved paths in the uWSGI cache for the amount of seconds you specify
--static-cache-paths-name — uses the cache you specify for static paths
--mimefile — sets the mime types file path (default /etc/mime.types)
--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

🎀 the gzip girlies 🎀

--static-gzip — if the regexp you supply 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
--static-gzip-dir — checks for a gzip version of all requested static files in the dir/prefix you specify
--static-gzip-prefix — checks for a gzip version of all requested static files in the dir/prefix you specify
--static-gzip-ext — checks for a gzip version of all requested static files with the ext/suffix you specify
--static-gzip-suffix — checks for a gzip version of all requested static files with the ext/suffix you specify

--honour-range — enables support for the HTTP Range header
--offload-threads — sets the number of offload threads to spawn (per-worker, default 0)
--offload-thread — sets the number of offload threads to spawn (per-worker, default 0)
--file-serve-mode — sets the static file serving mode
--fileserve-mode — sets the static file serving mode
--disable-sendfile — disables sendfile() and relies on boring read()/write() (ngl the "boring" is the manpage's own words, I'm just the messenger 💀)
--check-cache — checks for response data in the cache you specify (empty means the 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)

✨ env, modes and tidying up ✨

--mode — set uWSGI custom mode
--env — set environment variable
--envdir — loads a daemontools compatible envdir
--early-envdir — loads a daemontools compatible envdir ASAP
--unenv — unsets environment variable
--vacuum — tries to remove all of the generated file/sockets 🧹
--file-write — writes the content you specify to the file you specify (syntax: file=value) before privileges drop
--cgroup — puts the processes in the cgroup you specify
--cgroup-opt — sets a value in the cgroup option you specify
--cgroup-dir-mode — sets permission for the cgroup directory (default is 700)
--namespace — runs in a new namespace under the rootfs you specify
--namespace-keep-mount — keeps the mountpoint you specify in your namespace
--ns — runs in a new namespace under the rootfs you specify
--namespace-net — adds a network namespace
--ns-net — adds a network namespace

🔥 socket behaviour, enter the zerg 🔥

--enable-proxy-protocol — enables PROXY1 protocol support (only for http parsers)
--reuse-port — enables the REUSE_PORT flag on the socket (BSD only, bestie, don't come for me)
--tcp-fast-open — enables the TCP_FASTOPEN flag on TCP sockets with the qlen value you specify
--tcp-fastopen — enables the TCP_FASTOPEN flag on TCP sockets with the qlen value you specify
--tcp-fast-open-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if it's supported
--tcp-fastopen-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if it's supported
--zerg — attach to a zerg server 🐛
--zerg-fallback — falls back to normal sockets if the zerg server isn't available
--zerg-server — enables the zerg server on the UNIX socket you specify

⏰ cron o'clock ⏰

--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 — adds a cron task runnable only when the instance is a lord of the legion you specify
--cron-legion — adds a cron task runnable only when the instance is a lord of the legion you specify
--unique-legion-cron — adds a unique cron task runnable only when the instance is a lord of the legion you specify
--unique-cron-legion — adds a unique cron task runnable only when the instance is a lord of the legion you specify

--loop — select the uWSGI loop engine
--loop-list — lists enabled loop engines
--loops-list — lists enabled loop engines
--worker-exec — runs the command you specify as worker
--worker-exec2 — runs the command you specify as worker (after the post_fork hook)

🫶 daemon attachment hours 🫶

--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 — opposite energy, same flag family)
--legion-attach-daemon — same as --attach-daemon but the daemon runs only on the legion lord node
--legion-smart-attach-daemon — same as --smart-attach-daemon but the daemon runs only on the legion lord node
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2 but the daemon runs only on the legion lord node
--daemons-honour-stdin — do not change the stdin of external daemons to /dev/null
--attach-daemon2 — attach-daemon keyval variant (supports smart modes too)

🧚 plugins, bestie 🧚

--plugins — load uWSGI plugins
--plugin — load uWSGI plugins
--need-plugins — load uWSGI plugins (exit on error)
--need-plugin — load uWSGI plugins (exit on error)
--plugins-dir — add a directory to the uWSGI plugin search path
--plugin-dir — add a directory to the uWSGI plugin search path
--plugins-list — lists enabled plugins
--plugin-list — lists enabled plugins
--autoload — tries to automatically load plugins when unknown options are found
--dlopen — blindly loads a shared library (yes. blindly. 🙈)
--allowed-modifiers — comma separated list of allowed modifiers
--remap-modifier — remap request modifier from one id to another

💅 the meta / dev-tools section 💅

--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 — force exit() of the instance
--cflags — report uWSGI CFLAGS (useful for building external plugins)
--dot-h — dump the uwsgi.h used for building the core (useful for building external plugins)
--config-py — dump the uwsgiconfig.py used for building the core (useful for building external plugins)
--build-plugin — build a uWSGI plugin for the current binary
--version — print uWSGI version
--response-headers-limit — set response header maximum size (default: 64k)

and that's the whole options list, bestie — every last flag, no skips, no summaries, we ate 🍓

and with that we're at the very end of the page, so here's the cute sign-off: this manual is for uwsgi_lua, version 2.0.31-2, dated February 2026, and it goes by UWSGI_LUA(1) when it's out in these streets 👑 thanks for reading all the way to the bottom, you're a real one 💜🦋

📦 where this page comes from

ubuntu resolute: uwsgi-plugin-lua5.1 2.0.31+2+0.0.2build2 · GPL-3.0-only
ubuntu stonking: uwsgi-plugin-lua5.1 2.0.31+2+0.0.2build2 · GPL-3.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