UWSGI_LUA51(1)

📦

version 2.0.24 · 3 versions

2.0.24 · ubuntu noble (latest)
2.0.20 · ubuntu jammy
2.0.21 · debian bookworm

💖 NAME 💖

okay so bestie, welcome to uwsgi_lua51 — it's a fast (pure C), self-healing, developer-friendly WSGI server. and yes, that's the whole vibe. 💅 (the manual page for this one is UWSGI_LUA51(1), fyi, in case you were wondering who you're talking to 🫶)

✨ SYNOPSIS ✨

uwsgi-core-local [options...]

like, that's it. you run the thing, you feed it options, it does the thing. main character energy fr fr. 🌈

🌸 DESCRIPTION 🌸

so here's the whole buffet of options. every single one, no skips, no skimming — we're going through all of them because that's just who we are. 💖

🦋 sockets & protocols

-s, --socket — bind to the specified UNIX/TCP socket using the default protocol
-s, --uwsgi-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol
--suwsgi-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol over SSL
--ssl-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol over SSL
--http-socket — bind to the specified UNIX/TCP socket using the HTTP protocol
--http-socket-modifier1 — force the specified modifier1 when you're using the HTTP protocol
--http-socket-modifier2 — force the specified modifier2 when you're using the HTTP protocol
--http11-socket — bind to the specified UNIX/TCP socket using the HTTP 1.1 (Keep-Alive) protocol
--https-socket — bind to the specified UNIX/TCP socket using the HTTPS protocol
--https-socket-modifier1 — force the specified modifier1 when you're using the HTTPS protocol
--https-socket-modifier2 — force the specified modifier2 when you're using the HTTPS protocol
--fastcgi-socket — bind to the specified UNIX/TCP socket using the FastCGI protocol
--fastcgi-nph-socket — bind to the specified UNIX/TCP socket using the FastCGI protocol (nph mode)
--fastcgi-modifier1 — force the specified modifier1 when you're using the FastCGI protocol
--fastcgi-modifier2 — force the specified modifier2 when you're using the FastCGI protocol
--scgi-socket — bind to the specified UNIX/TCP socket using the SCGI protocol
--scgi-nph-socket — bind to the specified UNIX/TCP socket using the SCGI protocol (nph mode)
--scgi-modifier1 — force the specified modifier1 when you're using the SCGI protocol
--scgi-modifier2 — force the specified modifier2 when you're using the SCGI protocol
--raw-socket — bind to the specified UNIX/TCP socket using the RAW protocol
--raw-modifier1 — force the specified modifier1 when you're using the RAW protocol
--raw-modifier2 — force the specified modifier2 when you're using the RAW protocol
--puwsgi-socket — bind to the specified UNIX/TCP socket using the 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, locks & harakiri

-p, --processes — spawn the specified number of workers/processes
-p, --workers — spawn the specified number of workers/processes
--thunder-lock — serialize accept() usage (if possible)
-t, --harakiri — set the harakiri timeout
--harakiri-verbose — enable verbose mode for harakiri
--harakiri-graceful-timeout — the interval between a 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 the 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 the backtrace depth
--mule-harakiri — set the harakiri timeout for mule tasks

🍓 config loading & the pluggable system

-x, --xmlconfig — load config from an xml file
-x, --xml — load config from an xml file
--config — load configuration using the pluggable system
--fallback-config — re-exec uwsgi with the specified config when the exit code is 1
--strict — enable strict mode (placeholder cannot be used)
--skip-zero — skip the 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)

💜 option logic (the if/for girlies)

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

🔥 allowlists, blocklists & being chill about errors

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

🎀 templating & includes

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

🌈 daemonizing & instance wrangling

-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

⭐ sizing, buffers & profiling

-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 the internal buffer size
-m, --memory-report — enable memory report
--profiler — enable the specified profiler

💅 socket vibes & permissions

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

🫶 threads, process names & the master

-T, --enable-threads — enable threads
--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 (yes, capital E, it earned it)

--emperor — run the Emperor
--emperor-proxy-socket — force the vassal to became an Emperor proxy
--emperor-wrapper — set a binary wrapper for vassals
--emperor-wrapper-override — set a binary wrapper for vassals to try before the default one
--emperor-wrapper-fallback — set a binary wrapper for vassals to try as a last resort
--emperor-nofollow — do not follow symlinks when checking for mtime
--emperor-procname — set the Emperor process name
--emperor-freq — set the Emperor scan frequency (default 3 seconds)
--emperor-required-heartbeat — set the Emperor tolerance about heartbeats
--emperor-curse-tolerance — set the Emperor tolerance about cursed vassals
--emperor-pidfile — write the Emperor pid in the specified file

and that's part 1, bestie — there's more coming so don't go anywhere 💜

