UWSGI_LUA52(1)

📦

version 2.0.21 · 2 versions

2.0.21 · debian bookworm (latest)
2.0.20 · ubuntu jammy

💖 NAME 💖

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

okay so hi bestie 🫶 this is the UWSGI_LUA52(1) page, filed under User Commands, and yeah it is long. we're doing it in six parts, so hydrate, stretch, and do not panic 🍓

✨ SYNOPSIS ✨

uwsgi-core-local [options...]

🦋 DESCRIPTION 🦋

so here's the thing — this whole section is basically the master list of options. every single one. we're not skipping a single flag, not even the ones that look like a typo, because they are real and they are iconic 💅

-s, --socket — bind to the UNIX/TCP socket you name, using the default protocol
-s, --uwsgi-socket — bind to the UNIX/TCP socket you name, using the uwsgi protocol
--suwsgi-socket — bind to the UNIX/TCP socket you name, using the uwsgi protocol over SSL 🔒
--ssl-socket — bind to the UNIX/TCP socket you name, using the uwsgi protocol over SSL 🔒
--http-socket — bind to the UNIX/TCP socket you name, using the HTTP protocol
--http-socket-modifier1 — force the modifier1 you specify when using the HTTP protocol
--http-socket-modifier2 — force the modifier2 you specify when using the HTTP protocol
--http11-socket — bind to the UNIX/TCP socket you name, using the HTTP 1.1 (Keep-Alive) protocol
--https-socket — bind to the UNIX/TCP socket you name, using the HTTPS protocol
--https-socket-modifier1 — force the modifier1 you specify when using the HTTPS protocol
--https-socket-modifier2 — force the modifier2 you specify when using the HTTPS protocol
--fastcgi-socket — bind to the UNIX/TCP socket you name, using the FastCGI protocol
--fastcgi-nph-socket — bind to the UNIX/TCP socket you name, using the FastCGI protocol (nph mode)
--fastcgi-modifier1 — force the modifier1 you specify when using the FastCGI protocol
--fastcgi-modifier2 — force the modifier2 you specify when using the FastCGI protocol
--scgi-socket — bind to the UNIX/TCP socket you name, using the SCGI protocol
--scgi-nph-socket — bind to the UNIX/TCP socket you name, using the SCGI protocol (nph mode)
--scgi-modifier1 — force the modifier1 you specify when using the SCGI protocol
--scgi-modifier2 — force the modifier2 you specify when using the SCGI protocol
--raw-socket — bind to the UNIX/TCP socket you name, using the RAW protocol
--raw-modifier1 — force the modifier1 you specify when using the RAW protocol
--raw-modifier2 — force the modifier2 you specify when using the RAW protocol
--puwsgi-socket — bind to the UNIX/TCP socket you name, using the persistent uwsgi protocol (puwsgi)
--protocol — force the protocol you specify for default sockets
--socket-protocol — force the protocol you specify 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)
-p, --processes — spawn the number of workers/processes you specify
-p, --workers — spawn the number of workers/processes you specify
--thunder-lock — serialize accept() usage (if possible) ⚡
-t, --harakiri — set the harakiri timeout
--harakiri-verbose — turn on verbose mode for harakiri
--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
-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 config you specify 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 value of the option you specify 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 placeholder you specify, 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 number you specify to a list starting from 1)
--for-readline — (opt logic) for cycle (expand the file you specify 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 the hostname against a regular expression
--if-not-hostname-match — (opt logic) try to match the 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
--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 the (annoying) SIGPIPE
--ignore-write-errors — do not report the (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 file you specify as a config template
--include — include the file you specify 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)
-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
-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 profiler you specify
-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 🧵
--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
--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 file you specify
--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

okay that's part 1 bestie, hold on, there's more coming 💅

✨ OPTIONS ✨

okay bestie, deep breath, because this is the list. every single flag uWSGI will hand you, in order, no skips, no "and then some other stuff". grab a snack 🍓, we're doing all of them.

--early-emperor — spawns the emperor as soon as possibile. (yes, "possibile". that's the original's spelling and we respect it 💅)
--emperor-broodlord — runs the emperor in BroodLord mode. that's genuinely the name. no notes. 👑
--emperor-throttle — sets the throttling level, in milliseconds, for vassals that are behaving badly. default is 1000.
--emperor-max-throttle — sets the max throttling level, in milliseconds, for those badly-behaving vassals. default is 3 minutes.
--emperor-magic-exec — prefixes vassal config files with exec:// if they have the executable bit. magic, literally ✨
--emperor-on-demand-extension — searches for a text file (vassal name + extension) that contains the on demand socket name.
--emperor-on-demand-ext — same thing, shorter name. twins 👯
--emperor-on-demand-directory — turns on on demand mode, binding to the unix socket in the directory you specify, named like the vassal + .socket.
--emperor-on-demand-dir — the alias of the one above. same energy, fewer letters.
--emperor-on-demand-exec — uses the output of the command you give it as the on demand socket name. the vassal name is passed as the only argument.
--emperor-extra-extension — allows the extension you specify in the Emperor (the vassal will be called with --config).
--emperor-extra-ext — alias, again. we love a short form.
--emperor-no-blacklist — disables the Emperor blacklisting subsystem. no blacklist, no drama 🙈
--emperor-use-clone — uses clone() instead of fork(), passing the unshare() flags you specify.
--emperor-graceful-shutdown — uses vassals graceful shutdown during ragnarok. yes, ragnarok. iconic naming, honestly.
--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. (one little s away from its sibling, that's it)
--vassals-inherit — adds config templates to the vassals config (uses --inherit).
--vassals-include — includes config templates into the vassals config (uses --include instead of --inherit).
--vassals-inherit-before — adds config templates to the vassals config (uses --inherit, and parses before the vassal file).
--vassals-include-before — includes config templates into the vassals config (uses --include instead of --inherit, and parses before the vassal file).
--vassals-start-hook — runs the command you specify before each vassal starts.
--vassals-stop-hook — runs the command you specify after a vassal's death 💀
--vassal-sos — asks the emperor for reinforcement when it's overloaded. 🆘
--vassal-sos-backlog — asks the emperor for sos if the backlog queue has more items than the value you specify.
--vassals-set — automatically sets the option you specify (via --set) for every vassal.
--vassal-set — automatically sets the option you specify (via --set) for every vassal.
--heartbeat — announces healthiness to the emperor 💖
--reload-mercy — sets the maximum time, in seconds, that we wait for workers and other processes to die during reload/shutdown.
--worker-reload-mercy — sets the maximum time, in seconds, that a worker can take to reload/shutdown. default is 60.
--mule-reload-mercy — sets the maximum time, in seconds, that a mule can take to reload/shutdown. default is 60.
--exit-on-reload — forces an exit even if a reload was requested.
--die-on-term — exit instead of a brutal reload on SIGTERM.
--force-gateway — forces the spawn of the first registered gateway without a master.
-h|--help — show this help. hi 🫶
-h|--usage — show this help. same, different name.
--print-sym — prints the content of the binary symbol you specify.
--print-symbol — prints the content of the binary symbol you specify.
-r|--reaper — calls waitpid(-1,...) after each request to get rid of zombies 🧟
-R|--max-requests — reloads workers after the specified amount of managed requests.
--min-worker-lifetime — the number of seconds a worker must run before it gets reloaded. default is 60.
--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() for avoiding duplicates.
--persistent-ipcsem — does not remove ipcsems on shutdown.
-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 — does not close the file descriptor you specify.
--cache — creates a shared cache containing the given elements.
--cache-blocksize — sets the cache blocksize.
--cache-store — enables persistent cache to disk.
--cache-store-sync — sets the sync frequency for the persistent cache.
--cache-no-expire — disables the auto sweep of expired items.
--cache-expire-freq — sets how often the cache sweeper scans. default is 3 seconds.
--cache-report-freed-items — constantly reports the cache item freed by the sweeper. > use only for debug.
--cache-udp-server — binds the cache udp server (used only for set/update/delete) to the 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 server startup.
--cache-use-last-modified — updates the last_modified_at timestamp on every cache item modification. default is disabled.
--add-cache-item — adds an item in the cache.
--load-file-in-cache — loads a static file in the cache.
--load-file-in-cache-gzip — loads a static file in the cache with gzip compression.
--cache2 — creates a new generation shared cache (keyval syntax).
--queue — enables the shared queue.
--queue-blocksize — sets the queue blocksize.
--queue-store — enables persistent queue to disk.
--queue-store-sync — sets the sync frequency for the 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 — does not be verbose with spooler tasks. (the original's words, not mine, and honestly? a mood)
--spooler-max-tasks — sets the maximum number of tasks to run before recycling a spooler.
--spooler-harakiri — sets the harakiri timeout for spooler tasks.
--spooler-frequency — sets the spooler frequency.
--spooler-freq — sets the spooler frequency.
--mule — add a mule.
--mules — adds the specified number of mules.
--farm — add a mule farm. 🐴
--mule-msg-size — sets the mule message buffer size.
--signal — sends a uwsgi signal to a server.
--signal-bufsize — sets the buffer size for the signal queue.
--signals-bufsize — sets the buffer size for the signal queue.
--signal-timer — adds a timer (syntax: <signal> <seconds>).
--timer — adds a timer (syntax: <signal> <seconds>).
--signal-rbtimer — adds a redblack timer (syntax: <signal> <seconds>).
--rbtimer — adds a redblack timer (syntax: <signal> <seconds>).
--rpc-max — maximum number of rpc slots. default: 64.
-L|--disable-logging — disables request logging.
--flock — locks the file you specify before starting, and exits if it's locked.
--flock-wait — locks the file you specify before starting, and waits if it's locked.
--flock2 — locks the file you specify after logging/daemon setup, and exits if it's locked.
--flock-wait2 — locks the file you specify after logging/daemon setup, and waits if it's 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 directories you specify (new_root and put_old must be separated with a space).
--pivot_root — pivot_root()s to the directories you specify (new_root and put_old must be separated with a space).
--uid — setuid to the user/uid you specify.
--gid — setgid to the group/gid you specify.
--add-gid — adds the group id you specify to the process credentials.
--immediate-uid — setuid to the user/uid you specify IMMEDIATELY. like, right now. no waiting. 🔥
--immediate-gid — setgid to the group/gid you specify IMMEDIATELY.
--no-initgroups — disables the additional groups set via initgroups().
--cap — sets the process capability.
--unshare — unshare()s part of the processes and puts them in a new namespace.
--unshare2 — unshare()s part of the processes and puts them in a new namespace, but after the 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 — skips the entry you specify 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 the fds.
--jailed — marks the instance as jailed (forces the execution of post_jail hooks).
--refork — fork()s again after the privileges drop. useful for jailing systems.
--re-fork — fork()s again after the privileges drop. useful for jailing systems.
--refork-as-root — fork()s again before the privileges drop. useful for jailing systems.
--re-fork-as-root — fork()s again before the privileges drop. useful for jailing systems.

okay bestie we're back and the option list is still going 😭 like she's not done, she's never done, and honestly? we respect it. buckle up, keep your <rainbow>little notebook out, bc these are all the lifecycle-spot hooks and friends 💅

--refork-post-jail — fork() again after jailing. genuinely useful for jailing systems, no cap 🦋
--re-fork-post-jail — same energy, fork() again after jailing. also useful for jailing systems ✨

💖 the hook era 💖

okay so these all take a hook and run it at a very specific moment in uWSGI's little life. the way that timing is everything — iykyk 🎀

--hook-asap — run the specified hook as soon as possible ⚡
--hook-pre-jail — run the specified hook before jailing 🔒
--hook-post-jail — run the specified hook after jailing 🔓
--hook-in-jail — run the specified hook in jail after initialization 🏠
--hook-as-root — run the specified hook before privileges drop 👑
--hook-as-user — run the specified hook after privileges drop 🙋
--hook-as-user-atexit — run the specified hook before app exit and reload 🚪
--hook-pre-app — run the specified hook before app loading 📦
--hook-post-app — run the specified hook after app loading 🎁
--hook-post-fork — run the specified hook after each fork 🍴
--hook-accepting — run the specified hook after each worker 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 🫶 (yes bestie, same description, she's giving twin energy)

⚡ exec era ⚡

same timing drama as the hooks but it runs a command instead of a hook. main character behaviour fr 💅

--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 / umount era 🌈

mounting and unmounting filesystems, but make it ✨scheduled✨

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

bestie just. wait. for the thing. to show up. patience is a vibe 💜

--wait-for-interface — wait for the specified network interface to come up before running root hooks 📡
--wait-for-interface-timeout — set the timeout for wait-for-interface ⏳
--wait-interface — wait for the specified network interface to come up before running root hooks 📡
--wait-interface-timeout — set the timeout for wait-for-interface ⏳
--wait-for-iface — wait for the specified network interface to come up before running root hooks 📡
--wait-for-iface-timeout — set the timeout for wait-for-interface ⏳
--wait-iface — wait for the specified network interface to come up before running root hooks 📡
--wait-iface-timeout — set the timeout for wait-for-interface ⏳
--wait-for-fs — wait for the specified filesystem item to appear before running root hooks 📁
--wait-for-file — wait for the specified file to appear before running root hooks 📄
--wait-for-dir — wait for the specified directory to appear before running root hooks 📂
--wait-for-mountpoint — wait for the specified mountpoint to appear before running root hooks 🔌
--wait-for-fs-timeout — set the timeout for wait-for-fs/file/dir ⏳
--wait-for-socket — wait for the specified socket to be ready before loading apps 🔌
--wait-for-socket-timeout — set the timeout for wait-for-socket ⏳

🎀 call era 🎀

like exec, but it calls a function instead of a command. and some of them pass ✨arguments✨ so the signature matters, don't skip those 🫶

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

🍓 config loading era 🍓

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

⭐ modes & weights ⭐

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

🔥 socket behaviour era 🔥

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

💀 limits & reload drama 💀

bestie these are the "your worker is eating too much and we must intervene" options. the evil- ones are literally called evil, that's not me being dramatic, that's the actual flag name 😭

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

🌸 kernel & memory era 🌸

--ksm — enable Linux KSM 🐧
--pcre-jit — enable pcre jit (if available) ⚡
--never-swap — lock all memory pages avoiding swapping 🔒

👆 touch & fs era 👆

the "poke a file and something happens" section. it's giving magic button 🔮

--touch-reload — reload uWSGI if the specified file is modified/touched 🔄
--touch-workers-reload — trigger reload of (only) workers if the specified file is modified/touched 👷
--touch-mules-reload — reload mules if the specified file is modified/touched 🐴
--touch-spoolers-reload — reload spoolers if the specified file is modified/touched 🌀
--touch-chain-reload — trigger chain reload if the specified file is modified/touched ⛓️
--touch-logrotate — trigger logrotation if the specified file is modified/touched 📜
--touch-logreopen — trigger log reopen if the specified file is modified/touched 📂
--touch-exec — run command when the specified file is modified/touched (syntax: file command) 👆
--touch-signal — signal when the specified file is modified/touched (syntax: file signal) 👆
--fs-reload — graceful reload when the specified filesystem object is modified 🌿
--fs-brutal-reload — brutal reload when the specified filesystem object is modified 💥
--fs-signal — raise a uwsgi signal when the specified filesystem object is modified (syntax: file signal) 📶

and bestie… we're still not done 😭 she keeps going. next part, yeah? 🫶

--check-mountpoint — if a filesystem stops being reachable, the instance gets destroyed. lowkey a lifesaver for reliable Fuse management 💅
--mountpoint-check — same exact vibe: filesystem goes unreachable → instance destroyed. yes bestie, it's a twin, not a typo, they're both here. useful for reliable Fuse management 🦋
--check-mount — you guessed it: filesystem unreachable → instance destroyed. (reliable Fuse management agenda ✨)
--mount-check — and the fourth twin of the family: unreachable filesystem = destroyed instance. useful for reliable Fuse management 🎀
--propagate-touch — an over-engineering option, fr fr, made for systems with flaky signal management 🙈
--limit-post — caps the request body. that's it, that's the whole girl ✋
--no-orphans — workers get auto-killed if the master dies. > heads up bestie: this can be dangerous for availability, so don't just turn it on and forget it 💀
--prio — set processes/threads priority 👑
--cpu-affinity — set cpu affinity 🌸
--post-buffering — set the size in bytes after which stuff gets buffered to disk instead of memory 💾
--post-buffering-bufsize — set the buffer size for read() when you're in post buffering mode 🍓
--body-read-warning — set how much memory allocation (in megabytes) is allowed for a request body before it starts printing a warning at you 📢
--upload-progress — enables creation of .json files in the directory you specify, while a file upload is happening 🌀
--no-default-app — do not fallback to default app. no plan B energy 🚫
--manage-script-name — automatically rewrites SCRIPT_NAME and PATH_INFO ✨
--ignore-script-name — ignore SCRIPT_NAME entirely 🙈
--catch-exceptions — report the exception as http output. > discouraged — use only for testing, okay? it's giving debugging-only 🔬
--reload-on-exception — reload a worker whenever an exception is raised 🔄
--reload-on-exception-type — reload a worker when a specific exception type gets raised 🎯
--reload-on-exception-value — reload a worker when a specific exception value gets raised 🎯
--reload-on-exception-repr — reload a worker when a specific exception type+value (language-specific, iykyk) gets raised 🎯
--exception-handler — add an exception handler 🫶
--enable-metrics — turn on the metrics subsystem 📊
--metric — add a custom metric 💖
--metric-threshold — add a metric threshold/alarm 🚨
--metric-alarm — add a metric threshold/alarm (same thing, different name, we love options) 🚨
--alarm-metric — add a metric threshold/alarm (third alias, iconic behavior) 🚨
--metrics-dir — export metrics as text files into the directory you name 📁
--metrics-dir-restore — restore the last value taken from the metrics dir ♻️
--metric-dir — export metrics as text files to the specified directory (yes, the singular twin) 📁
--metric-dir-restore — restore last value taken from the metrics dir ♻️
--metrics-no-cores — disable generation of cores-related metrics 🚫
--udp — run the udp server on the address you specify 📡
--stats — enable the stats server on the specified address 📈
--stats-server — enable the stats server on the specified address (same energy, different spelling) 📈
--stats-http — prefix the stats server json output with http headers 🌐
--stats-minified — minify the statistics json output 🗜️
--stats-min — minify statistics json output (the short queen) 🗜️
--stats-push — push the stats json to the destination you specify 🚀
--stats-pusher-default-freq — set the default frequency of stats pushers ⏱️
--stats-pushers-default-freq — set the default frequency of stats pushers (plural bestie, same deal) ⏱️
--stats-no-cores — disable generation of cores-related stats 🚫
--stats-no-metrics — do not include metrics in the stats output 🙅
--multicast — subscribe to the multicast group you specify 📻
--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, but the shortcut way (shortcut for multicast) ⚡
--legion-node — add a node to a legion 🧩
--legion-freq — set the frequency of legion packets 📶
--legion-tolerance — set the tolerance of the legion subsystem 🕊️
--legion-death-on-lord-error — declare itself as a dead node for the amount of seconds you specify if one of the lord hooks fails 💀
--legion-skew-tolerance — set the clock skew tolerance of the 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 (that's the shutdown of the instance, dramatic but accurate) ⚰️
--legion-join — action to call on legion join (first time quorum is reached) 🤝
--legion-node-joined — action to call on a new node joining the legion 🎉
--legion-node-left — action to call on a node leaving the 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 the legion scroll buffer 📦
--legion-scroll-list-max-size — set max size of the legion scroll list buffer 📦
--subscriptions-sign-check — set the digest algorithm and certificate directory for the secured subscription system 🔐
--subscriptions-sign-check-tolerance — set the maximum tolerance (in seconds) of clock skew for the secured subscription system ⏲️
--subscriptions-sign-skip-uid — skip signature check for the uid you specify when using unix sockets credentials 🪪
--subscriptions-credentials-check — add a directory to search for subscriptions key credentials 🔎
--subscriptions-use-credentials — enable management of SCM_CREDENTIALS in subscriptions UNIX sockets 🔑
--subscription-algo — set the load balancing algorithm for the subscription system ⚖️
--subscription-dotsplit — try to fallback to the next part (dot based) in the subscription key 🎯
--subscribe-to — subscribe to the subscription server you specify 📨
--st — subscribe to the specified subscription server (the shortest icon in the set, love that for her) 📨
--subscribe — subscribe to the specified subscription server 📨
--subscribe2 — subscribe to the specified subscription server, but with the advanced keyval syntax ✨
--subscribe-freq — send subscription announce at the interval you specify 🕐
--subscription-tolerance — set tolerance for subscription servers 🧘
--unsubscribe-on-graceful-reload — force the unsubscribe request even during a graceful reload 💥
--start-unsubscribed — configure subscriptions but don't actually send them (useful with master fifo) 🤫
--subscribe-with-modifier1 — force the specififed modifier1 when subscribing (yes, that's exactly how the original spells it, and yes, we're keeping it character for character 😭)
--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 directory you specify and create a sni/ssl context on demand 🗂️
--sni-dir-ciphers — set ssl ciphers for the sni-dir option 🔐
--ssl-enable3 — enable SSLv3. > insecure, bestie, we said it 🚨
--ssl-enable-sslv3 — enable SSLv3. > again: insecure 🚨
--ssl-enable-tlsv1 — enable TLSv1. > and again: 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 directory you specify 🗄️
--check-interval — set the interval (in seconds) of master checks ⏱️
--forkbomb-delay — sleep for the number of seconds you specify 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 the number of cores you specify ⚡
--max-fd — set maximum number of file descriptors. > requires root privileges 👑
--logto — set logfile/udp address 📝
--logto2 — log to the file or udp address you specify after privileges drop 📝
--log-format — set advanced format for request logging 🎨
--logformat — set advanced format for request logging (the no-dash twin) 🎨
--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 socket you specify 🔌
--req-logger — set/append a request logger 🪵
--logger-req — set/append a request logger (alias bestie) 🪵
--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 (meaning: do not show) log lines matching the regexp you specify 🚰
--log-filter — show only log lines matching the regexp you specify 🔍
--log-route — log to the named logger you specify if the regexp applied on the logline matches 🛣️
--log-req-route — log requests to the named logger you specify if the regexp applied on the logline matches 🛣️
--use-abort — call abort() on segfault/fpe, which could be useful for generating a core dump 🧨
--alarm — create a new alarm, syntax: <alarm> <plugin:args> ⏰
--alarm-cheap — use the main alarm thread rather than creating dedicated threads for curl-based alarms 💸
--alarm-freq — tune the anti-loop alarm system (default 3 seconds) 🔁
--alarm-fd — raise the alarm you specify when an fd is read for read (by default it reads 1 byte, set 8 for eventfd) 🚨
--alarm-segfault — raise the alarm you specify when the segmentation fault handler is executed 💥
--segfault-alarm — bestie, when the segfault handler kicks in, raise the alarm you picked. it's giving "tell me when it all goes wrong" 💀
--alarm-backlog — raise the specified alarm when the socket backlog queue is full 🔥
--backlog-alarm — raise the specified alarm when the socket backlog queue is full (same vibe, different name, both valid) ✨
--lq-alarm — raise the specified alarm when the socket backlog queue is full 🫶
--alarm-lq — raise the specified alarm when the socket backlog queue is full 💅
--alarm-listen-queue — raise the specified alarm when the socket backlog queue is full 🌸
--listen-queue-alarm — raise the specified alarm when the socket backlog queue is full, no cap 🎀
--log-alarm — raise the specified alarm when a log line matches the regexp you gave. syntax is exactly this, don't freestyle it: <alarm>[,alarm...] <regexp> 💖
--alarm-log — raise the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp> — yes it's the same as above, they're twins 👑
--not-log-alarm — the opposite energy: skip the specified alarm when a log line matches that 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 thing, different spelling 💜
--alarm-list — list out all the enabled alarms, like a little roll call 📋
--alarms-list — list enabled alarms (plural girlies, same result) ✨
--alarm-msg-size — set the max size of an alarm message. default is 8192, fyi 📏
--log-master — delegate logging to the master process. let the main character handle it 👑
--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 start, clean slate 🧼
--log-maxsize — set the maximum logfile size 📦
--log-backupname — set the logfile name to use after rotation 🔁
--logdate — prefix your logs with a date, or a strftime string 🗓️
--log-date — prefix logs with date or a strftime string (same deal, dash edition) 💫
--log-prefix — prefix logs with a string of your choosing 🏷️
--log-zero — log responses that have no body 👻
--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 requestes bigger than the specified size (typo is theirs, keeping it, character for character bestie 😭) 📐
--log-sendfile — log sendfile requests 📤
--log-ioerror — log requests that hit io errors ⚠️
--log-micros — report response time in microseconds instead of milliseconds. so precise ⏱️
--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 😳 (yes, root. be careful.)
--drop-after-init — run the privileges drop after plugin initialization. note: superseded by drop-after-apps ⬇️
--drop-after-apps — run the privileges drop after apps loading. note: superseded by master-as-root ⬇️
--force-cwd — force the initial working directory to whatever value you hand it 📁
--binsh — override /bin/sh (it's used by exec hooks, and it always fallback 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 workers instead of master) 🦥
--lazy-apps — load apps in each worker instead of the master 🦥
--cheap — set cheap mode (spawn workers only after the first request) 💸
--cheaper — set cheaper mode (adaptive process spawning) 💰
--cheaper-initial — set the initial number of processes to spawn in cheaper mode 🔢
--cheaper-algo — choose the algorithm used for adaptive process spawning 🧠
--cheaper-step — 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 (yes, again, they're aliases) 📜
--cheaper-list — list enabled cheapers algorithms 📜
--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 🛑
--idle — set idle mode (put uWSGI in cheap mode after inactivity) 😴
--die-on-idle — shutdown uWSGI when it's idle 💀
--mount — load an application under a mountpoint 📌
--worker-mount — load application under mountpoint in the specified worker, or after workers spawn 📌
--threads — run each worker in prethreaded mode with the number of threads you specify 🧵
--thread-stacksize — set threads stacksize 📚
--threads-stacksize — set threads stacksize 📚
--thread-stack-size — set threads stacksize 📚
--threads-stack-size — set threads stacksize 📚 (four ways to say the same thing, iconic honestly)
--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, but the 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 📋 (plural twin, same energy)
--error-page-403 — add an error page (html) for managed 403 response 🚫
--error-page-404 — add an error page (html) for managed 404 response 🔍
--error-page-500 — add an error page (html) for managed 500 response 💥
--websockets-ping-freq — set the frequency (in seconds) of websockets automatic ping packets 🏓
--websocket-ping-freq — set the frequency (in seconds) of websockets automatic ping packets 🏓
--websockets-pong-tolerance — set the tolerance (in seconds) of the websockets ping/pong subsystem 🏓
--websocket-pong-tolerance — set the tolerance (in seconds) of the websockets ping/pong subsystem 🏓
--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) 📦
--chunked-input-limit — set the max size of a chunked input part (default 1MB, in bytes) 🧩
--chunked-input-timeout — set the default timeout for chunked input ⏳
--clock — set a clock source ⏰
--clock-list — list enabled clocks 🕰️
--clocks-list — list enabled clocks 🕰️
--add-header — automatically add HTTP headers to the response ➕
--rem-header — automatically remove the specified HTTP header from the response ➖
--del-header — automatically remove specified HTTP header from the response ➖
--collect-header — store the specified response header in a request var. syntax: header var 📥
--response-header-collect — store the specified response header in a request var (syntax: header var) 💖
--pull-header — store the specified response header in a request var and remove it from the response (syntax: header var) ✨
--check-static — check for static files in the specified directory 🎀
--check-static-docroot — check for static files in the requested DOCUMENT_ROOT 🦋
--static-check — check for static files in the specified directory 🌸
--static-map — map mountpoint to static directory (or file) 💅
--static-map2 — like static-map but completely appending the requested resource to the docroot 🔥
--static-skip-ext — skip specified extension from staticfile checks 👑
--static-index — search for specified file if a directory is requested 🌈
--static-safe — skip security checks if the file is under the specified path ⭐
--static-cache-paths — put resolved paths in the uWSGI cache for the specified amount of seconds 💀
--static-cache-paths-name — use the specified cache for static paths 🙈
--mimefile — set mime types file path (default /etc/mime.types) 🍓
--mime-file — set mime types file path (default /etc/mime.types) 🧚
--static-expires-type — set the Expires header based on content type 💜
--static-expires-type-mtime — set the Expires header based on content type and file mtime ✨
--static-expires — set the Expires header based on filename regexp 🎀
--static-expires-mtime — set the Expires header based on filename regexp and file mtime 🦋
--static-expires-uri — set the Expires header based on REQUEST_URI regexp 🌸
--static-expires-uri-mtime — set the Expires header based on REQUEST_URI regexp and file mtime 💅
--static-expires-path-info — set the Expires header based on PATH_INFO regexp 🔥
--static-expires-path-info-mtime — set the Expires header based on PATH_INFO regexp and file mtime 👑
--static-gzip — if the supplied regexp matches the static file translation it will search for a gzip version 🌈
--static-gzip-all — check for a gzip version of all requested static files ⭐
--static-gzip-dir — check for a gzip version of all requested static files in the specified dir/prefix 💀
--static-gzip-prefix — check for a gzip version of all requested static files in the specified dir/prefix 🙈
--static-gzip-ext — check for a gzip version of all requested static files with the specified ext/suffix 🍓
--static-gzip-suffix — check for a gzip version of all requested static files with the specified ext/suffix 🧚
--honour-range — enable support for the HTTP Range header 💜
--offload-threads — set the number of offload threads to spawn (per-worker, default 0) ✨
--offload-thread — set the number of offload threads to spawn (per-worker, default 0) 🎀
--file-serve-mode — set static file serving mode 🦋
--fileserve-mode — set static file serving mode 🌸
--disable-sendfile — disable sendfile() and rely on boring read()/write() 💅
--check-cache — check for response data in the specified cache (empty for default cache) 🔥
--close-on-exec — set close-on-exec on connection sockets (could be required for spawning processes in requests) 👑
--close-on-exec2 — set close-on-exec on server sockets (could be required for spawning processes in requests) 🌈
--mode — set uWSGI custom mode ⭐
--env — set environment variable 💀
--envdir — load a daemontools compatible envdir 🙈
--early-envdir — load a daemontools compatible envdir ASAP 🍓
--unenv — unset environment variable 🧚
--vacuum — try to remove all of the generated file/sockets 💜
--file-write — write the specified content to the specified file (syntax: file=value) before privileges drop ✨
--cgroup — put the processes in the specified cgroup 🎀
--cgroup-opt — set value in specified cgroup option 🦋
--cgroup-dir-mode — set permission for cgroup directory (default is 700) 🌸
--namespace — run in a new namespace under the specified rootfs 💅
--namespace-keep-mount — keep the specified mountpoint in your namespace 🔥
--ns — run in a new namespace under the specified rootfs 👑
--namespace-net — add network namespace 🌈
--ns-net — add network namespace ⭐
--enable-proxy-protocol — enable PROXY1 protocol support (only for http parsers) 💀
--reuse-port — enable REUSE_PORT flag on socket (BSD only) 🙈
--tcp-fast-open — enable TCP_FASTOPEN flag on TCP sockets with the specified qlen value 🍓
--tcp-fastopen — enable TCP_FASTOPEN flag on TCP sockets with the specified qlen value 🧚
--tcp-fast-open-client — use sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported 💜
--tcp-fastopen-client — use sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported ✨
--zerg — attach to a zerg server 🎀
--zerg-fallback — fallback to normal sockets if the zerg server is not available 🦋
--zerg-server — enable the zerg server on the specified UNIX socket 🌸
--cron — add a cron task 💅
--cron2 — add a cron task (key=val syntax) 🔥
--unique-cron — add a unique cron task 👑
--cron-harakiri — set the maximum time (in seconds) we wait for cron command to complete 🌈
--legion-cron — add a cron task runnable only when the instance is a lord of the specified legion ⭐
--cron-legion — add a cron task runnable only when the instance is a lord of the specified legion 💀
--unique-legion-cron — add a unique cron task runnable only when the instance is a lord of the specified legion 🙈
--unique-cron-legion — add a unique cron task runnable only when the instance is a lord of the specified legion 🍓
--loop — select the uWSGI loop engine 🧚
--loop-list — list enabled loop engines 💜
--loops-list — list enabled loop engines ✨
--worker-exec — run the specified command as worker 🎀
--worker-exec2 — run the specified command as worker (after post_fork hook) 🦋
--attach-daemon — attach a command/daemon to the master process (the command has to not go in background) 🌸
--attach-control-daemon — attach a command/daemon to the master process (the command has to not go in background), when the daemon dies, the master dies too 💅
--smart-attach-daemon — attach a command/daemon to the master process managed by a pidfile (the command has to daemonize) 🔥
--smart-attach-daemon2 — attach a command/daemon to the master process managed by a pidfile (the command has to NOT daemonize) 👑
--legion-attach-daemon — same as --attach-daemon but daemon runs only on legion lord node 🌈
--legion-smart-attach-daemon — same as --smart-attach-daemon but daemon runs only on legion lord node ⭐
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2 but daemon runs only on 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 — 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 uWSGI plugin search path 🦋
--plugin-dir — add a directory to uWSGI plugin search path 🌸
--plugins-list — list enabled plugins 💅
--plugin-list — list enabled plugins 🔥
--autoload — try to automatically load plugins when unknown options are found 👑
--dlopen — blindly load a shared library 🌈
--allowed-modifiers — comma separated list of allowed modifiers ⭐
--remap-modifier — remap request modifier from one id to another 💀
--dump-options — dump the full list of available options 🙈
--show-config — show the current config reformatted as ini 🍓
--binary-append-data — return the content of a resource to stdout for appending to a uwsgi binary (for data:// usage) 🧚
--print — simple print 💜
--iprint — simple print (immediate version) ✨
--exit — force exit() of the instance 🎀
--cflags — report uWSGI CFLAGS (useful for building external plugins) 🦋
--dot-h — dump the uwsgi.h used for building the core (useful for building external plugins) 🌸
--config-py — dump the uwsgiconfig.py used for building the core (useful for building external plugins) 💅
--build-plugin — build a uWSGI plugin for the current binary 🔥
--version — print uWSGI version 👑
--response-headers-limit — set response header maximum size (default: 64k) 🌈
--lua — load lua wsapi app ⭐
--lua-load — load a lua file 💀
--lua-shell — run the lua interactive shell (debug.debug()) 🙈
--luashell — run the lua interactive shell (debug.debug()) 🍓
--lua-gc-freq — set the lua gc frequency (default: 0, runs after every request) 🧚

and that's the whole manual page, bestie! no skips, no missing flags, we ate 💅

This was uwsgi_lua52 version 2.0.21-debian, dated May 2023, from UWSGI_LUA52(1). Go forth and configure with main character energy 🫶💖✨

📦 where this page comes from

debian bookworm: uwsgi-plugin-lua5.2 2.0.21-5.1 · 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