UWSGI_RACK_RUBY31(1)

📦 version 2.0.21, in debian bookworm

💖 UWSGI_RACK_RUBY31 💖

okay bestie, so this is the manual page for uwsgi_rack_ruby31 — section 1 of the manual, User Commands, if you were wondering where to find it in the stack 🫶

✨ NAME ✨

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

no literally that's the whole name section and it's lowkey iconic?? "self-healing" and "developer-friendly" in the same breath, she contains multitudes 💅

✨ SYNOPSIS ✨

uwsgi-core-local [options...]

✨ DESCRIPTION ✨

okay so this is the big one, the main character section, and it's basically the entire option buffet. grab a snack, we're going through every single one 🌸

🎀 Sockets & Protocols

-s, --socket — bind to the specified UNIX/TCP socket using default protocol
-s, --uwsgi-socket — bind to the specified UNIX/TCP socket using uwsgi protocol
--suwsgi-socket — bind to the specified UNIX/TCP socket using uwsgi protocol over SSL
--ssl-socket — bind to the specified UNIX/TCP socket using uwsgi protocol over SSL
--http-socket — bind to the specified UNIX/TCP socket using HTTP protocol
--http-socket-modifier1 — force the specified modifier1 when using HTTP protocol
--http-socket-modifier2 — force the specified modifier2 when using HTTP protocol
--http11-socket — bind to the specified UNIX/TCP socket using HTTP 1.1 (Keep-Alive) protocol
--https-socket — bind to the specified UNIX/TCP socket using HTTPS protocol
--https-socket-modifier1 — force the specified modifier1 when using HTTPS protocol
--https-socket-modifier2 — force the specified modifier2 when using HTTPS protocol
--fastcgi-socket — bind to the specified UNIX/TCP socket using FastCGI protocol
--fastcgi-nph-socket — bind to the specified UNIX/TCP socket using FastCGI protocol (nph mode)
--fastcgi-modifier1 — force the specified modifier1 when using FastCGI protocol
--fastcgi-modifier2 — force the specified modifier2 when using FastCGI protocol
--scgi-socket — bind to the specified UNIX/TCP socket using SCGI protocol
--scgi-nph-socket — bind to the specified UNIX/TCP socket using SCGI protocol (nph mode)
--scgi-modifier1 — force the specified modifier1 when using SCGI protocol
--scgi-modifier2 — force the specified modifier2 when using SCGI protocol
--raw-socket — bind to the specified UNIX/TCP socket using RAW protocol
--raw-modifier1 — force the specified modifier1 when using RAW protocol
--raw-modifier2 — force the specified modifier2 when using RAW protocol
--puwsgi-socket — bind to the specified UNIX/TCP socket using persistent uwsgi protocol (puwsgi)
--protocol — force the specified protocol for default sockets
--socket-protocol — force the specified protocol for default sockets
--shared-socket — create a shared socket for advanced jailing or ipc
--undeferred-shared-socket — create a shared socket for advanced jailing or ipc (undeferred mode)

🧚 Workers, Processes & 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 harakiri timeout
--harakiri-verbose — enable 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 backtrace depth
--mule-harakiri — set harakiri timeout for mule tasks

💜 Config & Placeholders

-x, --xmlconfig — load config from xml file
-x, --xml — load config from xml file
--config — load configuration using the pluggable system
--fallback-config — re-exec uwsgi with the specified config when exit code is 1
--strict — enable strict mode (placeholder cannot be used)
--skip-zero — skip check of file descriptor 0
--skip-atexit — skip atexit hooks (ignored by the master)
--skip-atexit-teardown — skip atexit teardown (ignored by the master)
-S, --set — set a placeholder or an option
--set-placeholder — set a placeholder
--set-ph — set a placeholder
--get — print the specified option value and exit
--declare-option — declare a new uWSGI custom option
--declare-option2 — declare a new uWSGI custom option (non-immediate)
--resolve — place the result of a dns query in the specified placeholder, sytax: placeholder=name (immediate option)

yes bestie, the original really does say "sytax" and I am not fixing it, we respect the source material in this house 💀

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

🌈 Blacklist / Whitelist

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

🍓 Write Errors & Signals

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

👑 Daemonize & Instance Management

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

