UWSGI_RACK(1)

📦

version 2.0.31+2+0.0.3 · 3 versions

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

✨ UWSGI_RACK(1) ✨

okay bestie, welcome to uwsgi_rack 💅 this is the manual page for it, filed under User Commands, and it's genuinely one of those pages. grab a strawberry drink 🍓, we're going through it together.

🎀 NAME 🎀

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

like. it's a server. it's in pure C. it heals itself. it's nice to devs. that's the whole vibe. no cap.

🌸 SYNOPSIS 🌸

uwsgi-core [options...]

that's it. that's the whole thing. you run it and then you just. keep adding options. forever. iykyk. 💀

💖 DESCRIPTION 💖

so this whole section is basically the giant menu of socket-binding options and process-control options and honestly it's giving "all-you-can-eat buffet but make it sysadmin". every single flag is listed below, in order, no skipping, because i love you and i want you to actually understand it. 🫶

🌈 sockets, but make it a whole personality 🌈

-s, --socket — bind to the specified UNIX/TCP socket using the default protocol ✨
-s, --uwsgi-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol
--suwsgi-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol over SSL 🔒
--ssl-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol over SSL 🔒 (yes it's basically the same energy as the one above, that's just how it is bestie)
--http-socket — bind to the specified UNIX/TCP socket using the 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 (twinning with the one above, we love consistency)
--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 & the whole harakiri situation 🔥

-p, --processes — spawn the specified number of workers/processes 🧑🍳
-p, --workers — spawn the specified number of workers/processes (same energy, different spelling, both valid)
--thunder-lock — serialize accept() usage (if possible) ⚡
-t, --harakiri — set harakiri timeout 🗡️
--harakiri-verbose — enable verbose mode for harakiri
--harakiri-graceful-timeout — interval between graceful harakiri attempt and a sigkill
--harakiri-graceful-signal — use this signal instead of sigterm for graceful harakiri attempts
--harakiri-queue-threshold — only trigger harakiri if queue is greater than this threshold
--harakiri-no-arh — do not enable harakiri during after-request-hook
--no-harakiri-arh — do not enable harakiri during after-request-hook
--no-harakiri-after-req-hook — do not enable harakiri during after-request-hook (three names, one job, iconic honestly)
--backtrace-depth — set backtrace depth 🪜
--mule-harakiri — set harakiri timeout for mule tasks 🐴

📜 config loading & the pluggable system 📜

-x, --xmlconfig — load config from xml file
-x, --xml — load config from xml file (same thing, shorter name, we stan options)
--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)

🎀 placeholders, custom options & the opt-logic situation 🎀

-S, --set — set a placeholder or an option
--set-placeholder — set a placeholder
--set-ph — set a placeholder (short king version)
--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) 🌐
--for — (opt logic) for cycle 🔁
--for-glob — (opt logic) for cycle (expand glob)
--for-times — (opt logic) for cycle (expand the specified num to a list starting from 1)
--for-readline — (opt logic) for cycle (expand the specified file to a list of lines)
--endfor — (opt logic) end for cycle
--end-for — (opt logic) end for cycle
--if-opt — (opt logic) check for option
--if-not-opt — (opt logic) check for option
--if-env — (opt logic) check for environment variable
--if-not-env — (opt logic) check for environment variable
--ifenv — (opt logic) check for environment variable
--if-reload — (opt logic) check for reload
--if-not-reload — (opt logic) check for reload
--if-hostname — (opt logic) check for hostname
--if-not-hostname — (opt logic) check for hostname
--if-hostname-match — (opt logic) try to match hostname against a regular expression 🔍
--if-not-hostname-match — (opt logic) try to match hostname against a regular expression
--if-exists — (opt logic) check for file/directory existence
--if-not-exists — (opt logic) check for file/directory existence
--ifexists — (opt logic) check for file/directory existence
--if-plugin — (opt logic) check for plugin
--if-not-plugin — (opt logic) check for plugin
--ifplugin — (opt logic) check for plugin
--if-file — (opt logic) check for file existence
--if-not-file — (opt logic) check for file existence
--if-dir — (opt logic) check for directory existence
--if-not-dir — (opt logic) check for directory existence
--ifdir — (opt logic) check for directory existence
--if-directory — (opt logic) check for directory existence
--endif — (opt logic) end if
--end-if — (opt logic) end if
--blacklist — set options blacklist context 🖤
--end-blacklist — clear options blacklist context
--whitelist — set options whitelist context 🤍
--end-whitelist — clear options whitelist context