--emperor-tyrant — put the Emperor in Tyrant mode 😈👑
--emperor-tyrant-nofollow — do not follow symlinks when checking for uid/gid in Tyrant mode 🚫🔗
--emperor-stats — run the Emperor stats server 📊
--emperor-stats-server — run the Emperor stats server 📊
--early-emperor — spawn the emperor as soon as possibile ✨
--emperor-broodlord — run the emperor in BroodLord mode 🐉
--emperor-throttle — set throttling level (in milliseconds) for bad behaving vassals (default 1000) 😤
--emperor-max-throttle — set max throttling level (in milliseconds) for bad behaving vassals (default 3 minutes) 😤
--emperor-magic-exec — prefix vassals config files with exec:// if they have the executable bit 🪄
--emperor-on-demand-extension — search for text file (vassal name + extension) containing the on demand socket name 🔎
--emperor-on-demand-ext — search for text file (vassal name + extension) containing the on demand socket name 🔎
--emperor-on-demand-directory — enable on demand mode binding to the unix socket in the specified directory named like the vassal + .socket 🔌
--emperor-on-demand-dir — enable on demand mode binding to the unix socket in the specified directory named like the vassal + .socket 🔌
--emperor-on-demand-exec — use the output of the specified command as on demand socket name (the vassal name is passed as the only argument) 🫡
--emperor-extra-extension — allows the specified extension in the Emperor (vassal will be called with --config) 🗂️
--emperor-extra-ext — allows the specified extension in the Emperor (vassal will be called with --config) 🗂️
--emperor-no-blacklist — disable Emperor blacklisting subsystem 🚫📋
--emperor-use-clone — use clone() instead of fork() passing the specified unshare() flags 🧬
--emperor-graceful-shutdown — use vassals graceful shutdown during ragnarok 🌅
--emperor-cap — set vassals capability 🧢
--vassals-cap — set vassals capability 🧢
--vassal-cap — set vassals capability 🧢
--imperial-monitor-list — list enabled imperial monitors 📜
--imperial-monitors-list — list enabled imperial monitors 📜
--vassals-inherit — add config templates to vassals config (uses --inherit) 🧬
--vassals-include — include config templates to vassals config (uses --include instead of --inherit) 📥
--vassals-inherit-before — add config templates to vassals config (uses --inherit, parses before the vassal file) ⏮️
--vassals-include-before — include config templates to vassals config (uses --include instead of --inherit, parses before the vassal file) ⏮️
--vassals-start-hook — run the specified command before each vassal starts 🏁
--vassals-stop-hook — run the specified command after vassal's death ⚰️
--vassal-sos — ask emperor for reinforcement when overloaded 🆘
--vassal-sos-backlog — ask emperor for sos if backlog queue has more items than the value specified 🆘📈
--vassals-set — automatically set the specified option (via --set) for every vassal 🎛️
--vassal-set — automatically set the specified option (via --set) for every vassal 🎛️
--heartbeat — announce healthiness to the emperor 💓
--reload-mercy — set the maximum time (in seconds) we wait for workers and other processes to die during reload/shutdown ⏳
--worker-reload-mercy — set the maximum time (in seconds) a worker can take to reload/shutdown (default is 60) ⏳
--mule-reload-mercy — set the maximum time (in seconds) a mule can take to reload/shutdown (default is 60) ⏳
--exit-on-reload — force exit even if a reload is requested 🚪
--die-on-term — exit instead of brutal reload on SIGTERM 💀
--force-gateway — force the spawn of the first registered gateway without a master 🚪
-h|--help — show this help ❓
-h|--usage — show this help ❓
--print-sym — print content of the specified binary symbol 🔣
--print-symbol — print content of the specified binary symbol 🔣
-r|--reaper — call waitpid(-1,...) after each request to get rid of zombies 🧟
-R|--max-requests — reload workers after the specified amount of managed requests 🔁
--min-worker-lifetime — number of seconds worker must run before being reloaded (default is 60) ⏱️
--max-worker-lifetime — reload workers after the specified amount of seconds (default is disabled) ⏱️
--max-worker-lifetime-delta — add (worker_id * delta) seconds to the max_worker_lifetime value of each worker ➕
-z|--socket-timeout — set internal sockets timeout ⏰
--no-fd-passing — disable file descriptor passing 🚫📁
--locks — create the specified number of shared locks 🔒
--lock-engine — set the lock engine 🔐
--ftok — set the ipcsem key via ftok() for avoiding duplicates 🔑
--persistent-ipcsem — do not remove ipcsem's on shutdown 🧷
-A|--sharedarea — create a raw shared memory area of specified pages (note: it supports keyval too) 🧠
--safe-fd — do not close the specified file descriptor 🛡️
--fd-safe — do not close the specified file descriptor 🛡️
--cache — create a shared cache containing given elements 🗃️
--cache-blocksize — set cache blocksize 🧱
--cache-store — enable persistent cache to disk 💾
--cache-store-sync — set frequency of sync for persistent cache 🔄
--cache-no-expire — disable auto sweep of expired items 🧹
--cache-expire-freq — set the frequency of cache sweeper scans (default 3 seconds) 🧹
--cache-report-freed-items — constantly report the cache item freed by the sweeper (use only for debug) 🐞
--cache-udp-server — bind the cache udp server (used only for set/update/delete) to the specified socket 📡
--cache-udp-node — send cache update/deletion to the specified cache udp server 📡
--cache-sync — copy the whole content of another uWSGI cache server on server startup 📦
--cache-use-last-modified — update last_modified_at timestamp on every cache item modification (default is disabled) 🕒
--add-cache-item — add an item in the cache ➕
--load-file-in-cache — load a static file in the cache 📄
--load-file-in-cache-gzip — load a static file in the cache with gzip compression 🗜️
--cache2 — create a new generation shared cache (keyval syntax) ✨
--queue — enable shared queue 📋
--queue-blocksize — set queue blocksize 🧱
--queue-store — enable persistent queue to disk 💾
--queue-store-sync — set frequency of sync for persistent queue 🔄
-Q|--spooler — run a spooler on the specified directory 🧵
--spooler-external — map spoolers requests to a spooler directory managed by an external instance 🌐
--spooler-ordered — try to order the execution of spooler tasks 🔢
--spooler-chdir — chdir() to specified directory before each spooler task 📂
--spooler-processes — set the number of processes for spoolers 👯
--spooler-quiet — do not be verbose with spooler tasks 🤫
--spooler-max-tasks — set the maximum number of tasks to run before recycling a spooler 🔄
--spooler-harakiri — set harakiri timeout for spooler tasks 🗡️
--spooler-frequency — set spooler frequency 📶
--spooler-freq — set spooler frequency 📶
--mule — add a mule 🫏
--mules — add the specified number of mules 🫏🫏
--farm — add a mule farm 🚜
--mule-msg-size — set mule message buffer size 📨
--signal — send a uwsgi signal to a server 📶
--signal-bufsize — set buffer size for signal queue 📶
--signals-bufsize — set buffer size for signal queue 📶
--signal-timer — add a timer (syntax: <signal> <seconds>) ⏲️
--timer — add a timer (syntax: <signal> <seconds>) ⏲️
--signal-rbtimer — add a redblack timer (syntax: <signal> <seconds>) ⏲️
--rbtimer — add a redblack timer (syntax: <signal> <seconds>) ⏲️
--rpc-max — maximum number of rpc slots (default: 64) 🔢
-L|--disable-logging — disable request logging 🚫📝
--flock — lock the specified file before starting, exit if locked 🔒
--flock-wait — lock the specified file before starting, wait if locked 🔒⏳
--flock2 — lock the specified file after logging/daemon setup, exit if locked 🔒
--flock-wait2 — lock the specified file after logging/daemon setup, wait if locked 🔒⏳
--pidfile — create pidfile (before privileges drop) 📝
--pidfile2 — create pidfile (after privileges drop) 📝
--safe-pidfile — create safe pidfile (before privileges drop) 🛡️📝
--safe-pidfile2 — create safe pidfile (after privileges drop) 🛡️📝
--chroot — chroot() to the specified directory 🏰
--pivot-root — pivot_root() to the specified directories (new_root and put_old must be separated with a space) 🔄
--pivot_root — pivot_root() to the specified directories (new_root and put_old must be separated with a space) 🔄
--uid — setuid to the specified user/uid 👤
--gid — setgid to the specified group/gid 👥
--add-gid — add the specified group id to the process credentials ➕👥
--immediate-uid — setuid to the specified user/uid IMMEDIATELY 🚨
--immediate-gid — setgid to the specified group/gid IMMEDIATELY 🚨
--no-initgroups — disable additional groups set via initgroups() 🚫👥
--cap — set process capability 🧢
--unshare — unshare() part of the processes and put it in a new namespace 🌌
--unshare2 — unshare() part of the processes and put it in a new namespace after rootfs change 🌌
--setns-socket — expose a unix socket returning namespace fds from /proc/self/ns 🔌
--setns-socket-skip — skip the specified entry when sending setns file descriptors ⏭️
--setns-skip — skip the specified entry when sending setns file descriptors ⏭️
--setns — join a namespace created by an external uWSGI instance 🌌
--setns-preopen — open /proc/self/ns as soon as possible and cache fds 🗂️
--jailed — mark the instance as jailed (force the execution of post_jail hooks) 🏷️
--refork — okay so this one does another fork() after privileges drop. It's giving jailing systems main character energy. ✨
--re-fork — literally same vibe as --refork: fork() again after privileges drop. Jailing systems, this is for you. 🫶
--refork-as-root — fork() again before privileges drop. Perfect for jailing systems. 💅
--re-fork-as-root — same as --refork-as-root: fork() again before privileges drop. Jailing systems stay winning. 👑
--refork-post-jail — fork() again after jailing. Useful for jailing systems. 🎀
--re-fork-post-jail — same energy as --refork-post-jail: fork() again after jailing. Jailing systems lowkey love this. 🌸
--hook-asap — run the specified hook as soon as possible. No waiting, bestie. ⚡
--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 enters the accepting phase. 👯
--hook-accepting1 — run the specified hook after the first worker enters the accepting phase. 🥇
--hook-accepting-once — run the specified hook after each worker enters the accepting phase (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 sends a stop message. 🛑
--hook-emperor-reload — run the specified hook when the Emperor sends a reload message. 🔄
--hook-emperor-lost — run the specified hook when the Emperor connection is lost. 💀
--hook-as-vassal — run the specified hook before exec()ing the vassal. 🧚
--hook-as-emperor — run the specified hook in the emperor after the vassal has been started. 👑
--hook-as-mule — run the specified hook in each mule. 🐴
--hook-as-gateway — run the specified hook in each gateway. 🚪
--after-request-hook — run the specified function/symbol after each request. 💌
--after-request-call — run the specified function/symbol after each request. Same vibe, different flag name. 📞
--exec-asap — run the specified command as soon as possible. ⚡
--exec-pre-jail — run the specified command before jailing. 🦋
--exec-post-jail — run the specified command after jailing. ✨
--exec-in-jail — run the specified command in jail after initialization. 🏰
--exec-as-root — run the specified command before privileges drop. 👑
--exec-as-user — run the specified command after privileges drop. 🫶
--exec-as-user-atexit — run the specified command before app exit and reload. 😭
--exec-pre-app — run the specified command before app loading. 📦
--exec-post-app — run the specified command after app loading. 🎉
--exec-as-vassal — run the specified command before exec()ing the vassal. 🧚
--exec-as-emperor — run the specified command in the emperor after the vassal has been started. 👑
--mount-asap — mount filesystem as soon as possible. 🗻
--mount-pre-jail — mount filesystem before jailing. 🦋
--mount-post-jail — mount filesystem after jailing. ✨
--mount-in-jail — mount filesystem in jail after initialization. 🏰
--mount-as-root — mount filesystem before privileges drop. 👑
--mount-as-vassal — mount filesystem before exec()ing the vassal. 🧚
--mount-as-emperor — mount filesystem in the emperor after the vassal has been started. 👑
--umount-asap — unmount filesystem as soon as possible. 🗻
--umount-pre-jail — unmount filesystem before jailing. 🦋
--umount-post-jail — unmount filesystem after jailing. ✨
--umount-in-jail — unmount filesystem in jail after initialization. 🏰
--umount-as-root — unmount filesystem before privileges drop. 👑
--umount-as-vassal — unmount filesystem before exec()ing the vassal. 🧚
--umount-as-emperor — unmount filesystem in the emperor after the vassal has been started. 👑
--wait-for-interface — wait for the specified network interface to come up before running root hooks. 📶
--wait-for-interface-timeout — set the timeout for wait-for-interface. ⏳
--wait-interface — wait for the specified network interface to come up before running root hooks. Same as --wait-for-interface. 📶
--wait-interface-timeout — set the timeout for wait-for-interface. ⏳
--wait-for-iface — wait for the specified network interface to come up before running root hooks. 📶
--wait-for-iface-timeout — set the timeout for wait-for-interface. ⏳
--wait-iface — wait for the specified network interface to come up before running root hooks. 📶
--wait-iface-timeout — set the timeout for wait-for-interface. ⏳
--wait-for-fs — wait for the specified filesystem item to appear before running root hooks. 📁
--wait-for-file — wait for the specified file to appear before running root hooks. 📄
--wait-for-dir — wait for the specified directory to appear before running root hooks. 📂
--wait-for-mountpoint — wait for the specified mountpoint to appear before running root hooks. 🗻
--wait-for-fs-timeout — set the timeout for wait-for-fs/file/dir. ⏳
--wait-for-socket — wait for the specified socket to be ready before loading apps. 🔌
--wait-for-socket-timeout — set the timeout for wait-for-socket. ⏳
--call-asap — call the specified function as soon as possible. 📞
--call-pre-jail — call the specified function before jailing. 🦋
--call-post-jail — call the specified function after jailing. ✨
--call-in-jail — call the specified function in jail after initialization. 🏰
--call-as-root — call the specified function before privileges drop. 👑
--call-as-user — call the specified function after privileges drop. 🫶
--call-as-user-atexit — call the specified function before app exit and reload. 😭
--call-pre-app — call the specified function before app loading. 📦
--call-post-app — call the specified function after app loading. 🎉
--call-as-vassal — call the specified function() before exec()ing the vassal. 🧚
--call-as-vassal1 — call the specified function(char *) before exec()ing the vassal. 🧚
--call-as-vassal3 — call the specified function(char *, uid_t, gid_t) before exec()ing the vassal. 🧚
--call-as-emperor — call the specified function() in the emperor after the vassal has been started. 👑
--call-as-emperor1 — call the specified function(char *) in the emperor after the vassal has been started. 👑
--call-as-emperor2 — call the specified function(char *, pid_t) in the emperor after the vassal has been started. 👑
--call-as-emperor4 — call the specified function(char *, pid_t, uid_t, gid_t) in the emperor after the vassal has been started. 👑
--ini — load config from ini file. 📄
-y|--yaml — load config from yaml file. 🧾
-y|--yml — load config from yaml file. 🧾
-j|--json — load config from json file. 🧾
-j|--js — load config from json file. 🧾
--weight — weight of the instance (used by clustering/lb/subscriptions). ⚖️
--auto-weight — set weight of the instance (used by clustering/lb/subscriptions) automatically. 🤖
--no-server — force no-server mode. 🚫
--command-mode — force command mode. 💻
--no-defer-accept — disable deferred-accept on sockets. 🚫
--tcp-nodelay — enable TCP NODELAY on each request. 📡
--so-keepalive — enable TCP KEEPALIVEs. 🔄
--so-send-timeout — set SO_SNDTIMEO. ⏳
--socket-send-timeout — set SO_SNDTIMEO. ⏳
--so-write-timeout — set SO_SNDTIMEO. ⏳
--socket-write-timeout — set SO_SNDTIMEO. ⏳
--socket-sndbuf — set SO_SNDBUF. 📦
--socket-rcvbuf — set SO_RCVBUF. 📥
--shutdown-sockets — force calling shutdown() in addition to close() when sockets are destroyed. 💥
--limit-as — limit processes address space/vsz. 🧠
--limit-nproc — limit the number of spawnable processes. 👥
--reload-on-as — reload if address space is higher than specified megabytes. 🔁
--reload-on-rss — reload if rss memory is higher than specified megabytes. 🔁
--evil-reload-on-as — force the master to reload a worker if its address space is higher than specified megabytes. 😈
--evil-reload-on-rss — force the master to reload a worker if its rss memory is higher than specified megabytes. 😈
--mem-collector-freq — set the memory collector frequency when evil reloads are in place. 🧹
--reload-on-fd — reload if the specified file descriptor is ready. 🔁
--brutal-reload-on-fd — brutal reload if the specified file descriptor is ready. 💀
--ksm — enable Linux KSM. 🐧
--pcre-jit — enable pcre jit (if available). ⚡
--never-swap — lock all memory pages avoiding swapping. 🔒
--touch-reload — reload uWSGI if the specified file is modified/touched. 👆
--touch-workers-reload — trigger reload of (only) workers if the specified file is modified/touched. 👆
--touch-mules-reload — reload mules if the specified file is modified/touched. 👆
--touch-spoolers-reload — reload spoolers if the specified file is modified/touched. 👆
--touch-chain-reload — trigger chain reload if the specified file is modified/touched. 👆
--touch-logrotate — trigger logrotation if the specified file is modified/touched. 👆
--touch-logreopen — trigger log reopen if the specified file is modified/touched. 👆
--touch-exec — run command when the specified file is modified/touched. Syntax: file command. 👆
--touch-signal — signal when the specified file is modified/touched. Syntax: file signal. 👆
--fs-reload — graceful reload when the filesystem object you specified gets modified. ✨
--fs-brutal-reload — brutal reload when that specified filesystem object changes. 💅
--fs-signal — raise a uwsgi signal when the specified filesystem object is modified. Syntax: file signal. 🫶
--check-mountpoint — destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management). 😭
--mountpoint-check — literally the same vibe as --check-mountpoint: destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management). 🦋
--check-mount — again, same energy: destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management). 💀
--mount-check — yes bestie, another alias: destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management). 🌸
--propagate-touch — over-engineering option for system with flaky signal management. 🙈
--limit-post — limit request body. 🎀
--no-orphans — automatically kill workers if master dies. Can be dangerous for availability. 👑
--prio — set processes/threads priority. ⭐
--cpu-affinity — set cpu affinity. 🔥
--post-buffering — set size in bytes after which will buffer to disk instead of memory. 💾
--post-buffering-bufsize — set buffer size for read() in post buffering mode. 🧚
--body-read-warning — set the amount of allowed memory allocation (in megabytes) for request body before starting printing a warning. 🍓
--upload-progress — enable creation of .json files in the specified directory during a file upload. 💜
--no-default-app — do not fallback to default app. 🚫
--manage-script-name — automatically rewrite SCRIPT_NAME and PATH_INFO. 🌈
--ignore-script-name — ignore SCRIPT_NAME. 🙅‍♀️
--catch-exceptions — report exception as http output. Discouraged, use only for testing. 🧪
--reload-on-exception — reload a worker when an exception is raised. 🔄
--reload-on-exception-type — reload a worker when a specific exception type is raised. 🌀
--reload-on-exception-value — reload a worker when a specific exception value is raised. 💥
--reload-on-exception-repr — reload a worker when a specific exception type+value (language-specific) is raised. 🫠
--exception-handler — add an exception handler. 🛠️
--enable-metrics — enable metrics subsystem. 📊
--metric — add a custom metric. 📈
--metric-threshold — add a metric threshold/alarm. 🚨
--metric-alarm — add a metric threshold/alarm. 🔔
--alarm-metric — add a metric threshold/alarm. ⏰
--metrics-dir — export metrics as text files to the specified directory. 📁
--metrics-dir-restore — restore last value taken from the metrics dir. ♻️
--metric-dir — export metrics as text files to the specified directory. 📂
--metric-dir-restore — restore last value taken from the metrics dir. 🔁
--metrics-no-cores — disable generation of cores-related metrics. 🚫