⭐ Tuning, Buffers & Sockets (again, but fancier)

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

💅 Threads & Process Names

-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

🔥 Interpreters, Master & stdin

-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 she gets her own whole subsection, she's that girl)

--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
--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 wrapped, bestie — but do NOT go anywhere, because more parts are coming and the options literally never stop 💖✨

✨ OPTIONS ✨

okay bestie, buckle up, this is the long part and it's giving very much "reference manual but make it fashion" 💅

👑 The Emperor & His Vassals 🫶

--early-emperor — spawn the emperor as soon as possible. no waiting around, she's eager ✨
--emperor-broodlord — run the emperor in BroodLord mode. yes that's the real name. iconic, no notes 👑
--emperor-throttle — set the throttling level (in milliseconds) for vassals that are being bad. default is 1000. time-out energy fr 😤
--emperor-max-throttle — set the max throttling level (in milliseconds) for misbehaving vassals. default is 3 minutes. that's the ceiling bestie, don't push it 🚫
--emperor-magic-exec — prefix vassal config files with exec:// if they have the executable bit set. magic, literally ✨
--emperor-on-demand-extension — search for a text file (vassal name + extension) that contains the on demand socket name 🔍
--emperor-on-demand-ext — same thing, shorter name. search for a 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 — the abbreviated twin: 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 the on demand socket name (the vassal name gets passed as the only argument) 🫡
--emperor-extra-extension — allows the specified extension in the Emperor (the vassal will be called with --config) 🎀
--emperor-extra-ext — same vibe, short spelling: allows the specified extension in the Emperor (vassal called with --config) 🎀
--emperor-no-blacklist — disable the Emperor blacklisting subsystem. everybody's forgiven, we're healing 🌈
--emperor-use-clone — use clone() instead of fork(), passing the specified unshare() flags 👯
--emperor-graceful-shutdown — use vassals' graceful shutdown during ragnarok. yes, ragnarok. we said what we said 💀
--emperor-cap — set vassals capability 🧢
--vassals-cap — set vassals capability 🧢
--vassal-cap — set vassals capability 🧢 (three names, one job, we love a flexible queen)
--imperial-monitor-list — list enabled imperial monitors 📋
--imperial-monitors-list — list enabled imperial monitors 📋 (plural bestie, both work)
--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 the vassal's death 🪦
--vassal-sos — ask the emperor for reinforcement when overloaded 🆘
--vassal-sos-backlog — ask the emperor for SOS if the 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 🎛️ (same deal, shorter name)
--heartbeat — announce healthiness to the emperor 💓

🔄 Reloads, Shutdowns & General Drama 😭

--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. she said no more 🚪
--die-on-term — exit instead of doing a brutal reload on SIGTERM 💀
--force-gateway — force the spawn of the first registered gateway without a master 🚪✨

🛠️ Help & Debug Vibes 🫶

-h, --help — show this help 💖
-h, --usage — show this help 💖 (same thing, different alias, slay)
--print-sym — print the content of the specified binary symbol 🔍
--print-symbol — print the 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 a 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, Shared Memory & FDs 🔑

--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 the specified pages. heads up bestie: it supports keyval too 🧠
--safe-fd — do not close the specified file descriptor 🛟
--fd-safe — do not close the specified file descriptor 🛟

💾 Cache & Queues 🍓

--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 is 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 the 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 🔄

🌀 Spoolers, Mules & Farms 🐴

-Q, --spooler — run a spooler on the specified directory 🗂️
--spooler-external — map spooler requests to a spooler directory managed by an external instance 🌐
--spooler-ordered — try to order the execution of spooler tasks 🔢
--spooler-chdir — chdir() to the 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 📨

📣 Signals, Timers & RPC ⏲️

--signal — send a uWSGI signal to a server 📡
--signal-bufsize — set buffer size for the signal queue 📦
--signals-bufsize — set buffer size for the 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 📞

📝 Logging, Files & Root Stuff 🏠

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

🔐 Privileges, Namespaces & Jails 👑

