UWSGI_RACK_RUBY32(1)

📦 version 2.0.24, in ubuntu noble

💖 NAME 💖

uwsgi_rack_ruby32 — fast (pure C), self-healing, developer-friendly WSGI server. Bestie, this is the UWSGI_RACK_RUBY32(1) manual, User Commands, part 1, and we are about to get you fluent in every single flag. No cap. 💅

✨ SYNOPSIS ✨

Run it like this, periodt:

uwsgi-core-local [options...]

🌸 DESCRIPTION 🌸

Okay so DESCRIPTION is literally the whole option buffet. Every flag, every vibe, every little config knob. We're doing them in order, bestie, so grab a strawberry drink 🍓 and let's go.

-s, --socket — bind to the specified UNIX/TCP socket using the default protocol. classic move ✨
-s, --uwsgi-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol. uwsgi gang 💜
--suwsgi-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol over SSL. secure-ish 🦋
--ssl-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol over SSL. twin flame 💖
--http-socket — bind to the specified UNIX/TCP socket using HTTP protocol. hello browser 🌈
--http-socket-modifier1 — force the specified modifier1 when using HTTP protocol. force it 💅
--http-socket-modifier2 — force the specified modifier2 when using HTTP protocol. modifier2, slay ✨
--http11-socket — bind to the specified UNIX/TCP socket using HTTP 1.1 (Keep-Alive) protocol. keep it alive 🔥
--https-socket — bind to the specified UNIX/TCP socket using HTTPS protocol. padlock energy 👑
--https-socket-modifier1 — force the specified modifier1 when using HTTPS protocol. modifier magic 💜
--https-socket-modifier2 — force the specified modifier2 when using HTTPS protocol. modifier2 moment 🧚
--fastcgi-socket — bind to the specified UNIX/TCP socket using FastCGI protocol. FastCGI bestie 🍓
--fastcgi-nph-socket — bind to the specified UNIX/TCP socket using FastCGI protocol (nph mode). nph mode activated ✨
--fastcgi-modifier1 — force the specified modifier1 when using FastCGI protocol. force field 💅
--fastcgi-modifier2 — force the specified modifier2 when using FastCGI protocol. modifier2, no cap ⭐
--scgi-socket — bind to the specified UNIX/TCP socket using SCGI protocol. SCGI szn 🌸
--scgi-nph-socket — bind to the specified UNIX/TCP socket using SCGI protocol (nph mode). nph again ✨
--scgi-modifier1 — force the specified modifier1 when using SCGI protocol. modifier1, periodt 💅
--scgi-modifier2 — force the specified modifier2 when using SCGI protocol. modifier2 energy 🔥
--raw-socket — bind to the specified UNIX/TCP socket using RAW protocol. raw and unbothered 😭
--raw-modifier1 — force the specified modifier1 when using RAW protocol. raw modifier1 🧚
--raw-modifier2 — force the specified modifier2 when using RAW protocol. raw modifier2 💜
--puwsgi-socket — bind to the specified UNIX/TCP socket using persistent uwsgi protocol (puwsgi). persistent queen 👑
--protocol — force the specified protocol for default sockets. protocol override ⭐
--socket-protocol — force the specified protocol for default sockets. same vibe, different flag 🍓
--shared-socket — create a shared socket for advanced jailing or ipc. sharing is caring 🫶
--undeferred-shared-socket — create a shared socket for advanced jailing or ipc (undeferred mode). undeferred mode ✨
-p, --processes — spawn the specified number of workers/processes. more workers, more slay 💅
-p, --workers — spawn the specified number of workers/processes. twin flag 💖
--thunder-lock — serialize accept() usage (if possible). thunder lock, so dramatic 🔥
-t, --harakiri — set harakiri timeout. harakiri timeout 💀
--harakiri-verbose — enable verbose mode for harakiri. verbose harakiri 😭
--harakiri-graceful-timeout — interval between graceful harakiri attempt and a sigkill. graceful then sigkill ⭐
--harakiri-graceful-signal — use this signal instead of sigterm for graceful harakiri attempts. signal swap ✨
--harakiri-queue-threshold — only trigger harakiri if queue is greater than this threshold. threshold trigger 🍓
--harakiri-no-arh — do not enable harakiri during after-request-hook. no arh harakiri 🙈
--no-harakiri-arh — do not enable harakiri during after-request-hook. same thing, another alias 💜
--no-harakiri-after-req-hook — do not enable harakiri during after-request-hook. after-req-hook no harakiri 💅
--backtrace-depth — set backtrace depth. deep backtrace 🔥
--mule-harakiri — set harakiri timeout for mule tasks. mule harakiri 🧚
-x, --xmlconfig — load config from xml file. xml config ✨
-x, --xml — load config from xml file. xml alias 💜
--config — load configuration using the pluggable system. pluggable config 🎀
--fallback-config — re-exec uwsgi with the specified config when exit code is 1. fallback plan 👑
--strict — enable strict mode (placeholder cannot be used). strict mode, no placeholders ⭐
--skip-zero — skip check of file descriptor 0. skip fd 0 🦋
--skip-atexit — skip atexit hooks (ignored by the master). atexit skip 🙈
--skip-atexit-teardown — skip atexit teardown (ignored by the master). teardown skip 💅
-S, --set — set a placeholder or an option. set it 💖
--set-placeholder — set a placeholder. placeholder vibes ✨
--set-ph — set a placeholder. ph alias 💜
--get — print the specified option value and exit. print and dip 👑
--declare-option — declare a new uWSGI custom option. custom option, declare it 🎀
--declare-option2 — declare a new uWSGI custom option (non-immediate). non-immediate custom ⭐
--resolve — place the result of a dns query in the specified placeholder, sytax: placeholder=name (immediate option). dns resolve, yes the typo is real 🍓
--for — (opt logic) for cycle. opt logic for loop 🧚
--for-glob — (opt logic) for cycle (expand glob). glob expand 🌈
--for-times — (opt logic) for cycle (expand the specified num to a list starting from 1). times loop 💅
--for-readline — (opt logic) for cycle (expand the specified file to a list of lines). readline loop 💖
--endfor — (opt logic) end for cycle. end for ✨
--end-for — (opt logic) end for cycle. end for alias 💜
--if-opt — (opt logic) check for option. if opt ⭐
--if-not-opt — (opt logic) check for option. if not opt 🙈
--if-env — (opt logic) check for environment variable. if env 🌸
--if-not-env — (opt logic) check for environment variable. if not env 🍓
--ifenv — (opt logic) check for environment variable. ifenv alias 🧚
--if-reload — (opt logic) check for reload. if reload 🔥
--if-not-reload — (opt logic) check for reload. if not reload 💅
--if-hostname — (opt logic) check for hostname. if hostname 💖
--if-not-hostname — (opt logic) check for hostname. if not hostname ✨
--if-hostname-match — (opt logic) try to match hostname against a regular expression. regex hostname 💜
--if-not-hostname-match — (opt logic) try to match hostname against a regular expression. regex hostname, but not ⭐
--if-exists — (opt logic) check for file/directory existence. if exists 👑
--if-not-exists — (opt logic) check for file/directory existence. if not exists 🙈
--ifexists — (opt logic) check for file/directory existence. ifexists alias 🍓
--if-plugin — (opt logic) check for plugin. if plugin 🧚
--if-not-plugin — (opt logic) check for plugin. if not plugin 💅
--ifplugin — (opt logic) check for plugin. ifplugin alias 💖
--if-file — (opt logic) check for file existance. if file ✨
--if-not-file — (opt logic) check for file existance. if not file 💜
--if-dir — (opt logic) check for directory existance. if dir ⭐
--if-not-dir — (opt logic) check for directory existance. if not dir 🌸
--ifdir — (opt logic) check for directory existance. ifdir alias 🦋
--if-directory — (opt logic) check for directory existance. if directory 🎀
--endif — (opt logic) end if. end if 💅
--end-if — (opt logic) end if. end if alias 💖
--blacklist — set options blacklist context. blacklist context 💀
--end-blacklist — clear options blacklist context. clear blacklist ✨
--whitelist — set options whitelist context. whitelist context 👑
--end-whitelist — clear options whitelist context. clear whitelist 💜
--ignore-sigpipe — do not report (annoying) SIGPIPE. ignore SIGPIPE 🙈
--ignore-write-errors — do not report (annoying) write()/writev() errors. ignore write errors 😭
--write-errors-tolerance — set the maximum number of allowed write errors (default: no tolerance). tolerance level: zero ⭐
--write-errors-exception-only — only raise an exception on write errors giving control to the app itself. exception only 🔥
--disable-write-exception — disable exception generation on write()/writev(). no write exception 💅
--inherit — use the specified file as config template. inherit template 🎀
--include — include the specified file as immediate configuration. include config ✨
--inject-before — inject a text file before the config file (advanced templating). inject before 💖
--inject-after — inject a text file after the config file (advanced templating). inject after 💜
-d, --daemonize — daemonize uWSGI. daemonize it 👑
--daemonize2 — daemonize uWSGI after app loading. daemonize after app load ⭐
--stop — stop an instance. stop an instance 💀
--reload — reload an instance. reload an instance 🔥
--pause — pause an instance. pause an instance ✨
--suspend — suspend an instance. suspend an instance 💅
--resume — resume an instance. resume an instance 💖
--connect-and-read — connect to a socket and wait for data from it. connect and read 🦋
--extract — fetch/dump any supported address to stdout. extract to stdout 🎀
-l, --listen — set the socket listen queue size. listen queue size 💅
-v, --max-vars — set the amount of internal iovec/vars structures. max vars ✨
--max-apps — set the maximum number of per-worker applications. max apps per worker 💜
-b, --buffer-size — set internal buffer size. buffer size ⭐
-m, --memory-report — enable memory report. memory report 👑
--profiler — enable the specified profiler. profiler on 🔥
-c, --cgi-mode — force CGI-mode for plugins supporting it. CGI mode 💅
-a, --abstract-socket — force UNIX socket in abstract mode (Linux only). abstract socket, Linux only 🦋
-C, --chmod-socket — chmod-socket. the description is literally chmod-socket, iconic ✨
-C, --chmod — chmod-socket. same alias energy 💖
--chown-socket — chown unix sockets. chown unix sockets 💜
--umask — set umask. set umask ⭐
--freebind — put socket in freebind mode. freebind mode 🧚
--map-socket — map sockets to specific workers. map sockets to workers 💅
-T, --enable-threads — enable threads. enable threads 🔥
--no-threads-wait — do not wait for threads cancellation on quit/reload. no threads wait 🙈
--auto-procname — automatically set processes name to something meaningful. auto procname 👑
--procname-prefix — add a prefix to the process names. procname prefix ✨
--procname-prefix-spaced — add a spaced prefix to the process names. spaced prefix 💖
--procname-append — append a string to process names. procname append 💜
--procname — set process names. set process names ⭐
--procname-master — set master process name. master procname 💅
-i, --single-interpreter — do not use multiple interpreters (where available). single interpreter 🧚
--need-app — exit if no app can be loaded. need app or exit 😭
-M, --master — enable master process. master process 👑
--honour-stdin — do not remap stdin to /dev/null. honour stdin 💖
--emperor — run the Emperor. run the Emperor 👑
--emperor-proxy-socket — force the vassal to became an Emperor proxy. emperor proxy socket ✨
--emperor-wrapper — set a binary wrapper for vassals. emperor wrapper 💜
--emperor-wrapper-override — set a binary wrapper for vassals to try before the default one. wrapper override ⭐
--emperor-wrapper-fallback — set a binary wrapper for vassals to try as a last resort. wrapper fallback 💅
--emperor-nofollow — do not follow symlinks when checking for mtime. nofollow symlinks 🦋
--emperor-procname — set the Emperor process name. emperor procname 🎀
--emperor-freq — set the Emperor scan frequency (default 3 seconds). emperor freq, default 3 seconds ⭐
--emperor-required-heartbeat — set the Emperor tolerance about heartbeats. required heartbeat 💖
--emperor-curse-tolerance — set the Emperor tolerance about cursed vassals. curse tolerance 😭
--emperor-pidfile — write the Emperor pid in the specified file. emperor pidfile 👑