--udp — run the udp server on the specified address. 📡
--stats — enable the stats server on the specified address. 📊
--stats-server — enable the stats server on the specified address. 🖥️
--stats-http — prefix stats server json output with http headers. 🌐
--stats-minified — minify statistics json output. 🗜️
--stats-min — minify statistics json output. ✂️
--stats-push — push the stats json to the specified destination. 🚀
--stats-pusher-default-freq — set the default frequency of stats pushers. ⏱️
--stats-pushers-default-freq — set the default frequency of stats pushers. 🕰️
--stats-no-cores — disable generation of cores-related stats. 💔
--stats-no-metrics — do not include metrics in stats output. 🙈
--multicast — subscribe to specified multicast group. 📻
--multicast-ttl — set multicast ttl. ⏳
--multicast-loop — set multicast loop (default 1). 🔁
--master-fifo — enable the master fifo. 🎛️
--notify-socket — enable the notification socket. 🔔
--subscription-notify-socket — set the notification socket for subscriptions. 📬
--legion — became a member of a legion. ⚔️
--legion-mcast — became a member of a legion (shortcut for multicast). 📡
--legion-node — add a node to a legion. ➕
--legion-freq — set the frequency of legion packets. 📶
--legion-tolerance — set the tolerance of legion subsystem. 🫂
--legion-death-on-lord-error — declare itself as a dead node for the specified amount of seconds if one of the lord hooks fails. 💀
--legion-skew-tolerance — set the clock skew tolerance of legion subsystem (default 30 seconds). ⏰
--legion-lord — action to call on Lord election. 👑
--legion-unlord — action to call on Lord dismiss. 🫅
--legion-setup — action to call on legion setup. 🛠️
--legion-death — action to call on legion death (shutdown of the instance). ⚰️
--legion-join — action to call on legion join (first time quorum is reached). 🤝
--legion-node-joined — action to call on new node joining legion. 🎉
--legion-node-left — action to call node leaving legion. 👋
--legion-quorum — set the quorum of a legion. 🔢
--legion-scroll — set the scroll of a legion. 📜
--legion-scroll-max-size — set max size of legion scroll buffer. 📏
--legion-scroll-list-max-size — set max size of legion scroll list buffer. 📐
--subscriptions-sign-check — set digest algorithm and certificate directory for secured subscription system. 🔐
--subscriptions-sign-check-tolerance — set the maximum tolerance (in seconds) of clock skew for secured subscription system. ⏲️
--subscriptions-sign-skip-uid — skip signature check for the specified uid when using unix sockets credentials. 🆔
--subscriptions-credentials-check — add a directory to search for subscriptions key credentials. 🔑
--subscriptions-use-credentials — enable management of SCM_CREDENTIALS in subscriptions UNIX sockets. 🧾
--subscription-algo — set load balancing algorithm for the subscription system. ⚖️
--subscription-dotsplit — try to fallback to the next part (dot based) in subscription key. 🔍
--subscribe-to — subscribe to the specified subscription server. 📥
--st — subscribe to the specified subscription server. 📨
--subscribe — subscribe to the specified subscription server. 📩
--subscribe2 — subscribe to the specified subscription server using advanced keyval syntax. 🔑
--subscribe-freq — send subscription announce at the specified interval. 📢
--subscription-tolerance — set tolerance for subscription servers. 🤗
--unsubscribe-on-graceful-reload — force unsubscribe request even during graceful reload. 🚪
--start-unsubscribed — configure subscriptions but do not send them (useful with master fifo). 🔇
--subscribe-with-modifier1 — force the specififed modifier1 when subscribing. 🛠️