--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 (forces the execution of post_jail hooks) ⛓️
--refork — fork() again after privileges drop. useful for jailing systems 🍴
--re-fork — fork() again after privileges drop. useful for jailing systems 🍴
--refork-as-root — fork() again before privileges drop. useful for jailing systems 🍴
--re-fork-as-root — fork() again before privileges drop. useful for jailing systems 🍴
--refork-post-jail — fork() again after jailing. genuinely useful for jailing systems 🫶
--re-fork-post-jail — same energy as above: fork() again after jailing, and yeah, it's useful for jailing systems. (it's giving "same thing, different spelling" 💅)
--hook-asap — run the hook you specified, like, immediately. as soon as possible, no waiting around ✨
--hook-pre-jail — run that specified hook before jailing 🎀
--hook-post-jail — run that 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, bestie 🥲
--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 it's the same description, no I'm not kidding) 💅

okay now we're in the exec era of this list, and it's a whole parallel universe of the hooks you just met:

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

and now mount things. same vibes, filesystem edition:

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

now the waiting era. bestie, this section is literally just "chill, we're waiting for stuff to exist before we run root hooks":

--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 (yes, same thing again) 🌐
--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 ⏳

and then call. the call crew, which comes with a lil function-signature glow-up for the vassal and emperor ones 💅:

--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 time, and bestie watch out because some of these share the same short flag — I'm just telling you what the page says, fr fr:

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

touchy-feely reload territory (in the literal "a file got touched" sense, not the emotional sense 🙈):