Okay so this next chunk is a LOT of Emperor stuff and then the security/fd/cache/spooler zone, buckle up bestie 🎀

--emperor-tyrant — puts the Emperor into Tyrant mode 👑 (yes that's the actual name, it's giving monarchy)
--emperor-tyrant-nofollow — do not follow symlinks when it's checking for uid/gid in Tyrant mode 🚫🔗
--emperor-stats — runs the Emperor stats server 📊
--emperor-stats-server — also runs the Emperor stats server (same thing, different spelling of the flag, iykyk)
--early-emperor — spawns the emperor as soon as possibile ⏰ (yes, "possibile" — that's the original spelling, keeping it fr fr)
--emperor-broodlord — runs the emperor in BroodLord mode 🐣 (iconic name, no notes)
--emperor-throttle — sets the throttling level (in milliseconds) for bad behaving vassals — default is 1000 😤
--emperor-max-throttle — sets the max throttling level (in milliseconds) for bad behaving vassals — default is 3 minutes 🚧
--emperor-magic-exec — prefixes vassals config files with exec:// if they have the executable bit ✨
--emperor-on-demand-extension — searches for a text file (vassal name + extension) containing the on demand socket name 🔍
--emperor-on-demand-ext — same deal: searches for a text file (vassal name + extension) containing the on demand socket name
--emperor-on-demand-directory — enables on demand mode, binding to the unix socket in the specified directory, named like the vassal + .socket 🔌
--emperor-on-demand-dir — enables on demand mode, binding to the unix socket in the specified directory, named like the vassal + .socket
--emperor-on-demand-exec — uses the output of the specified command as 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 — allows the specified extension in the Emperor (the vassal will be called with --config)
--emperor-no-blacklist — disables the Emperor blacklisting subsystem 🚫
--emperor-use-clone — uses clone() instead of fork(), passing the specified unshare() flags 🧬
--emperor-graceful-shutdown — uses vassals graceful shutdown during ragnarok 🌋 (yes, ragnarok, the end times, it's a whole vibe)
--emperor-cap — sets vassals capability 🔐
--vassals-cap — sets vassals capability
--vassal-cap — sets vassals capability
--imperial-monitor-list — lists enabled imperial monitors 📋
--imperial-monitors-list — lists enabled imperial monitors
--vassals-inherit — adds config templates to vassals config (uses --inherit) 📄
--vassals-include — includes config templates into vassals config (uses --include instead of --inherit)
--vassals-inherit-before — adds config templates to vassals config (uses --inherit, and parses before the vassal file) ⬅️
--vassals-include-before — includes config templates into vassals config (uses --include instead of --inherit, and parses before the vassal file)
--vassals-start-hook — runs the specified command before each vassal starts 🚀
--vassals-stop-hook — runs the specified command after vassal's death 💀
--vassal-sos — asks the emperor for reinforcement when overloaded 🆘
--vassal-sos-backlog — asks the emperor for sos if the backlog queue has more items than the value specified 📈
--vassals-set — automatically sets the specified option (via --set) for every vassal ⚙️
--vassal-set — automatically sets the specified option (via --set) for every vassal
--heartbeat — announces healthiness to the emperor 💓
--reload-mercy — sets the maximum time (in seconds) we wait for workers and other processes to die during reload/shutdown ⏳
--worker-reload-mercy — sets the maximum time (in seconds) a worker can take to reload/shutdown — default is 60 🕐
--mule-reload-mercy — sets the maximum time (in seconds) a mule can take to reload/shutdown — default is 60 🐴
--exit-on-reload — forces exit even if a reload is requested 🚪
--die-on-term — exits instead of doing a brutal reload on SIGTERM ☠️
--force-gateway — forces the spawn of the first registered gateway without a master 🌉
-h, --help — shows this help 🙋
-h, --usage — shows this help
--print-sym — prints the content of the specified binary symbol 🔬
--print-symbol — prints the content of the specified binary symbol
-r, --reaper — calls waitpid(-1,...) after each request to get rid of zombies 🧟 (actual zombies, not the fun kind)
-R, --max-requests — reloads 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 — reloads workers after the specified amount of seconds — default is disabled 🚫
--max-worker-lifetime-delta — adds (worker_id * delta) seconds to the max_worker_lifetime value of each worker ➕
-z, --socket-timeout — sets internal sockets timeout ⏲️
--no-fd-passing — disables file descriptor passing 🚷
--locks — creates the specified number of shared locks 🔒
--lock-engine — sets the lock engine ⚙️
--ftok — sets the ipcsem key via ftok() for avoiding duplicates 🔑
--persistent-ipcsem — does not remove ipcsem's on shutdown 💾
-A, --sharedarea — creates a raw shared memory area of specified pages (note: it supports keyval too) 🧠
--safe-fd — does not close the specified file descriptor 🛟
--fd-safe — does not close the specified file descriptor
--cache — creates a shared cache containing given elements 🗃️
--cache-blocksize — sets cache blocksize 🧱
--cache-store — enables persistent cache to disk 💽
--cache-store-sync — sets the frequency of sync for persistent cache 🔄
--cache-no-expire — disables auto sweep of expired items 🧹
--cache-expire-freq — sets the frequency of cache sweeper scans — default 3 seconds ⏰
--cache-report-freed-items — constantly reports the cache item freed by the sweeper (use only for debug) 🐛
--cache-udp-server — binds the cache udp server (used only for set/update/delete) to the specified socket 📡
--cache-udp-node — sends cache update/deletion to the specified cache udp server 📤
--cache-sync — copies the whole content of another uWSGI cache server on server startup 📥
--cache-use-last-modified — updates 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 shared queue 🚶
--queue-blocksize — sets queue blocksize 🧱
--queue-store — enables persistent queue to disk 💽
--queue-store-sync — sets the frequency of sync for persistent queue 🔄
-Q, --spooler — runs a spooler on the specified directory 🖨️
--spooler-external — maps spoolers requests to a spooler directory managed by an external instance 🌐
--spooler-ordered — tries to order the execution of spooler tasks 🔢
--spooler-chdir — chdir() to the specified directory before each spooler task 📁
--spooler-processes — sets the number of processes for spoolers 👯
--spooler-quiet — does not be verbose with spooler tasks 🤫
--spooler-max-tasks — sets the maximum number of tasks to run before recycling a spooler ♻️
--spooler-harakiri — sets harakiri timeout for spooler tasks 🗡️
--spooler-frequency — sets spooler frequency 📶
--spooler-freq — sets spooler frequency
--mule — adds a mule 🐴
--mules — adds the specified number of mules 🐴🐴🐴
--farm — adds a mule farm 🚜
--mule-msg-size — sets mule message buffer size 📨
--signal — sends a uwsgi signal to a server 📶
--signal-bufsize — sets buffer size for the signal queue 📦
--signals-bufsize — sets 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 specified file before starting, exits if locked 🔒
--flock-wait — locks the specified file before starting, waits if locked ⏸️
--flock2 — locks the specified file after logging/daemon setup, exits if locked 🔒
--flock-wait2 — locks the specified file after logging/daemon setup, waits if locked ⏸️
--pidfile — creates 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() to the specified directory 🏰
--pivot-root — pivot_root() to the specified directories (new_root and put_old must be separated with a space) 🔄
--pivot_root — pivot_root() to the specified directories (new_root and put_old must be separated with a space)
--uid — setuid to the specified user/uid 🧑
--gid — setgid to the specified group/gid 👥
--add-gid — adds the specified group id to the process credentials ➕
--immediate-uid — setuid to the specified user/uid IMMEDIATELY ⚡
--immediate-gid — setgid to the specified group/gid IMMEDIATELY ⚡
--no-initgroups — disables additional groups set via initgroups() 🚫
--cap — sets process capability 🔐
--unshare — unshare() part of the processes and puts it in a new namespace 🫧
--unshare2 — unshare() part of the processes and puts it in a new namespace after rootfs change 🫧
--setns-socket — exposes a unix socket returning namespace fds from /proc/self/ns 🔌
--setns-socket-skip — skips the specified entry when sending setns file descriptors ⏭️
--setns-skip — skips the specified entry when sending setns file descriptors
--setns — joins a namespace created by an external uWSGI instance 🤝
--setns-preopen — opens /proc/self/ns as soon as possible and caches fds 🗂️
--jailed — marks the instance as jailed (forces the execution of post_jail hooks) ⛓️

ngl that was a whole journey bestie, and we're not even done 💅 more coming, don't go anywhere 🫶

✨ OPTIONS ✨

Okay bestie, deep breath. This is the big list. It's giving infinite scroll, but every single one of these is real and useful so we're going through them together, no skipping. 🫶

First up: the fork-again crew. If you're doing jails, these are your girls. 🔁

--refork — do a whole extra fork() after the privileges drop. Super useful for jailing systems.
--re-fork — exactly the same thing as --refork, another fork() after the privileges drop. Also for jailing systems. (Yes they're twins, we love a duplicate name moment. 👯)
--refork-as-root — fork() again before the privileges drop. Useful for jailing systems.
--re-fork-as-root — same energy: fork() again before the privileges drop, useful for jailing systems.
--refork-post-jail — fork() again after jailing. Useful for jailing systems.
--re-fork-post-jail — yeah, fork() again after jailing, useful for jailing systems. Periodt.

Now the hooks 💅 — "run the specified hook" is the vibe here, it's just when that changes. Pick your moment:

--hook-asap — run the specified hook as soon as possible. no waiting, main character energy ⚡
--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 the privileges drop.
--hook-as-user — run the specified hook after the 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.

And two little per-request besties that do the same thing:

--after-request-hook — run the specified function/symbol after each request.
--after-request-call — run the specified function/symbol after each request.

Same exact timeline, but for running commands instead of hooks. Slay. 🔥

--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 the privileges drop.
--exec-as-user — run the specified command after the 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.

Mounts! 🧚 (they're just filesystems, but make it fashion)

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

And the un-mounties, same timings, opposite direction:

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

Waiting room era 🕐 — these make uWSGI chill until the thing it needs actually shows up.

--wait-for-interface — wait for the specified network interface to come up before running root hooks.
--wait-for-interface-timeout — set the timeout for wait-for-interface.
--wait-interface — wait for the specified network interface to come up before running root hooks. (same deal, shorter name ✨)
--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.

Now the call family — these call a specified function at a specific moment. And because C doesn't do vibes-based argument passing, the name tells you the exact signature. Keep these EXACT, bestie, character for character:

--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 the privileges drop.
--call-as-user — call the specified function after the 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 📂 — yes, you can read your settings in from a file instead of screaming flags at the terminal:

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

A lil cluster-flavored batch 🫂:

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

Sockets & TCP glow-up ✨:

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

Memory & limits, aka the part where we get responsible 🧠:

--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. (it's called evil for a reason, ok 💀)
--evil-reload-on-rss — force the master to reload a worker if its rss memory is higher than specified megabytes.
--mem-collector-freq — set the memory collector frequency when evil reloads are in place.
--reload-on-fd — reload if the specified file descriptor is ready.
--brutal-reload-on-fd — brutal reload if the specified file descriptor is ready. 🔥
--ksm — enable Linux KSM.
--pcre-jit — enable pcre jit (if available).
--never-swap — lock all memory pages avoiding swapping.

Touch-triggered everything 🎀 — poke a file, make uWSGI do a thing. Iconic behavior honestly:

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

Heads up bestie: the option list is still going, so don't close the tab yet 💖

okay bestie we're back in it, the option buffet continues, hydrate before reading 💖

--fs-reload — the moment the filesystem object you named gets touched, it does a graceful reload 🦋 like a polite little refresh
--fs-brutal-reload — same vibe but brutal 😤 filesystem object changes → instant brutal reload, no softness, no chill
--fs-signal — when the filesystem object changes it raises a uwsgi signal. syntax: file signal (yes, both of them, in that order bestie)
--check-mountpoint — nukes the instance if a filesystem becomes unreachable. genuinely useful for reliable Fuse management 👑
--mountpoint-check — same thing, same energy: instance goes bye if a filesystem is no longer reachable (reliable Fuse management, again)
--check-mount — yep, another twin 💅 destroy the instance when a filesystem is no more reachable (Fuse, reliable, you know the drill)
--mount-check — the fourth one, same soul: instance destroyed if a filesystem isn't reachable anymore, great for reliable Fuse management 🌸
--propagate-touch — literally described as an over-engineering option for systems with flaky signal management 😭 iconic self-awareness
--limit-post — puts a cap on the request body 🫶
--no-orphans — workers get auto-killed if master dies. but heads up: this can be dangerous for availability ⚠️
--prio — set the priority of processes/threads
--cpu-affinity — set cpu affinity
--post-buffering — sets the size in bytes after which it buffers to disk instead of memory 💾
--post-buffering-bufsize — sets the buffer size used for read() while in post buffering mode
--body-read-warning — how much memory allocation (in megabytes) for the request body is allowed before it starts printing a warning 📢
--upload-progress — turns on creation of .json files in the directory you specify, while a file upload is happening
--no-default-app — do not fallback to the default app 🙈
--manage-script-name — automatically rewrites SCRIPT_NAME and PATH_INFO for you ✨
--ignore-script-name — just ignores SCRIPT_NAME entirely
--catch-exceptions — reports the exception as http output. discouraged, use only for testing bestie, i'm serious 🚨
--reload-on-exception — reloads a worker whenever an exception is raised
--reload-on-exception-type — reloads a worker when one 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 — turns the metrics subsystem on 📊
--metric — add a custom metric, your own little number, your own little star ⭐
--metric-threshold — add a metric threshold/alarm 🚨
--metric-alarm — also add a metric threshold/alarm (same thing, different name)
--alarm-metric — and again: add a metric threshold/alarm
--metrics-dir — export metrics as text files into the directory you name 📁
--metrics-dir-restore — restores the last value taken from the metrics dir
--metric-dir — export metrics as text files to the specified directory (yes, the singular spelling twin)
--metric-dir-restore — restore last value taken from the metrics dir, singular flavour
--metrics-no-cores — disables generation of cores-related metrics
--udp — run the udp server on the address you give it 📡
--stats — enable the stats server on the specified address
--stats-server — enable the stats server on the specified address (same, bestie)
--stats-http — prefixes the stats server json output with http headers 🌐
--stats-minified — minifies the statistics json output
--stats-min — minifies the statistics json output (short king behaviour 👑)
--stats-push — push the stats json to whatever destination you name
--stats-pusher-default-freq — set the default frequency of stats pushers
--stats-pushers-default-freq — set the default frequency of stats pushers (plural, same deal)
--stats-no-cores — disables generation of cores-related stats
--stats-no-metrics — don't 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 is 1 🔁
--master-fifo — enable the master fifo
--notify-socket — enable the notification socket 🔔
--subscription-notify-socket — set the notification socket used for subscriptions
--legion — become a member of a legion 🛡️
--legion-mcast — become a member of a legion, but the shortcut for multicast version
--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 — declares itself a dead node for however many seconds you say, if one of the lord hooks fails 💀
--legion-skew-tolerance — set the clock skew tolerance of the legion subsystem, default 30 seconds ⏰
--legion-lord — the action to call on Lord election 👑
--legion-unlord — the action to call on Lord dismiss
--legion-setup — action to call on legion setup
--legion-death — action to call on legion death (that's the shutdown of the instance, dramatic much 😭)
--legion-join — action to call on legion join (the first time quorum is reached)
--legion-node-joined — action to call when a new node joins the legion 🫶
--legion-node-left — action to call when a node leaves the legion
--legion-quorum — set the quorum of a legion
--legion-scroll — set the scroll of a legion
--legion-scroll-max-size — 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 unix sockets credentials are in play
--subscriptions-credentials-check — add a directory to search for subscriptions key credentials
--subscriptions-use-credentials — enable management of SCM_CREDENTIALS in subscriptions UNIX sockets
--subscription-algo — set the load balancing algorithm for the subscription system ⚖️
--subscription-dotsplit — tries to fallback to the next part (dot based) in the subscription key
--subscribe-to — subscribe to the subscription server you specify
--st — subscribe to the specified subscription server (tiny name, big job)
--subscribe — subscribe to the specified subscription server (the classic)
--subscribe2 — subscribe to the specified subscription server using the advanced keyval syntax ✨
--subscribe-freq — send subscription announce at the interval you set
--subscription-tolerance — set tolerance for subscription servers
--unsubscribe-on-graceful-reload — forces the unsubscribe request even during a graceful reload
--start-unsubscribed — configure subscriptions but don't actually send them (super handy with master fifo) 🤫
--subscribe-with-modifier1 — force the specified modifier1 when subscribing (typo in the original said "specififed", we're keeping the meaning, bestie)
--snmp — enable the embedded snmp server 📈
--snmp-community — set the snmp community string
--ssl-verbose — be verbose about SSL errors, spill the tea 🫖
--ssl-verify-depth — set maximum certificate verification depth
--sni — add an SNI-governed SSL context
--sni-dir — check for cert/key/client_ca files 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 ⚠️
--ssl-enable-sslv3 — enable SSLv3. insecure, same warning, same yikes
--ssl-enable-tlsv1 — enable TLSv1. insecure 🙈
--ssl-option — set a raw ssl option, numeric value only
--sni-regexp — add an SNI-governed SSL context where the key is a regexp 🧚
--ssl-tmp-dir — store ssl-related temp files in the directory you name
--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, and it happens before the privileges drop
--unprivileged-binary-patch — patch the uwsgi binary with a new command, after the privileges drop
--privileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments, before privileges drop
--unprivileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments, after privileges drop
--async — enable async mode with the number of cores you specify ⚡
--max-fd — set maximum number of file descriptors. requires root privileges 👑
--logto — set the logfile/udp address
--logto2 — log to the specified file or udp address, but after the privileges drop
--log-format — set an advanced format for request logging
--logformat — set an advanced format for request logging (the no-dash twin)
--logformat-strftime — apply strftime to the logformat output
--log-format-strftime — apply strftime to the logformat output (same, dashed up)
--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 (reordered, same job)
--logger — set/append a logger
--logger-list — list enabled loggers 📋
--loggers-list — list enabled loggers (plural version, same list)
--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, aka don't show, log lines matching the regexp you give
--log-filter — show only the log lines matching the regexp you give
--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. 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 💅

and that's part 4 bestie, we are SO not done, keep scrolling 🌈

--alarm-freq — tunes the anti-loop alarm system 💅 (default is 3 seconds, bestie)
--alarm-fd — fire the alarm you name here when an fd is read for read. by default it reads 1 byte — set 8 if you're doing eventfd ✨
--alarm-segfault — fire the specified alarm when the segmentation fault handler runs 😭
--segfault-alarm — same thing, different name: fire the specified alarm when the segfault handler runs
--alarm-backlog — fire the specified alarm when the socket backlog queue is full 👑
--backlog-alarm — fire the specified alarm when the socket backlog queue is full
--lq-alarm — fire the specified alarm when the socket backlog queue is full
--alarm-lq — fire the specified alarm when the socket backlog queue is full
--alarm-listen-queue — fire the specified alarm when the socket backlog queue is full
--listen-queue-alarm — fire the specified alarm when the socket backlog queue is full
--log-alarm — fire the specified alarm when a log line matches the regexp you give it. syntax is literally: <alarm>[,alarm...] <regexp> 🍓
--alarm-log — fire the specified alarm when a log line matches the regexp you give it, syntax: <alarm>[,alarm...] <regexp>
--not-log-alarm — skip the specified alarm when a log line matches the regexp you give it, syntax: <alarm>[,alarm...] <regexp>
--not-alarm-log — skip the specified alarm when a log line matches the regexp you give it, syntax: <alarm>[,alarm...] <regexp>
--alarm-list — list all the enabled alarms 💖
--alarms-list — list all the enabled alarms
--alarm-msg-size — set the max size of an alarm message (default 8192)

✨ LOGGING, BUT MAKE IT EXTRA ✨

--log-master — delegate logging to the master process 🫶
--log-master-bufsize — set the buffer size for the master logger. bigger log messages will be truncated, so like… don't go overboard
--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
--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 with a strftime string 🌸
--log-date — prefix your logs with a date, or with a strftime string
--log-prefix — prefix your logs with a string
--log-zero — log responses that have no body
--log-slow — log any request slower than the number of milliseconds you specify 🐌
--log-4xx — log requests with a 4xx response
--log-5xx — log requests with a 5xx response
--log-big — log requests bigger than the size you specify
--log-sendfile — log sendfile requests
--log-ioerror — log requests that hit io errors 💀
--log-micros — report response time in microseconds instead of milliseconds
--log-x-forwarded-for — use the ip from the X-Forwarded-For header instead of REMOTE_ADDR (iykyk)

👑 PRIVILEGES & DIRECTORIES & LOADING 👑

--master-as-root — leave the master process running as root ⚠️
--drop-after-init — run the privileges drop after plugin initialization. this one is superseded by drop-after-apps
--drop-after-apps — run the privileges drop after apps loading. this one is superseded by master-as-root
--force-cwd — force the initial working directory to the value you give it
--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 the enabled cheapers algorithms
--cheaper-algos-list — list the enabled cheapers algorithms
--cheaper-list — list the enabled cheapers algorithms
--cheaper-rss-limit-soft — don't spawn new workers if the total resident memory usage of all workers goes above this limit
--cheaper-rss-limit-hard — if the total workers resident memory usage is higher, try to stop workers
--idle — set idle mode (put uWSGI into cheap mode after inactivity) 🛋️
--die-on-idle — shutdown uWSGI when it's idle

--mount — load an application under a mountpoint
--worker-mount — load an 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)

🌈 ROUTES, ROUTES, AND MORE ROUTES 🌈

--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 (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 status you specify
--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 (the 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 status you specify
--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 (the 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 status you specify
--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 (the negate version)
--response-route-run — always run the specified response route action
--router-list — list the enabled routers 💅
--routers-list — list the enabled routers
--error-page-403 — add an error page (html) for a managed 403 response
--error-page-404 — add an error page (html) for a managed 404 response
--error-page-500 — add an error page (html) for a managed 500 response

🦋 WEBSOCKETS & CHUNKED INPUT & CLOCKS 🦋

--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 the enabled clocks
--clocks-list — list the enabled clocks
--add-header — automatically add HTTP headers to the response ✨
--rem-header — automatically yeets the specified HTTP header out of the response 💅
--del-header — literally the same: auto-removes the specified HTTP header from the response ✨
--collect-header — stashes the specified response header into a request var (syntax: header var) 🎀
--response-header-collect — same energy: stores the specified response header in a request var (syntax: header var) 🦋
--pull-header — stores the specified response header in a request var and removes it from the response (syntax: header var) 💖
--check-static — checks for static files in the directory you name 📂
--check-static-docroot — checks for static files in the requested DOCUMENT_ROOT 🌸
--static-check — checks for static files in the specified directory (yep, same as --check-static) 🍓
--static-map — maps a mountpoint to a static directory (or file) 🗺️
--static-map2 — like --static-map but it completely appends the requested resource to the docroot 🧚
--static-skip-ext — skips the specified extension from static file checks 🚫
--static-index — searches for the specified file if a directory is requested 👑
--static-safe — skips security checks if the file is under the specified path 🛡️
--static-cache-paths — puts resolved paths in the uWSGI cache for the specified amount of seconds ⏱️
--static-cache-paths-name — uses the specified cache for static paths 💾
--mimefile — sets the mime types file path (default /etc/mime.types) 📄
--mime-file — same thing: sets the mime types file path (default /etc/mime.types) 📄
--static-expires-type — sets the Expires header based on content type ⏳
--static-expires-type-mtime — sets the Expires header based on content type and file mtime 🕰️
--static-expires — sets the Expires header based on filename regexp 🔍
--static-expires-mtime — sets the Expires header based on filename regexp and file mtime 🕰️
--static-expires-uri — sets the Expires header based on REQUEST_URI regexp 🌐
--static-expires-uri-mtime — sets the Expires header based on REQUEST_URI regexp and file mtime 🕰️
--static-expires-path-info — sets the Expires header based on PATH_INFO regexp 🛤️
--static-expires-path-info-mtime — sets the Expires header based on PATH_INFO regexp and file mtime 🕰️
--static-gzip — if the supplied regexp matches the static file translation, it searches for a gzip version 🗜️
--static-gzip-all — checks for a gzip version of all requested static files 📦
--static-gzip-dir — checks for a gzip version of all requested static files in the specified dir/prefix 📁
--static-gzip-prefix — same as above: checks for a gzip version of all requested static files in the specified dir/prefix 📁
--static-gzip-ext — checks for a gzip version of all requested static files with the specified ext/suffix 🔤
--static-gzip-suffix — same: checks for a gzip version of all requested static files with the specified ext/suffix 🔤
--honour-range — enables support for the HTTP Range header 📏
--offload-threads — sets the number of offload threads to spawn (per-worker, default 0) 🧵
--offload-thread — same: sets the number of offload threads to spawn (per-worker, default 0) 🧵
--file-serve-mode — sets static file serving mode ⚙️
--fileserve-mode — same: sets static file serving mode ⚙️
--disable-sendfile — disables sendfile() and relies on boring read()/write() 😴
--check-cache — checks for response data in the specified cache (empty for default cache) 🔎
--close-on-exec — sets close-on-exec on connection sockets (could be required for spawning processes in requests) 🔒
--close-on-exec2 — sets close-on-exec on server sockets (could be required for spawning processes in requests) 🔐
--mode — 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 — tries to remove all of the generated file/sockets 🧹
--file-write — writes the specified content to the specified file (syntax: file=value) before privileges drop ✍️
--cgroup — puts the processes in the specified cgroup 📦
--cgroup-opt — sets value in specified cgroup option ⚙️
--cgroup-dir-mode — sets permission for cgroup directory (default is 700) 🔐
--namespace — runs in a new namespace under the specified rootfs 🏠
--namespace-keep-mount — keeps the specified mountpoint in your namespace 📌
--ns — runs in a new namespace under the specified rootfs (same as --namespace) 🏠
--namespace-net — adds network namespace 🌐
--ns-net — adds network namespace (same) 🌐
--enable-proxy-protocol — enables PROXY1 protocol support (only for http parsers) 🧙
--reuse-port — enables REUSE_PORT flag on socket (BSD only) 🔄
--tcp-fast-open — enables TCP_FASTOPEN flag on TCP sockets with the specified qlen value 🚀
--tcp-fastopen — same: enables TCP_FASTOPEN flag on TCP sockets with the specified qlen value 🚀
--tcp-fast-open-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported 📡
--tcp-fastopen-client — same: uses 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 — enables the zerg server on the specified UNIX socket 🐛
--cron — adds a cron task ⏰
--cron2 — adds a cron task (key=val syntax) ⏰
--unique-cron — adds a unique cron task ⏰
--cron-harakiri — sets the maximum time (in seconds) we wait for cron command to complete ⏳
--legion-cron — adds a cron task runnable only when the instance is a lord of the specified legion 👑
--cron-legion — same: adds a cron task runnable only when the instance is a lord of the specified legion 👑
--unique-legion-cron — adds a unique cron task runnable only when the instance is a lord of the specified legion 👑
--unique-cron-legion — same: adds 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 — same: list enabled loop engines 📋
--worker-exec — runs the specified command as worker 👷
--worker-exec2 — runs the specified command as worker (after post_fork hook) 👷
--attach-daemon — attaches a command/daemon to the master process (the command has to not go in background) 🔗
--attach-control-daemon — attaches a command/daemon to the master process (the command has to not go in background), and when the daemon dies, the master dies too 💀
--smart-attach-daemon — attaches a command/daemon to the master process managed by a pidfile (the command has to daemonize) 🧠
--smart-attach-daemon2 — attaches a command/daemon to the master process managed by a pidfile (the command has to NOT daemonize) 🧠
--legion-attach-daemon — same as --attach-daemon but the daemon runs only on legion lord node 👑
--legion-smart-attach-daemon — same as --smart-attach-daemon but the daemon runs only on legion lord node 👑
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2 but the 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 (same) 🔌
--need-plugins — load uWSGI plugins (exit on error) 🚪
--need-plugin — load uWSGI plugins (exit on error) (same) 🚪
--plugins-dir — add a directory to uWSGI plugin search path 📁
--plugin-dir — add a directory to uWSGI plugin search path (same) 📁
--plugins-list — list enabled plugins 📃
--plugin-list — list enabled plugins (same) 📃
--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 a wrap on this whole manual page, bestie! This was for uwsgi_rack_ruby32 version 2.0.24-debian, dated April 2024. You're welcome 💖✨

📦 where this page comes from

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