--snmp — enable the embedded snmp server. 🌲
--snmp-community — set the snmp community string. 🔤
--ssl-verbose — be verbose about SSL errors. 🗣️
--ssl-verify-depth — set maximum certificate verification depth. 📜
--sni — add an SNI-governed SSL context. 🪪
--sni-dir — check for cert/key/client_ca file in the specified directory and create a sni/ssl context on demand. 📂
--sni-dir-ciphers — set ssl ciphers for sni-dir option. 🔐
--ssl-enable3 — enable SSLv3 (insecure). ⚠️
--ssl-enable-sslv3 — enable SSLv3 (insecure). ⚠️
--ssl-enable-tlsv1 — enable TLSv1 (insecure). ⚠️
--ssl-option — set a raw ssl option (numeric value). 🔢
--sni-regexp — add an SNI-governed SSL context (the key is a regexp). 🧩
--ssl-tmp-dir — store ssl-related temp files in the specified directory. 🗂️
--check-interval — set the interval (in seconds) of master checks. ⏱️
--forkbomb-delay — sleep for the specified number of seconds when a forkbomb is detected. 💣
--binary-path — force binary path. 📍
--privileged-binary-patch — patch the uwsgi binary with a new command (before privileges drop). 🩹
--unprivileged-binary-patch — patch the uwsgi binary with a new command (after privileges drop). 🩹
--privileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments (before privileges drop). 🧰
--unprivileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments (after privileges drop). 🧰
--async — enable async mode with specified cores. ⚡
--max-fd — set maximum number of file descriptors (requires root privileges). 🔓
--logto — set logfile/udp address. 📝
--logto2 — log to specified file or udp address after privileges drop. 📝
--log-format — set advanced format for request logging. 🧾
--logformat — set advanced format for request logging. 🧾
--logformat-strftime — apply strftime to logformat output. 🕰️
--log-format-strftime — apply strftime to logformat output. 🕰️
--logfile-chown — chown logfiles. 👤
--logfile-chmod — chmod logfiles. 🔐
--log-syslog — log to syslog. 📮
--log-socket — send logs to the specified socket. 🧦
--req-logger — set/append a request logger. 📋
--logger-req — set/append a request logger. 📋
--logger — set/append a logger. 📝
--logger-list — list enabled loggers. 📃
--loggers-list — list enabled loggers. 📃
--threaded-logger — offload log writing to a thread. 🧵
--log-encoder — add an item in the log encoder chain. 🔗
--log-req-encoder — add an item in the log req encoder chain. 🔗
--log-drain — drain (do not show) log lines matching the specified regexp. 🚰
--log-filter — show only log lines matching the specified regexp. 🔎
--log-route — log to the specified named logger if regexp applied on logline matches. 🛤️
--log-req-route — log requests to the specified named logger if regexp applied on logline matches. 🛤️
--use-abort — call abort() on segfault/fpe, could be useful for generating a core dump. 💥
--alarm — create a new alarm, syntax: <alarm> <plugin:args>. ⏰
--alarm-cheap — use main alarm thread rather than create dedicated threads for curl-based alarms. 🧵
--alarm-freq — tunes the anti-loop alarm system. default is 3 seconds bestie, don't touch it unless you know what you're doing ✨
--alarm-fd — raises the specified alarm when an fd is read for read. by default it reads 1 byte, so set it to 8 for eventfd 💅
--alarm-segfault — raises the specified alarm whenever the segmentation fault handler gets executed 😭
--segfault-alarm — same exact vibe as --alarm-segfault, raises the specified alarm when the segfault handler runs 💀
--alarm-backlog — raises the specified alarm when the socket backlog queue is full 🚨
--backlog-alarm — yeah it's the same thing again, raise the specified alarm when the socket backlog queue fills up 🔥
--lq-alarm — raise the specified alarm when the socket backlog queue is full (listen queue edition, iykyk) 👑
--alarm-lq — raise the specified alarm when the socket backlog queue is full, same energy, different spelling 🦋
--alarm-listen-queue — raise the specified alarm when the socket backlog queue is full, longest name for the same iconic behavior ✨
--listen-queue-alarm — raise the specified alarm when the socket backlog queue is full, yes it's a twin 🫶
--log-alarm — raise the specified alarm whenever 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> (same as --log-alarm, just flipped) 🌸
--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 — lists all the enabled alarms, so you can see what's poppin' 👀
--alarms-list — list enabled alarms, plural bestie, same thing 🌈
--alarm-msg-size — sets the max size of an alarm message. default is 8192 🎀
--log-master — delegates the logging over to the master process, main character does the work ✨
--log-master-bufsize — sets the buffer size for the master logger. heads up: bigger log messages will get truncated 💀
--log-master-stream — creates the master logpipe as SOCK_STREAM 💅
--log-master-req-stream — creates the master requests logpipe as SOCK_STREAM, very specific, very slay 🔥
--log-reopen — reopens the log after a reload 🔄
--log-truncate — truncates the log on startup, fresh start energy 🫶
--log-maxsize — sets the maximum logfile size 📏
--log-backupname — sets the logfile name to use after rotation 🎀
--logdate — prefixes your logs with a date or a strftime string 🗓️
--log-date — prefixes logs with a date or a strftime string, same iconic behavior 🌸
--log-prefix — prefixes logs with a string you pick 💖
--log-zero — logs responses that have no body 👻
--log-slow — logs requests that are slower than the specified number of milliseconds 🐌
--log-4xx — logs requests that come back with a 4xx response 🚫
--log-5xx — logs requests that come back with a 5xx response 💀
--log-big — logs requests bigger than the specified size, big back energy 😭
--log-sendfile — logs the sendfile requests 📦
--log-ioerror — logs requests that hit io errors 😵
--log-micros — reports response time in microseconds instead of milliseconds, precision queen ⏱️
--log-x-forwarded-for — uses the ip from the X-Forwarded-For header instead of REMOTE_ADDR 🌐
--master-as-root — leaves the master process running as root 👑 (careful with that one bestie)
--drop-after-init — runs the privileges drop after plugin initialization. heads up, this is superseded by drop-after-apps 💅
--drop-after-apps — runs the privileges drop after apps loading. superseded by master-as-root ✨
--force-cwd — forces the initial working directory to the value you specify 📁
--binsh — overrides /bin/sh. used by exec hooks, and it always falls back to /bin/sh no matter what 🫶
--chdir — chdirs to the specified directory before apps loading 🚪
--chdir2 — chdirs to the specified directory after apps loading, sequencing matters bestie 💅
--lazy — sets lazy mode, which loads apps in the workers instead of the master 😴
--lazy-apps — loads apps in each worker instead of the master, same lazy vibe different name 🌸
--cheap — sets cheap mode: workers only spawn after the very first request 💸
--cheaper — sets cheaper mode, aka adaptive process spawning ✨
--cheaper-initial — sets the initial number of processes to spawn in cheaper mode 🎀
--cheaper-algo — chooses the algorithm used for adaptive process spawning 🧠
--cheaper-step — the number of additional processes to spawn at each overload 📈
--cheaper-overload — increases workers after the specified overload 🔥
--cheaper-algo-list — lists the enabled cheapers algorithms 👀
--cheaper-algos-list — list enabled cheapers algorithms, plural version, still iconic 🌈
--cheaper-list — list enabled cheapers algorithms, yes another one 💜
--cheaper-rss-limit-soft — won't spawn new workers if the total resident memory usage of all workers goes higher than this limit 🧊
--cheaper-rss-limit-hard — if the total workers resident memory usage is higher, it tries to stop workers 💀
--idle — sets idle mode, which puts uWSGI into cheap mode after inactivity 😴
--die-on-idle — shuts down uWSGI when it's idle, dramatic but valid 💅
--mount — loads the application under the mountpoint 📌
--worker-mount — loads the application under the mountpoint in the specified worker, or after workers spawn 🛠️
--threads — runs each worker in prethreaded mode with the specified number of threads 🧵
--thread-stacksize — sets the threads stacksize 📚
--threads-stacksize — sets the threads stacksize, same thing bestie ✨
--thread-stack-size — sets the threads stacksize, third twin in the lineup 🌸
--threads-stack-size — sets the threads stacksize, fourth and final twin 💖
--vhost — enables virtualhosting mode, based on the SERVER_NAME variable 🌐
--vhost-host — enables virtualhosting mode, based on the HTTP_HOST variable 🏠
--route — adds a route 🛣️
--route-host — adds a route based on the Host header 👑
--route-uri — adds a route based on REQUEST_URI 🔗
--route-qs — adds a route based on QUERY_STRING ❓
--route-remote-addr — adds a route based on REMOTE_ADDR 📍
--route-user-agent — adds a route based on HTTP_USER_AGENT 🕵️
--route-remote-user — adds a route based on REMOTE_USER 🙋
--route-referer — adds a route based on HTTP_REFERER 🔙
--route-label — adds a routing label, for use with goto 🏷️
--route-if — adds a route based on a condition 🧩
--route-if-not — adds a route based on a condition, the negate version 🙃
--route-run — always runs the specified route action, no conditions, it just goes 🏃
--final-route — adds a final route 🏁
--final-route-status — adds a final route for the specified status 🔢
--final-route-host — adds a final route based on the Host header 👑
--final-route-uri — adds a final route based on REQUEST_URI 🔗
--final-route-qs — adds a final route based on QUERY_STRING ❓
--final-route-remote-addr — adds a final route based on REMOTE_ADDR 📍
--final-route-user-agent — adds a final route based on HTTP_USER_AGENT 🕵️
--final-route-remote-user — adds a final route based on REMOTE_USER 🙋
--final-route-referer — adds a final route based on HTTP_REFERER 🔙
--final-route-label — adds a final routing label, for use with goto 🏷️
--final-route-if — adds a final route based on a condition 🧩
--final-route-if-not — adds a final route based on a condition, the negate version 🙃
--final-route-run — always runs the specified final route action 🏃
--error-route — adds an error route 🚨
--error-route-status — adds an error route for the specified status 🔢
--error-route-host — adds an error route based on the Host header 👑
--error-route-uri — adds an error route based on REQUEST_URI 🔗
--error-route-qs — adds an error route based on QUERY_STRING ❓
--error-route-remote-addr — adds an error route based on REMOTE_ADDR 📍
--error-route-user-agent — adds an error route based on HTTP_USER_AGENT 🕵️
--error-route-remote-user — adds an error route based on REMOTE_USER 🙋
--error-route-referer — adds an error route based on HTTP_REFERER 🔙
--error-route-label — adds an error routing label, for use with goto 🏷️
--error-route-if — adds an error route based on a condition 🧩
--error-route-if-not — adds an error route based on a condition, the negate version 🙃
--error-route-run — always runs the specified error route action 🏃
--response-route — adds a response route 📬
--response-route-status — adds a response route for the specified status 🔢
--response-route-host — adds a response route based on the Host header 👑
--response-route-uri — adds a response route based on REQUEST_URI 🔗
--response-route-qs — adds a response route based on QUERY_STRING ❓
--response-route-remote-addr — adds a response route based on REMOTE_ADDR 📍
--response-route-user-agent — adds a response route based on HTTP_USER_AGENT 🕵️
--response-route-remote-user — adds a response route based on REMOTE_USER 🙋
--response-route-referer — adds a response route based on HTTP_REFERER 🔙
--response-route-label — adds a response routing label, for use with goto 🏷️
--response-route-if — adds a response route based on a condition 🧩
--response-route-if-not — adds a response route based on a condition, the negate version 🙃
--response-route-run — always runs the specified response route action 🏃
--router-list — lists the enabled routers 👀
--routers-list — list enabled routers, plural, still slay 🌈
--error-page-403 — adds an error page (html) for the managed 403 response 🚫
--error-page-404 — adds an error page (html) for the managed 404 response 🔍
--error-page-500 — adds an error page (html) for the managed 500 response 💥
--websockets-ping-freq — sets the frequency (in seconds) of the websockets automatic ping packets 🏓
--websocket-ping-freq — sets the frequency (in seconds) of websockets automatic ping packets, same thing ✨
--websockets-pong-tolerance — sets the tolerance (in seconds) of the websockets ping/pong subsystem 🎾
--websocket-pong-tolerance — sets the tolerance (in seconds) of the websockets ping/pong subsystem, identical twin 💖
--websockets-max-size — sets the max allowed size of websocket messages, in Kbytes, default 1024 📏
--websocket-max-size — sets the max allowed size of websocket messages, in Kbytes, default 1024, yes same one 🌸
--chunked-input-limit — sets the max size of a chunked input part, default 1MB, in bytes 🧱
--chunked-input-timeout — sets the default timeout for chunked input ⏳
--clock — sets a clock source ⏰
--clock-list — lists the enabled clocks 👀
--clocks-list — list enabled clocks, plural edition 🌈
--add-header — automatically adds HTTP headers to the response 💌
--rem-header — auto-yeets the HTTP header you name right out of the response 💅
--del-header — same energy as above: it automatically removes the specified HTTP header from the response
--collect-header — stashes the specified response header into a request var (syntax: header var) 🎀
--response-header-collect — yep, also stashes the specified response header into a request var (syntax: header var)
--pull-header — grabs the specified response header, saves it in a request var, AND deletes it from the response (syntax: header var) — two-for-one, iconic
--check-static — peeks for static files in the directory you specify 📂
--check-static-docroot — peeks for static files in the requested DOCUMENT_ROOT
--static-check — again: checks for static files in the specified directory
--static-map — maps a mountpoint to a static directory (or file)
--static-map2 — like --static-map, except it fully appends the requested resource onto the docroot
--static-skip-ext — skips the extension you name when doing staticfile checks
--static-index — if a directory gets requested, it searches for the file you specified 🌸
--static-safe — skips security checks when the file lives under the path you give it
--static-cache-paths — drops resolved paths into the uWSGI cache for however many seconds you say
--static-cache-paths-name — uses the cache you name for those 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) — twin, not a sequel
--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 a 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 a 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 a PATH_INFO regexp
--static-expires-path-info-mtime — sets the Expires header based on PATH_INFO regexp and file mtime