--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) 📡
--check-mountpoint, --mountpoint-check, --check-mount, --mount-check — destroys the instance if a filesystem is no longer reachable (super useful for reliable Fuse management) 💀
--propagate-touch — over-engineering option for systems with flaky signal management 🙈
--limit-post — limits request body 🫶
--no-orphans — automatically kills workers if master dies (can be dangerous for availability) 😬
--prio — sets processes/threads priority 💅
--cpu-affinity — sets cpu affinity 🧚
--post-buffering — sets the size in bytes after which it will buffer to disk instead of memory 📦
--post-buffering-bufsize — sets buffer size for read() in post buffering mode 📖
--body-read-warning — sets the amount of allowed memory allocation (in megabytes) for request body before starting printing a warning ⚠️
--upload-progress — enables creation of .json files in the specified directory during a file upload 📁
--no-default-app — does not fallback to default app 🚫
--manage-script-name — automatically rewrites SCRIPT_NAME and PATH_INFO ✨
--ignore-script-name — ignores SCRIPT_NAME 🙅‍♀️
--catch-exceptions — reports exception as http output (discouraged, use only for testing) 😭
--reload-on-exception — reloads a worker when an exception is raised 🔄
--reload-on-exception-type — reloads a worker when a specific exception type is raised 🔁
--reload-on-exception-value — reloads a worker when a specific exception value is raised 🔂
--reload-on-exception-repr — reloads a worker when a specific exception type+value (language-specific) is raised 🌀
--exception-handler — adds an exception handler 🛠️
--enable-metrics — enables metrics subsystem 📊
--metric — adds a custom metric 📈
--metric-threshold, --metric-alarm, --alarm-metric — adds a metric threshold/alarm 🚨
--metrics-dir, --metric-dir — exports metrics as text files to the specified directory 📂
--metrics-dir-restore, --metric-dir-restore — restores last value taken from the metrics dir ♻️
--metrics-no-cores — disables generation of cores-related metrics 🚫
--udp — runs the udp server on the specified address 📡
--stats, --stats-server — enables the stats server on the specified address 📊
--stats-http — prefixes stats server json output with http headers 🌐
--stats-minified, --stats-min — minifies statistics json output ✨
--stats-push — pushes the stats json to the specified destination 📤
--stats-pusher-default-freq, --stats-pushers-default-freq — sets the default frequency of stats pushers ⏱️
--stats-no-cores — disables generation of cores-related stats 🚫
--stats-no-metrics — does not include metrics in stats output 🙈
--multicast — subscribes to specified multicast group 📡
--multicast-ttl — sets multicast ttl ⏳
--multicast-loop — sets multicast loop (default 1) 🔁
--master-fifo — enables the master fifo 🎀
--notify-socket — enables the notification socket 🔔
--subscription-notify-socket — sets the notification socket for subscriptions 📬
--legion — becomes a member of a legion 👑
--legion-mcast — becomes a member of a legion (shortcut for multicast) 🛰️
--legion-node — adds a node to a legion ➕
--legion-freq — sets the frequency of legion packets 📶
--legion-tolerance — sets the tolerance of legion subsystem 🫂
--legion-death-on-lord-error — declares itself as a dead node for the specified amount of seconds if one of the lord hooks fails 💀
--legion-skew-tolerance — sets 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 when a node leaves legion 🚪
--legion-quorum — sets the quorum of a legion 🗳️
--legion-scroll — sets the scroll of a legion 📜
--legion-scroll-max-size — sets max size of legion scroll buffer 📏
--legion-scroll-list-max-size — sets max size of legion scroll list buffer 📐
--subscriptions-sign-check — sets digest algorithm and certificate directory for secured subscription system 🔐
--subscriptions-sign-check-tolerance — sets the maximum tolerance (in seconds) of clock skew for secured subscription system ⏱️
--subscriptions-sign-skip-uid — skips signature check for the specified uid when using unix sockets credentials 🆔
--subscriptions-credentials-check — adds a directory to search for subscriptions key credentials 🔑
--subscriptions-use-credentials — enables management of SCM_CREDENTIALS in subscriptions UNIX sockets 🪪
--subscription-algo — sets load balancing algorithm for the subscription system ⚖️
--subscription-dotsplit — tries to fallback to the next part (dot based) in subscription key 🔀
--subscribe-to, --st, --subscribe — subscribes to the specified subscription server 📡
--subscribe2 — subscribes to the specified subscription server using advanced keyval syntax ✨
--subscribe-freq — sends subscription announce at the specified interval ⏲️
--subscription-tolerance — sets tolerance for subscription servers 🫂
--unsubscribe-on-graceful-reload — forces unsubscribe request even during graceful reload 🔄
--start-unsubscribed — configures subscriptions but does not send them (useful with master fifo) 🤫
--subscribe-with-modifier1 — forces the specified modifier1 when subscribing 1️⃣
--snmp — enables the embedded snmp server 🌐
--snmp-community — sets the snmp community string 🔤
--ssl-verbose — be verbose about SSL errors 🗣️
--ssl-verify-depth — sets maximum certificate verification depth 📜
--sni — adds an SNI-governed SSL context 🔒
--sni-dir — checks for cert/key/client_ca file in the specified directory and creates a sni/ssl context on demand 📁
--sni-dir-ciphers — sets ssl ciphers for sni-dir option 🔐
--ssl-enable3, --ssl-enable-sslv3 — enables SSLv3 (insecure) 😱
--ssl-enable-tlsv1 — enables TLSv1 (insecure) 😱
--ssl-option — sets a raw ssl option (numeric value) 🔢
--sni-regexp — adds an SNI-governed SSL context (the key is a regexp) 🧩
--ssl-tmp-dir — stores ssl-related temp files in the specified directory 🗂️
--check-interval — sets the interval (in seconds) of master checks ⏱️
--forkbomb-delay — sleeps for the specified number of seconds when a forkbomb is detected 💣
--binary-path — forces binary path 📍
--privileged-binary-patch — patches the uwsgi binary with a new command (before privileges drop) 🩹
--unprivileged-binary-patch — patches the uwsgi binary with a new command (after privileges drop) 🩹
--privileged-binary-patch-arg — patches the uwsgi binary with a new command and arguments (before privileges drop) 🩹
--unprivileged-binary-patch-arg — patches the uwsgi binary with a new command and arguments (after privileges drop) 🩹
--async — enables async mode with specified cores ⚡
--max-fd — sets maximum number of file descriptors (requires root privileges) 🔢
--logto — sets logfile/udp address 📝
--logto2 — logs to specified file or udp address after privileges drop 📝
--log-format, --logformat — sets advanced format for request logging 🎨
--logformat-strftime, --log-format-strftime — applies strftime to logformat output 🕰️
--logfile-chown — chowns logfiles 👤
--logfile-chmod — chmods logfiles 🔧
--log-syslog — logs to syslog 📨
--log-socket — sends logs to the specified socket 🔌
--req-logger, --logger-req — sets/appends a request logger 🪵
--logger — sets/appends a logger 🪵
--logger-list, --loggers-list — lists enabled loggers 📋
--threaded-logger — offloads log writing to a thread 🧵
--log-encoder — adds an item in the log encoder chain 🔗
--log-req-encoder — adds an item in the log req encoder chain 🔗
--log-drain — drains (does not show) log lines matching the specified regexp 🚫
--log-filter — shows only log lines matching the specified regexp 🔍
--log-route — logs to the specified named logger if regexp applied on logline matches 🛣️
--log-req-route — logs requests to the specified named logger if regexp applied on logline matches 🛣️
--use-abort — calls abort() on segfault/fpe, could be useful for generating a core dump 💥
--alarm — creates a new alarm, syntax: <alarm> <plugin:args> 🚨
--alarm-cheap — uses main alarm thread rather than create dedicated threads for curl-based alarms 🧵
--alarm-freq — tunes the anti-loop alarm system (default 3 seconds) ⏲️
--alarm-fd — raises the specified alarm when an fd is read for read (by default it reads 1 byte, set 8 for eventfd) 📟
--alarm-segfault — raises the specified alarm when the segmentation fault handler is executed 💀
--segfault-alarm — when the segfault handler does its thing, raise the alarm you picked 💀 fr fr
--alarm-backlog — socket backlog queue is full? raise the specified alarm 🔔
--backlog-alarm — same vibe, same alarm, socket backlog queue full 👑
--lq-alarm — yep, raise the specified alarm when the socket backlog queue is full
--alarm-lq — it's giving "socket backlog queue full → raise that alarm" ✨
--alarm-listen-queue — raise the specified alarm when the socket backlog queue is full (bestie there are SO many spellings of this one, pick your fave)
--listen-queue-alarm — socket backlog queue full, raise the alarm, that's the whole job
--log-alarm — when a log line matches the regexp you gave, raise the specified alarm. syntax: <alarm>[,alarm...] <regexp> 🎀
--alarm-log — same energy: log line matches the regexp → raise the specified alarm. syntax: <alarm>[,alarm...] <regexp>
--not-log-alarm — skip the specified alarm when a log line matches the regexp. syntax: <alarm>[,alarm...] <regexp> 🙈
--not-alarm-log — skip that alarm when the log line matches. syntax: <alarm>[,alarm...] <regexp>
--alarm-list — show me all the enabled alarms 👀
--alarms-list — list enabled alarms (plural slay)
--alarm-msg-size — set the max size of an alarm message (default 8192) 📏
--log-master — delegate logging to the master process, hand it off 💅
--log-master-bufsize — set the buffer size for the master logger. heads up: 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 reload 🔄
--log-truncate — truncate the log on startup, fresh start energy
--log-maxsize — set the maximum logfile size
--log-backupname — set the logfile name to use after rotation
--logdate — prefix logs with a date or a strftime string 📅
--log-date — prefix logs with date or a strftime string (same, cuter hyphen)
--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 requests bigger than the specified size
--log-sendfile — log sendfile requests
--log-ioerror — log requests with io errors 😭
--log-micros — report response time in microseconds instead of milliseconds ⏱️
--log-x-forwarded-for — use the ip from the X-Forwarded-For header instead of REMOTE_ADDR
--master-as-root — leave the master process running as root 👑
--drop-after-init — run privileges drop after plugin initialization, and heads up: superseded by drop-after-apps
--drop-after-apps — run privileges drop after apps loading, and fyi: superseded by master-as-root
--force-cwd — force the initial working directory to the value you specify
--binsh — override /bin/sh (it's used by exec hooks, and it always falls back to /bin/sh)
--chdir — chdir to the specified directory before apps loading
--chdir2 — chdir to the specified directory after apps loading
--lazy — set lazy mode (load apps in 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
--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 idle 💀
--mount — load application under a mountpoint
--worker-mount — load application under a mountpoint in the specified worker, or after workers spawn
--threads — run each worker in prethreaded mode with the 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
--vhost — enable virtualhosting mode (based on the SERVER_NAME variable)
--vhost-host — enable virtualhosting mode (based on the HTTP_HOST variable)
--route — add a route 🛣️
--route-host — add a route based on the Host header
--route-uri — add a route based on REQUEST_URI
--route-qs — add a route based on QUERY_STRING
--route-remote-addr — add a route based on REMOTE_ADDR
--route-user-agent — add a route based on HTTP_USER_AGENT
--route-remote-user — add a route based on REMOTE_USER
--route-referer — add a route based on HTTP_REFERER
--route-label — add a routing label (for use with goto) 🏷️
--route-if — add a route based on a condition
--route-if-not — add a route based on a condition (negate version) 🙃
--route-run — always run the specified route action
--final-route — add a final route
--final-route-status — add a final route for the specified status
--final-route-host — add a final route based on the Host header
--final-route-uri — add a final route based on REQUEST_URI
--final-route-qs — add a final route based on QUERY_STRING
--final-route-remote-addr — add a final route based on REMOTE_ADDR
--final-route-user-agent — add a final route based on HTTP_USER_AGENT
--final-route-remote-user — add a final route based on REMOTE_USER
--final-route-referer — add a final route based on HTTP_REFERER
--final-route-label — add a final routing label (for use with goto)
--final-route-if — add a final route based on a condition
--final-route-if-not — add a final route based on a condition (negate version)
--final-route-run — always run the specified final route action
--error-route — add an error route 💀
--error-route-status — add an error route for the specified status
--error-route-host — add an error route based on the Host header
--error-route-uri — add an error route based on REQUEST_URI
--error-route-qs — add an error route based on QUERY_STRING
--error-route-remote-addr — add an error route based on REMOTE_ADDR
--error-route-user-agent — add an error route based on HTTP_USER_AGENT
--error-route-remote-user — add an error route based on REMOTE_USER
--error-route-referer — add an error route based on HTTP_REFERER
--error-route-label — add an error routing label (for use with goto)
--error-route-if — add an error route based on a condition
--error-route-if-not — add an error route based on a condition (negate version)
--error-route-run — always run the specified error route action
--response-route — add a response route
--response-route-status — add a response route for the specified status
--response-route-host — add a response route based on the Host header
--response-route-uri — add a response route based on REQUEST_URI
--response-route-qs — add a response route based on QUERY_STRING
--response-route-remote-addr — add a response route based on REMOTE_ADDR
--response-route-user-agent — add a response route based on HTTP_USER_AGENT
--response-route-remote-user — add a response route based on REMOTE_USER
--response-route-referer — add a response route based on HTTP_REFERER
--response-route-label — add a response routing label (for use with goto)
--response-route-if — add a response route based on a condition
--response-route-if-not — add a response route based on a condition (negate version)
--response-route-run — always run the specified response route action
--router-list — list enabled routers 📋
--routers-list — list enabled routers
--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 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 the specified HTTP header from the response
--collect-header — store the specified response header in a request var (syntax: header var)
--response-header-collect — grab that response header and stash it in a request var, no cap (syntax: header var) 💖
--pull-header — stash that response header in a request var AND yeet it out of the response (syntax: header var) 🫶
--check-static — peek for static files inside the directory you name 👀
--check-static-docroot — peek for static files in the requested DOCUMENT_ROOT
--static-check — same energy as --check-static: check for static files in the specified directory
--static-map — map a mountpoint to a static directory (or a file) 🗺️
--static-map2 — like --static-map, but it completely appends the requested resource to the docroot
--static-skip-ext — skip the extension you name from staticfile checks
--static-index — if a directory is requested, search for the file you specify
--static-safe — skip security checks when the file is under the path you name
--static-cache-paths — put resolved paths in the uWSGI cache for the number of seconds you specify
--static-cache-paths-name — use the cache you name 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 a filename regexp
--static-expires-mtime — set the Expires header based on a filename regexp and file mtime
--static-expires-uri — set the Expires header based on a REQUEST_URI regexp
--static-expires-uri-mtime — set the Expires header based on a REQUEST_URI regexp and file mtime
--static-expires-path-info — set the Expires header based on a PATH_INFO regexp
--static-expires-path-info-mtime — set the Expires header based on a PATH_INFO regexp and file mtime
--static-gzip — if the regexp you supply 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() instead 💀
--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)

and that's the whole vibe check, bestie 💅 this page was uwsgi_rack_ruby31 2.0.21-debian, dated May 2023, and it's the UWSGI_RACK_RUBY31(1) manual — periodt ✨

📦 where this page comes from

debian bookworm: uwsgi-plugin-rack-ruby3.1 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