💅 errors, and how much you want to hear about them 💅

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

🧚 config templating & injection 🧚

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

👑 daemonizing, and controlling your little instances 👑

-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 & memory vibes 🌸

-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 (same job, shorter name)
--chown-socket — chown unix sockets
--umask — set umask
--freebind — put socket in freebind mode
--map-socket — map sockets to specific workers 🗺️

🫶 threads, process names & being perceived 🫶

-T, --enable-threads — enable threads (stub option this is true by default) 🧵
--no-threads-wait — do not wait for threads cancellation on quit/reload
--auto-procname — automatically set processes name to something meaningful 🏷️
--procname-prefix — add a prefix to the process names
--procname-prefix-spaced — add a spaced prefix to the process names
--procname-append — append a string to process names
--procname — set process names
--procname-master — set master process name
-i, --single-interpreter — do not use multiple interpreters (where available)
--need-app — exit if no app can be loaded ⚠️
-M, --master — enable master process 👑
--honour-stdin — do not remap stdin to /dev/null

🌈 the Emperor & its vassals (yes this is real, yes it's a whole saga) 🌈

--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 — writes the Emperor's pid into the file you specify, bestie 💖
--emperor-tyrant — puts the Emperor into Tyrant mode 👑
--emperor-tyrant-nofollow — in Tyrant mode, do not follow symlinks when checking for uid/gid 🚫🔗
--emperor-stats — runs the Emperor stats server ✨
--emperor-stats-server — runs the Emperor stats server (same vibe, same job) 📊
--early-emperor — spawns the emperor as soon as possible, no waiting around 🏃‍♀️💨
--emperor-broodlord — runs the emperor in BroodLord mode 🐉
--emperor-throttle — sets the throttling level (in milliseconds) for bad behaving vassals, default 1000 ⏳
--emperor-max-throttle — sets the max throttling level (in milliseconds) for bad behaving vassals, default 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 — 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 on demand socket name; the vassal name is passed as the only argument 🫡
--emperor-extra-extension — allows the specified extension in the Emperor; vassal will be called with --config 🌟
--emperor-extra-ext — allows the specified extension in the Emperor; vassal will be called with --config 🌟
--emperor-no-blacklist — 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 🌅
--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 to vassals config, uses --include instead of --inherit 📎
--vassals-inherit-before — adds config templates to vassals config, uses --inherit, parses before the vassal file ⏮️
--vassals-include-before — includes config templates to vassals config, uses --include instead of --inherit, 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 emperor for reinforcement when overloaded 🆘
--vassal-sos-backlog — asks emperor for sos if 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 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 content of the specified binary symbol 🔣
--print-symbol — prints content of the specified binary symbol 🔣
-r|--reaper — calls waitpid(-1,...) after each request to get rid of zombies 🧟
-R|--max-requests — reloads workers after the specified amount of managed requests 🔄
--max-requests-delta — adds (worker_id * delta) to the max_requests value of each worker ➕
--min-worker-lifetime — number of seconds a worker must run before being reloaded, default is 10 ⏳
--max-worker-lifetime — reloads workers after the specified amount of seconds, default is disabled 🚫
--max-worker-lifetime-delta — adds (worker_id * delta) seconds to the max_worker_lifetime value of each worker ➕
-z|--socket-timeout — sets 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 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 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 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 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 — add a mule 🫏
--mules — adds the specified number of mules 🫏🫏
--farm — add 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 signal queue 📦
--signals-bufsize — sets buffer size for 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 pidfile before privileges drop 📝
--pidfile2 — creates pidfile after privileges drop 📝
--safe-pidfile — creates safe pidfile before privileges drop 🛡️📝
--safe-pidfile2 — creates 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 — flags this instance as jailed, which forces those post_jail hooks to actually run 🫶
--refork — does a fresh fork() after privileges drop. Jailing systems love this one ✨
--re-fork — same energy as --refork: fork() again after privileges drop. Jailing systems, this is for you 🎀
--refork-as-root — fork() again before privileges drop. Yep, still for jailing systems 💅
--re-fork-as-root — literally the same thing as --refork-as-root: another fork() before privileges drop. Jailing systems stay winning ✨
--refork-post-jail — fork() again after jailing. Jailing systems, you already know 😌
--re-fork-post-jail — the twin of --refork-post-jail: fork() again after jailing. Jailing systems 🫶

--hook-asap — run the hook you gave it as soon as possible ⚡
--hook-pre-jail — run the specified hook before jailing 🔒
--hook-post-jail — run the specified hook after jailing 🔓
--hook-in-jail — run the specified hook inside the 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 right before the app exits and reloads 🚪
--hook-pre-app — run the specified hook before the app loads 📦
--hook-post-app — run the specified hook after the app loads 🎉
--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, but 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 file you named gets 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 once 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 function/symbol you specify after every request 🔁
--after-request-call — run the function/symbol you specify after every request 🔁

--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 inside the 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 the app exits and reloads 🚪
--exec-pre-app — run the specified command before the app loads 📦
--exec-post-app — run the specified command after the app loads 🎉
--exec-as-vassal — run the specified command before exec()ing the vassal 🧚
--exec-as-emperor — run the specified command in the emperor once the vassal has been started 👑

--mount-asap — mount a filesystem as soon as possible ⚡
--mount-pre-jail — mount a filesystem before jailing 🔒
--mount-post-jail — mount a filesystem after jailing 🔓
--mount-in-jail — mount a filesystem inside the jail, after initialization 🏠
--mount-as-root — mount a filesystem before privileges drop 👑
--mount-as-vassal — mount a filesystem before exec()ing the vassal 🧚
--mount-as-emperor — mount a filesystem in the emperor once the vassal has been started 👑
--umount-asap — unmount a filesystem as soon as possible ⚡
--umount-pre-jail — unmount a filesystem before jailing 🔒
--umount-post-jail — unmount a filesystem after jailing 🔓
--umount-in-jail — unmount a filesystem inside the jail, after initialization 🏠
--umount-as-root — unmount a filesystem before privileges drop 👑
--umount-as-vassal — unmount a filesystem before exec()ing the vassal 🧚
--umount-as-emperor — unmount a filesystem in the emperor once the vassal has been started 👑

--wait-for-interface — wait for the network interface you named to come up before running root hooks 🌐
--wait-for-interface-timeout — set the timeout for wait-for-interface ⏳
--wait-interface — wait for the network interface you named to come up before running root hooks 🌐
--wait-interface-timeout — set the timeout for wait-for-interface ⏳
--wait-for-iface — wait for the network interface you named to come up before running root hooks 🌐
--wait-for-iface-timeout — set the timeout for wait-for-interface ⏳
--wait-iface — wait for the network interface you named to come up before running root hooks 🌐
--wait-iface-timeout — set the timeout for wait-for-interface ⏳
--wait-for-fs — wait for the filesystem item you named to appear before running root hooks 📁
--wait-for-file — wait for the file you named to appear before running root hooks 📄
--wait-for-dir — wait for the directory you named to appear before running root hooks 📂
--wait-for-mountpoint — wait for the mountpoint you named 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 socket you named to be ready before loading apps 🔌
--wait-for-socket-timeout — set the timeout for wait-for-socket ⏳

--call-asap — call the specified function as soon as possible ⚡
--call-pre-jail — call the specified function before jailing 🔒
--call-post-jail — call the specified function after jailing 🔓
--call-in-jail — call the specified function inside the 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 the app exits and reloads 🚪
--call-pre-app — call the specified function before the app loads 📦
--call-post-app — call the specified function after the app loads 🎉
--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 once the vassal has been started 👑
--call-as-emperor1 — call the specified function(char *) in the emperor once the vassal has been started 👑
--call-as-emperor2 — call the specified function(char *, pid_t) in the emperor once the vassal has been started 👑
--call-as-emperor4 — call the specified function(char *, pid_t, uid_t, gid_t) in the emperor once the vassal has been started 👑

--ini — load config from an ini file 📄
-y / --yaml — load config from a yaml file 💛
-y / --yml — load config from a yaml file 💛
-j / --json — load config from a json file 🧾
-j / --js — load config from a json file 🧾

--weight — the weight of this instance (used by clustering/lb/subscriptions) ⚖️
--auto-weight — set this instance's weight automatically (used by clustering/lb/subscriptions) 🤖
--no-server — force no-server mode 🚫
--command-mode — force command mode 🕹️
--no-defer-accept — turn off deferred-accept on sockets 🙅
--tcp-nodelay — enable TCP NODELAY on every 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 shutdown() to be called in addition to close() when sockets get destroyed 🔌

--limit-as — limit the processes' address space / vsz 📏
--limit-nproc — limit how many processes can be spawned 🧮
--reload-on-as — reload if the address space climbs higher than the megabytes you specified 🔁
--reload-on-rss — reload if the rss memory climbs higher than the megabytes you specified 🔁
--evil-reload-on-as — force the master to reload a worker if its address space goes higher than the megabytes you specified 😈
--evil-reload-on-rss — force the master to reload a worker if its rss memory goes higher than the megabytes you specified 😈
--mem-collector-freq — set the memory collector frequency for when evil reloads are in play 🧹
--reload-on-fd — reload if the file descriptor you specified is ready 🔔
--brutal-reload-on-fd — brutal reload if the file descriptor you specified is ready 💀
--ksm — enable Linux KSM 🐧
--pcre-jit — enable pcre jit (if it's available) ⚡
--never-swap — lock all memory pages so nothing ever gets swapped 🚫💤
--touch-reload — reload uWSGI if the file you specified is modified/touched 👆
--touch-workers-reload — trigger a reload of (only) the workers if the file you specified is modified/touched 👆👷
--touch-mules-reload — reload mules if the file you specified is modified/touched 👆🐴
--touch-spoolers-reload — reload spoolers if the file you specified is modified/touched 👆🧵
--touch-chain-reload — trigger a chain reload if the file you specified is modified/touched 👆⛓️
--touch-logrotate — trigger logrotation if the file you specified is modified/touched 👆📜
--touch-logreopen — trigger log reopen if the file you specified is modified/touched 👆📂
--touch-exec — run a command when the file you specified is modified/touched. Syntax: file command 👆▶️
--touch-signal — lowkey surveillance vibes 💅 when the file you named gets modified or touched, uwsgi raises a signal. Syntax is file signal.
--fs-reload — when the filesystem object you point at changes, you get a graceful reload. no drama, just a soft reset ✨
--fs-brutal-reload — same energy as above but make it feral 🔥 when that filesystem object changes, it's a brutal reload. no gentle anything.
--fs-signal — raise a uwsgi signal when the filesystem object you specified gets modified. Syntax: file signal.
--check-mountpoint — if a filesystem is no longer reachable, it straight up destroys the instance 💀 super useful when you need reliable Fuse management.
--mountpoint-check — literally the same thing as --check-mountpoint: destroy the instance when a filesystem is no longer reachable, useful for reliable Fuse management. twins fr 🫶
--check-mount — yeah, it's this one again: destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management). they're giving triplets 👑
--mount-check — the fourth one bestie, and it does the exact same: destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management).
--propagate-touch — described in the source as an "over-engineering option for system with flaky signal management". it's giving "we made this for the messy ones" 💀
--limit-post — caps the request body. that's it, that's the tweet.
--no-orphans — automatically kills workers when the master dies 🪦 > heads up: this can be dangerous for availability. know the risk before you enable it.
--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. memory said "not today" 💾
--post-buffering-bufsize — sets the buffer size for read() while in post buffering mode.
--body-read-warning — sets the amount of allowed memory allocation (in megabytes) for the request body before it starts printing a warning. warning first, chaos later ⚠️
--upload-progress — turns on creation of .json files in the directory you specify while a file upload is happening. progress girlies stay informed 🌸
--no-default-app — do not fallback to the default app.
--manage-script-name — automatically rewrites SCRIPT_NAME and PATH_INFO. let it handle the admin 💅
--ignore-script-name — ignore SCRIPT_NAME. iconic "i don't see it" energy.
--catch-exceptions — reports the exception as http output. > discouraged!! use only for testing 🙈
--reload-on-exception — reloads a worker whenever 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 — turns on the metrics subsystem ✨ numbers girlies rise.
--metric — adds a custom metric.
--metric-threshold — adds a metric threshold/alarm 🚨
--metric-alarm — adds a metric threshold/alarm (yes, another name for the same vibe).
--alarm-metric — also adds a metric threshold/alarm. three names, one job, obsessed 💜
--metrics-dir — exports metrics as text files into the directory you name.
--metrics-dir-restore — restores the last value taken from the metrics dir.
--metric-dir — exports metrics as text files to the specified directory (the singular twin).
--metric-dir-restore — restores the last value taken from the metrics dir (again, singular edition).
--metrics-no-cores — disables generation of cores-related metrics.
--udp — run the udp server on the address you specify.
--stats — enables the stats server on the specified address 📊
--stats-server — enables the stats server on the specified address. same girl, different name.
--stats-http — prefixes the stats server json output with http headers.
--stats-minified — minifies the statistics json output. small and cute 🎀
--stats-min — minifies the statistics json output. (alias bestie!)
--stats-push — pushes the stats json to the destination you specify.
--stats-pusher-default-freq — sets the default frequency of stats pushers.
--stats-pushers-default-freq — sets the default frequency of stats pushers. plural, same thing 💅
--stats-no-cores — disables generation of cores-related stats.
--stats-no-metrics — do not include metrics in the stats output.
--multicast — subscribe to the multicast group you specify.
--multicast-ttl — set multicast ttl.
--multicast-loop — set multicast loop (default 1).
--master-fifo — enable the master fifo 🧚
--notify-socket — enable the notification socket.
--subscription-notify-socket — set the notification socket for subscriptions.
--legion — become a member of a legion 👑
--legion-mcast — become a member of a legion (shortcut for multicast).
--legion-node — add a node to a legion.
--legion-freq — set the frequency of legion packets.
--legion-tolerance — set the tolerance of the 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 — set the clock skew tolerance of the legion subsystem (default 60 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 a new node joining the legion.
--legion-node-left — action to call on a node leaving the legion.
--legion-quorum — set the quorum of a legion.
--legion-scroll — set the scroll of a legion.
--legion-scroll-max-size — set the max size of the legion scroll buffer.
--legion-scroll-list-max-size — set the max size of the legion scroll list buffer.
--subscriptions-sign-check — set 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 specified uid when using unix sockets credentials.
--subscriptions-credentials-check — add a directory to search for subscriptions key credentials.
--subscriptions-use-credentials — enable management of SCM_CREDENTIALS in subscriptions UNIX sockets.
--subscription-algo — set the load balancing algorithm for the subscription system.
--subscription-dotsplit — try to fallback to the next part (dot based) in the subscription key.
--subscribe-to — subscribe to the subscription server you specify.
--st — subscribe to the specified subscription server. short queen ✨
--subscribe — subscribe to the specified subscription server. (three names, one subscription, we love consistency 🫶)
--subscribe2 — subscribe to the specified subscription server using advanced keyval syntax.
--subscribe-freq — send subscription announce at the specified interval.
--subscription-tolerance — set tolerance for subscription servers.
--unsubscribe-on-graceful-reload — force the unsubscribe request even during a graceful reload.
--start-unsubscribed — configure subscriptions but do not send them (useful with master fifo).
--subscribe-with-modifier1 — force the specififed modifier1 when subscribing. (typo is theirs, not mine, iykyk 💅)
--snmp — enable the embedded snmp server.
--snmp-community — set the snmp community string.
--ssl-verbose — be verbose about SSL errors 🗣️
--ssl-verify-depth — set maximum certificate verification depth.
--sni — add an SNI-governed SSL context.
--sni-dir — check for cert/key/client_ca file in the directory you specify and create a sni/ssl context on demand. it's giving on-demand slay 💅
--sni-dir-ciphers — set ssl ciphers for the sni-dir option.
--ssl-enable3 — enable SSLv3. > insecure 😭
--ssl-enable-sslv3 — enable SSLv3. > insecure. (same warning, longer name)
--ssl-enable-tlsv1 — enable TLSv1. > insecure 😭
--ssl-option — set a raw ssl option (numeric value).
--sni-regexp — add an SNI-governed SSL context (the key is a regexp).
--ssl-tmp-dir — store ssl-related temp files in the directory you specify.
--check-interval — set the interval (in seconds) of master checks.
--forkbomb-delay — sleep for the specified number of seconds when a forkbomb is detected. nap time, but make it emergency 😴
--binary-path — force binary path.
--privileged-binary-patch — patch the uwsgi binary with a new command (before privileges drop).
--unprivileged-binary-patch — patch the uwsgi binary with a new command (after privileges drop).
--privileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments (before privileges drop).
--unprivileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments (after privileges drop).
--async — enable async mode with the number of cores you specify.
--max-fd — set maximum number of file descriptors. > requires root privileges 👑
--logto — set logfile/udp address.
--logto2 — log to the specified file or udp address after privileges drop.
--log-format — set advanced format for request logging.
--logformat — set advanced format for request logging. (the no-dash twin, we stan 🎀)
--logformat-strftime — apply strftime to logformat output.
--log-format-strftime — apply strftime to logformat output. (again: twins!)
--logfile-chown — chown logfiles.
--logfile-chmod — chmod logfiles.
--log-syslog — log to syslog.
--log-socket — send logs to the socket you specify.
--req-logger — set/append a request logger.
--logger-req — set/append a request logger. (alias, you know the drill 💜)
--logger — set/append a logger.
--logger-list — list enabled loggers 📋
--loggers-list — list enabled loggers. (plural bestie!)
--threaded-logger — offload log writing to a thread 🧵
--log-encoder — add an item in the log encoder chain.
--log-req-encoder — add an item in the log req encoder chain.
--log-drain — drain (do not show) log lines matching the regexp you specify. bye felicia 👋
--log-filter — show only the log lines matching the regexp you specify.
--log-route — log to the specified named logger if the regexp applied on the logline matches.
--log-req-route — log requests to the specified named logger 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 — bestie, instead of spinning up a whole dedicated thread for every curl-based alarm, just reuse the main alarm thread. lowkey efficient 💅
--alarm-freq — tunes the anti-loop alarm system. default is 3 seconds, so if your alarms are going feral, this is the dial.
--alarm-fd — raise the alarm you name when an fd is read for read. by default it reads 1 byte — set it to 8 for eventfd. yes this one is niche, but she's doing her best 🫶
--alarm-segfault — fire off the alarm you name the moment the segmentation fault handler runs. 😭
--segfault-alarm — same thing, different spelling: raise the specified alarm when the segfault handler is executed.
--alarm-backlog — raise the specified alarm when the socket backlog queue is full. she's telling you before things get ugly.
--backlog-alarm — the same deal, alias edition: raise the specified alarm when the socket backlog queue is full.
--lq-alarm — raise the specified alarm when the socket backlog queue is full. (lq = listen queue, iykyk)
--alarm-lq — same energy, flipped name: alarm when the socket backlog queue is full.
--alarm-listen-queue — raise the specified alarm when the socket backlog queue is full. spelled all the way out for the girlies who like clarity ✨
--listen-queue-alarm — and again, reversed: raise the specified alarm when the socket backlog queue is full.
--log-alarm — raise the specified alarm when a log line matches the regexp you give. syntax: <alarm>[,alarm...] <regexp> — so you can stack multiple alarms with commas, iconic.
--alarm-log — literally the same thing with the words swapped: raise the specified alarm when a log line matches the regexp. syntax: <alarm>[,alarm...] <regexp>.
--not-log-alarm — the opposite vibe: skip the specified alarm when a log line matches the regexp. syntax: <alarm>[,alarm...] <regexp>.
--not-alarm-log — same skip behavior, name flipped: skip the specified alarm when a log line matches the regexp. syntax: <alarm>[,alarm...] <regexp>.
--alarm-list — just list out all the enabled alarms. a lil inventory moment 📋
--alarms-list — same list, plural name, list enabled alarms.
--alarm-msg-size — sets the max size of an alarm message. default 8192. no essays allowed 💀
--log-master — delegate logging to the master process. hand it off, queen 👑
--log-master-bufsize — sets the buffer size for the master logger. heads up: bigger log messages will be truncated. not a vibe but that's the rule.
--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. fresh start energy 🦋
--log-truncate — truncate the log on startup. everything before this moment? gone.
--log-maxsize — set maximum logfile size.
--log-backupname — set the logfile name to use after rotation. gotta name the old one something.
--logdate — prefix logs with a date, or with a strftime string.
--log-date — same as above: prefix logs with a date or a strftime string.
--log-prefix — prefix logs with a string of your choosing.
--log-zero — log responses that have no body. yes, the empty ones count too 🫠
--log-slow — log requests slower than the number of milliseconds you specify.
--log-4xx — log requests with a 4xx response.
--log-5xx — log requests with a 5xx response.
--log-big — log requests bigger than the size you specify.
--log-sendfile — log sendfile requests.
--log-ioerror — log requests that hit io errors. 😭
--log-micros — report response time in microseconds instead of milliseconds. precision queen 🔬
--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. do with this information what you will 🙈
--drop-after-init — run the privileges drop after plugin initialization. note: this is superseded by drop-after-apps.
--drop-after-apps — run the privileges drop after apps loading. note: this is superseded by master-as-root.
--force-cwd — force the initial working directory to the value you specify.
--binsh — override /bin/sh (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). she's shy until someone knocks 💅
--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. (same list, plural spelling)
--cheaper-list — list enabled cheapers algorithms. three names, one list, we love consistency 🎀
--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. the hard limit does not play 😤
--idle — set idle mode (put uWSGI in cheap mode after inactivity).
--die-on-idle — shutdown uWSGI when idle. dramatic exit, honestly 💀
--mount — load application under the mountpoint you specify.
--worker-mount — load application under the mountpoint in the specified worker, or after workers spawn.
--threads — run each worker in prethreaded mode with the specified number of threads.
--thread-stacksize — set threads stacksize.
--threads-stacksize — set threads stacksize.
--thread-stack-size — set threads stacksize.
--threads-stack-size — set threads stacksize. (four ways to say the same thing, and every single one of them is valid ✨)
--vhost — enable virtualhosting mode (based on the SERVER_NAME variable).
--vhost-host — enable virtualhosting mode (based on the HTTP_HOST variable).

ok bestie this is where it gets good — the routing era 🛣️✨

--route — add a route.
--route-host — add a route based on the Host header.
--route-uri — add a route based on REQUEST_URI.
--route-qs — add a route based on QUERY_STRING.
--route-remote-addr — add a route based on REMOTE_ADDR.
--route-user-agent — add a route based on HTTP_USER_AGENT.
--route-remote-user — add a route based on REMOTE_USER.
--route-referer — add a route based on HTTP_REFERER.
--route-label — add a routing label (for use with goto).
--route-if — add a route based on a condition.
--route-if-not — add a route based on a condition (negate version).
--route-run — always run the specified route action.
--final-route — add a final route.
--final-route-status — add a final route for the specified status.
--final-route-host — add a final route based on the Host header.
--final-route-uri — add a final route based on REQUEST_URI.
--final-route-qs — add a final route based on QUERY_STRING.
--final-route-remote-addr — add a final route based on REMOTE_ADDR.
--final-route-user-agent — add a final route based on HTTP_USER_AGENT.
--final-route-remote-user — add a final route based on REMOTE_USER.
--final-route-referer — add a final route based on HTTP_REFERER.
--final-route-label — add a final routing label (for use with goto).
--final-route-if — add a final route based on a condition.
--final-route-if-not — add a final route based on a condition (negate version).
--final-route-run — always run the specified final route action.
--error-route — add an error route.
--error-route-status — add an error route for the specified status.
--error-route-host — add an error route based on the Host header.
--error-route-uri — add an error route based on REQUEST_URI.
--error-route-qs — add an error route based on QUERY_STRING.
--error-route-remote-addr — add an error route based on REMOTE_ADDR.
--error-route-user-agent — add an error route based on HTTP_USER_AGENT.
--error-route-remote-user — add an error route based on REMOTE_USER.
--error-route-referer — add an error route based on HTTP_REFERER.
--error-route-label — add an error routing label (for use with goto).
--error-route-if — add an error route based on a condition.
--error-route-if-not — add an error route based on a condition (negate version).
--error-route-run — always run the specified error route action.
--response-route — add a response route.
--response-route-status — add a response route for the specified status.
--response-route-host — add a response route based on the Host header.
--response-route-uri — add a response route based on REQUEST_URI.
--response-route-qs — add a response route based on QUERY_STRING.
--response-route-remote-addr — add a response route based on REMOTE_ADDR.
--response-route-user-agent — add a response route based on HTTP_USER_AGENT.
--response-route-remote-user — add a response route based on REMOTE_USER.
--response-route-referer — add a response route based on HTTP_REFERER.
--response-route-label — add a response routing label (for use with goto).
--response-route-if — add a response route based on a condition.
--response-route-if-not — add a response route based on a condition (negate version).
--response-route-run — always run the specified response route action.
--router-list — list enabled routers.
--routers-list — list enabled routers. (same list, plural, you know the drill 💅)
--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.

websocket o'clock 🦋

--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. singular spelling, same job.
--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 default timeout for chunked input.
--clock — set a clock source. ⏰
--clock-list — list enabled clocks.
--clocks-list — lists all the enabled clocks for you, bestie ⏰✨
--add-header — automatically adds HTTP headers to the response, no manual labour required 💅
--rem-header — automatically removes the specified HTTP header from the response 🫥
--del-header — same energy as above: automatically removes the specified HTTP header from the response
--collect-header — stores the specified response header in a request var. Syntax is header var — two things, one space, that's the whole vibe 📥
--response-header-collect — stores the specified response header in a request var. Syntax: header var
--pull-header — stores the specified response header in a request var and yanks it out of the response. Syntax: header var. It's giving collect-and-delete 💀

🗂️ static files, my beloved

--check-static — checks for static files in the specified directory 📁
--check-static-docroot — checks for static files in the requested DOCUMENT_ROOT
--static-check — checks for static files in the specified directory (yes bestie, it's the same thing, the options are twins 👯)
--static-map — maps 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 — skips the specified extension from staticfile 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 — 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 will search for a gzip version 🗜️
--static-gzip-all — checks for a gzip version of all requested static files
--static-gzip-dir — checks for a gzip version of all requested static files in the specified dir/prefix
--static-gzip-prefix — 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 — 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 — sets the number of offload threads to spawn (per-worker, default 0)
--file-serve-mode — sets the static file serving mode
--fileserve-mode — sets the static file serving mode
--disable-sendfile — disables sendfile() and relies on boring read()/write() instead. So plain. So humble. 🙈
--check-cache — checks for response data in the specified cache (leave it empty for the default cache)

🔌 sockets, exec and friends

--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 a value in the specified cgroup option
--cgroup-dir-mode — sets permission for the cgroup directory (default is 700)
--namespace — runs in a new namespace under the specified rootfs
--namespace-keep-mount — keeps the specified mountpoint in your namespace
--ns — runs in a new namespace under the specified rootfs
--namespace-net — adds network namespace
--ns-net — adds network namespace
--enable-proxy-protocol — enables PROXY1 protocol support (only for http parsers)
--reuse-port — enables the REUSE_PORT flag on socket (BSD only 🐡)
--tcp-fast-open — enables the TCP_FASTOPEN flag on TCP sockets with the specified qlen value
--tcp-fastopen — enables the TCP_FASTOPEN flag on TCP sockets with the specified qlen value
--tcp-fast-open-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported
--tcp-fastopen-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported

🐝 zerg, cron and legions

--zerg — attach to a zerg server
--zerg-fallback — falls back 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 a cron command to complete
--legion-cron — adds a cron task runnable only when the instance is a lord of the specified legion 👑
--cron-legion — adds a cron task runnable only when the instance is a lord of the specified legion
--unique-legion-cron — adds a unique cron task runnable only when the instance is a lord of the specified legion
--unique-cron-legion — adds a unique cron task runnable only when the instance is a lord of the specified legion
--loop — select the uWSGI loop engine 🔁
--loop-list — lists enabled loop engines
--loops-list — lists enabled loop engines
--worker-exec — runs the specified command as worker
--worker-exec2 — runs the specified command as worker (after the 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); 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 the legion lord node 👑
--legion-smart-attach-daemon — same as --smart-attach-daemon but the daemon runs only on the legion lord node
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2 but the daemon runs only on the legion lord node
--daemons-honour-stdin — do not change the stdin of external daemons to /dev/null
--attach-daemon2 — the attach-daemon keyval variant (supports smart modes too)

🧩 plugins, because everything is a plugin

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

🛠️ introspection & dev tools

--dump-options — dumps the full list of available options
--show-config — shows the current config reformatted as ini
--binary-append-data — returns the content of a resource to stdout for appending to a uwsgi binary (for data:// usage)
--print — simple print 🖨️
--iprint — simple print (immediate version)
--exit — force exit() of the instance
--cflags — reports uWSGI CFLAGS (useful for building external plugins)
--dot-h — dumps the uwsgi.h used for building the core (useful for building external plugins)
--config-py — dumps the uwsgiconfig.py used for building the core (useful for building external plugins)
--build-plugin — builds a uWSGI plugin for the current binary
--version — prints uWSGI version
--response-headers-limit — sets the response header maximum size (default: 64k)

And that's the whole options buffet, bestie — you made it to the end 🫶✨ This page is from uwsgi_rack 2.0.31-2, dated January 2026, and it's the UWSGI_RACK(1) manual page. Go forth and configure responsibly, no cap 💅💖

📦 where this page comes from

ubuntu resolute: uwsgi-plugin-ruby 2.0.31+2+0.0.3 · GPL-3.0-or-later
ubuntu stonking: uwsgi-plugin-ruby 2.0.31+2+0.0.3 · GPL-3.0-or-later
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-18: a language model's rewrite of the original, under its terms