--static-gzip — if your regexp matches the static file translation, it goes looking for a gzip version 🗜️
--static-gzip-all — checks for a gzip version of literally every requested static file
--static-gzip-dir — checks for a gzip version of all requested static files inside the dir/prefix you name
--static-gzip-prefix — same thing: gzip version of all requested static files in the specified dir/prefix
--static-gzip-ext — checks for a gzip version of all requested static files with the ext/suffix you specify
--static-gzip-suffix — same deal, specified ext/suffix 🦋
--honour-range — turns on support for the HTTP Range header
--offload-threads — sets how many offload threads to spawn (per-worker, default 0)
--offload-thread — sets how many 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 (same vibe, different spelling)
--disable-sendfile — disables sendfile() and relies on boring old read()/write() 😴
--check-cache — checks for response data in the cache you name (leave it empty for 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)
--mode — sets a uWSGI custom mode
--env — sets an environment variable
--envdir — loads a daemontools compatible envdir
--early-envdir — loads a daemontools compatible envdir ASAP ⚡
--unenv — unsets an environment variable
--vacuum — tries to remove every generated file/socket it made 🧹
--file-write — writes the content you specify into the file you specify (syntax: file=value) before privileges drop
--cgroup — puts the processes into the cgroup you name
--cgroup-opt — sets a value in the specified cgroup option
--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 name inside your namespace
--ns — runs in a new namespace under the specified rootfs
--namespace-net — adds a network namespace
--ns-net — adds a network namespace
--enable-proxy-protocol — enables PROXY1 protocol support (only for http parsers)
--reuse-port — enables the REUSE_PORT flag on the socket (BSD only)
--tcp-fast-open — enables the TCP_FASTOPEN flag on TCP sockets with the qlen value you give
--tcp-fastopen — enables the TCP_FASTOPEN flag on TCP sockets with the specified qlen value
--tcp-fast-open-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() when it's supported
--tcp-fastopen-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() when supported
--zerg — attaches to a zerg server 👾
--zerg-fallback — falls back to normal sockets if the zerg server isn't around
--zerg-server — enables the zerg server on the UNIX socket you specify

--cron — adds a cron task ⏰
--cron2 — adds a cron task (key=val syntax)
--unique-cron — adds a unique cron task
--cron-harakiri — sets the max time (in seconds) we wait for a cron command to finish
--legion-cron — adds a cron task that only runs 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 specified legion
--unique-legion-cron — adds a unique cron task runnable only when the instance is a lord of the specified legion
--unique-cron-legion — adds a unique cron task runnable only when the instance is a lord of the specified legion
--loop — selects the uWSGI loop engine
--loop-list — lists the enabled loop engines
--loops-list — lists the enabled loop engines
--worker-exec — runs the command you specify as a worker
--worker-exec2 — runs the specified command as a worker (after the post_fork hook)
--attach-daemon — attaches a command/daemon to the master process (the command must not go in background)
--attach-control-daemon — attaches a command/daemon to the master process (the command must not go in background), and when that daemon dies, the master dies too 💀
--smart-attach-daemon — attaches a command/daemon to the master process managed by a pidfile (the command has to daemonize)
--smart-attach-daemon2 — attaches a command/daemon to the master process managed by a pidfile (the command has to NOT daemonize)
--legion-attach-daemon — same as --attach-daemon, except the daemon only runs on a legion lord node
--legion-smart-attach-daemon — same as --smart-attach-daemon, except the daemon only runs on a legion lord node
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2, except the daemon only runs on a legion lord node
--daemons-honour-stdin — does not swap the stdin of external daemons over to /dev/null
--attach-daemon2 — the attach-daemon keyval variant (supports smart modes too)
--plugins — loads uWSGI plugins 🔌
--plugin — loads uWSGI plugins
--need-plugins — loads uWSGI plugins (and exits on error)
--need-plugin — loads uWSGI plugins (exit on error)
--plugins-dir — adds a directory to the uWSGI plugin search path
--plugin-dir — adds a directory to the uWSGI plugin search path
--plugins-list — lists the enabled plugins
--plugin-list — lists the enabled plugins
--autoload — tries to automatically load plugins whenever unknown options show up
--dlopen — blindly loads a shared library 🙈
--allowed-modifiers — comma separated list of allowed modifiers
--remap-modifier — remaps a request modifier from one id to another
--dump-options — dumps the full list of available options
--show-config — shows the current config reformatted as ini
--binary-append-data — returns the content of a resource to stdout so you can append it to a uwsgi binary (for data:// usage)
--print — simple print
--iprint — simple print (immediate version)
--exit — forces exit() of the instance
--cflags — reports uWSGI CFLAGS (useful for building external plugins)
--dot-h — dumps the uwsgi.h used for building the core (useful for building external plugins)
--config-py — dumps the uwsgiconfig.py used for building the core (useful for building external plugins)
--build-plugin — builds a uWSGI plugin for the current binary
--version — prints the uWSGI version
--response-headers-limit — sets the response header maximum size (default: 64k)
--lua — loads a lua wsapi app 🧚
--lua-load — loads a lua file
--lua-shell — runs the lua interactive shell (debug.debug())
--luashell — runs the lua interactive shell (debug.debug())
--lua-gc-freq — sets the lua gc frequency (default: 0, runs after every request)

And that's a wrap on this whole thing bestie, no cap 🫶 this page comes from uwsgi_lua51, version 2.0.24-debian, dated April 2024 — go forth and slay ✨👑

📦 where this page comes from

ubuntu noble: uwsgi-plugin-lua5.1 2.0.24-2ubuntu10 · GPL-2.0-only
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-18: a language model's rewrite of the original, under its terms