UWSGI_MONO(1)

📦

version 2.0.24 · 3 versions

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

👑 UWSGI_MONO 👑

okay bestie, welcome to the manual page for uwsgi_mono — she's a User Command, she lives in section 1, and she is that girl. buckle up, this page is long and we are doing it in parts. 💖

✨ NAME ✨

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

like. she's written in pure C. she heals herself. she's developer-friendly. the trinity. no cap.

🦋 SYNOPSIS 🦋

uwsgi-core-local [options...]

that's it. that's the whole summoning ritual. you give her options, she gives you a server. periodt. ✨

🌸 DESCRIPTION 🌸

okay so this is the big one — every single option, flag, and knob she has. grab a snack, we're going section by section. 🍓

🔌 SOCKETS AND PROTOCOLS

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

🧑🍳 WORKERS AND THE HARAKIRI ZONE

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

harakiri is literally the app-killing timeout bestie. three whole spellings for the same after-request-hook behaviour, she contains multitudes 💀

📜 CONFIG LOADING

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

🧠 OPT LOGIC (the if/for girlies)

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

the way she has like four aliases for every single condition?? she's giving convenience, she's giving "pick your fave spelling" 💅

✅ LISTS AND FILTERING

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

😭 WRITE ERRORS AND SIGNALS (the annoying ones)

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

default is no tolerance bestie. zero. none. she will not be ignoring your write errors unless you literally tell her to. 🔥

🚀 DAEMON AND INSTANCE MANAGEMENT

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

⚙️ CORE TUNING

-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

🔐 SOCKET OWNERSHIP AND PERMISSIONS

-a, --abstract-socket — force UNIX socket in abstract mode (Linux only) 🐧
-C, --chmod-socket — chmod-socket
-C, --chmod — chmod-socket
--chown-socket — chown unix sockets
--umask — set umask
--freebind — put socket in freebind mode
--map-socket — map sockets to specific workers

🧵 THREADS AND PROCESS NAMES

-T, --enable-threads — enable threads
--no-threads-wait — do not wait for threads cancellation on quit/reload
--auto-procname — automatically set processes name to something meaningful
--procname-prefix — add a prefix to the process names
--procname-prefix-spaced — add a spaced prefix to the process names
--procname-append — append a string to process names
--procname — set process names
--procname-master — set master process name

👑 APP LOADING AND THE MASTER

-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 (her royal era)

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

the Emperor scans every 3 seconds by default and she is not following your symlinks unless you say otherwise. main character energy fr fr 🎀

--emperor-tyrant — flips the Emperor into Tyrant mode 👑 the vassals are NOT gonna like this one bestie
--emperor-tyrant-nofollow — in Tyrant mode, don't follow symlinks when it's checking for uid/gid. no sneaky link-following 🚫
--emperor-stats — run the Emperor stats server ✨ numbers go brrr
--emperor-stats-server — same thing, same energy, run the Emperor stats server 💖
--early-emperor — spawn the emperor as soon as possibile (yes, that's the original spelling, I'm not touching it 💅)
--emperor-broodlord — run the emperor in BroodLord mode 🦋 it's giving main character boss energy fr fr
--emperor-throttle — set the throttling level (in milliseconds) for bad behaving vassals, default 1000 ⏱️ misbehave and you get slowed down, periodt
--emperor-max-throttle — set the max throttling level (in milliseconds) for bad behaving vassals, default is 3 minutes 😤 the ceiling of the time-out zone
--emperor-magic-exec — prefixes vassals' config files with exec:// if they have the executable bit set 🪄
--emperor-on-demand-extension — search for a text file (vassal name + extension) containing the on demand socket name 🔍
--emperor-on-demand-ext — literally the same: search for a text file (vassal name + extension) holding 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 — same deal: enable 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 — yep, same: allows the specified extension in the Emperor (vassal called with --config) 💜
--emperor-no-blacklist — disables the Emperor blacklisting subsystem 🙈 no more naughty list
--emperor-use-clone — use clone() instead of fork(), passing the specified unshare() flags 🧬
--emperor-graceful-shutdown — use vassals graceful shutdown during ragnarok 💀 because even the end of the world deserves manners
--emperor-cap — set vassals capability 🔐
--vassals-cap — set vassals capability (same thing, different flag, iconic) 🔐
--vassal-cap — set vassals capability (yes bestie, a third spelling, we love options) 🔐
--imperial-monitor-list — list enabled imperial monitors 📋
--imperial-monitors-list — list enabled imperial monitors (the plural sibling 💅)
--vassals-inherit — add config templates to vassals config (uses --inherit) 🌸
--vassals-include — include config templates to vassals config (uses --include instead of --inherit) 🦋
--vassals-inherit-before — add config templates to vassals config (uses --inherit, parses before the vassal file) ⏮️
--vassals-include-before — include config templates to vassals config (uses --include instead of --inherit, parses before the vassal file) ⏮️
--vassals-start-hook — run the specified command before each vassal starts 🏁
--vassals-stop-hook — run the specified command after vassal's death 🪦
--vassal-sos — ask the emperor for reinforcement when overloaded 🆘
--vassal-sos-backlog — ask the emperor for sos if the backlog queue has more items than the value specified 📈
--vassals-set — automatically set the specified option (via --set) for every vassal 🫡
--vassal-set — automatically set the specified option (via --set) for every vassal (singular twin ✨)
--heartbeat — announce healthiness to the emperor 💓 "not dead yet bestie!"
--reload-mercy — set the max time (in seconds) we wait for workers and other processes to die during reload/shutdown 🕰️
--worker-reload-mercy — set the max time (in seconds) a worker can take to reload/shutdown, default is 60 😮‍💨
--mule-reload-mercy — set the max time (in seconds) a mule can take to reload/shutdown, default is 60 🐴
--exit-on-reload — force exit even if a reload is requested 🚪 bye
--die-on-term — exit instead of brutal reload on SIGTERM ⚰️
--force-gateway — force the spawn of the first registered gateway without a master 🔥
-h|--help — show this help 🫶
-h|--usage — show this help (same flag, same help, we're consistent here) 💖
--print-sym — print content of the specified binary symbol 🔎
--print-symbol — print content of the specified binary symbol (the long-form twin 💅)
-r|--reaper — call waitpid(-1,...) after each request to get rid of zombies 🧟 no cap, zombie apocalypse cancelled
-R|--max-requests — reload workers after the specified amount of managed requests 🔄
--min-worker-lifetime — number of seconds a worker must run before being reloaded, default is 60 ⏳
--max-worker-lifetime — reload workers after the specified amount of seconds, default is disabled ⌛
--max-worker-lifetime-delta — add (worker_id * delta) seconds to the max_worker_lifetime value of each worker ➕
-z|--socket-timeout — set internal sockets timeout ⏲️
--no-fd-passing — disable file descriptor passing 🚫
--locks — create the specified number of shared locks 🔒
--lock-engine — set the lock engine ⚙️
--ftok — set the ipcsem key via ftok() for avoiding duplicates 🔑
--persistent-ipcsem — do not remove ipcsem's on shutdown 🫙 they stay
-A|--sharedarea — create a raw shared memory area of specified pages (note: it supports keyval too) 🧠
--safe-fd — do not close the specified file descriptor 🛟
--fd-safe — do not close the specified file descriptor (same vibe, other order 🎀)
--cache — create a shared cache containing given elements 🗃️
--cache-blocksize — set cache blocksize 🧱
--cache-store — enable persistent cache to disk 💾
--cache-store-sync — set frequency of sync for persistent cache 🔁
--cache-no-expire — disable auto sweep of expired items 🧹❌
--cache-expire-freq — set the frequency of cache sweeper scans, default is 3 seconds 🧹
--cache-report-freed-items — constantly report the cache item freed by the sweeper (use only for debug) 🐛
--cache-udp-server — bind the cache udp server (used only for set/update/delete) to the specified socket 📡
--cache-udp-node — send cache update/deletion to the specified cache udp server 📤
--cache-sync — copy the whole content of another uWSGI cache server on server startup 📋
--cache-use-last-modified — update the last_modified_at timestamp on every cache item modification, default is disabled 🕒
--add-cache-item — add an item in the cache ➕
--load-file-in-cache — load a static file in the cache 📂
--load-file-in-cache-gzip — load a static file in the cache with gzip compression 🗜️
--cache2 — create a new generation shared cache (keyval syntax) ✨ gen 2 slay
--queue — enable shared queue 🚶‍♀️🚶‍♀️🚶‍♀️
--queue-blocksize — set queue blocksize 🧱
--queue-store — enable persistent queue to disk 💾
--queue-store-sync — set frequency of sync for persistent queue 🔁
-Q|--spooler — run a spooler on the specified directory 🧵
--spooler-external — map spoolers requests to a spooler directory managed by an external instance 🌐
--spooler-ordered — try to order the execution of spooler tasks 🔢
--spooler-chdir — chdir() to the specified directory before each spooler task 📁
--spooler-processes — set the number of processes for spoolers 👯
--spooler-quiet — do not be verbose with spooler tasks 🤫
--spooler-max-tasks — set the maximum number of tasks to run before recycling a spooler ♻️
--spooler-harakiri — set harakiri timeout for spooler tasks ⚔️
--spooler-frequency — set spooler frequency 📶
--spooler-freq — set spooler frequency (short king 💅)
--mule — add a mule 🐴
--mules — add the specified number of mules 🐴🐴🐴
--farm — add a mule farm 🚜
--mule-msg-size — set mule message buffer size 📨
--signal — send a uwsgi signal to a server 📶
--signal-bufsize — set buffer size for signal queue 🧺
--signals-bufsize — set buffer size for signal queue (plural twin 🎀)
--signal-timer — add a timer (syntax: <signal> <seconds>) ⏰
--timer — add a timer (syntax: <signal> <seconds>) ⏰
--signal-rbtimer — add a redblack timer (syntax: <signal> <seconds>) 🌳
--rbtimer — add a redblack timer (syntax: <signal> <seconds>) 🌳
--rpc-max — maximum number of rpc slots, default: 64 🎰
-L|--disable-logging — disable request logging 🤐
--flock — lock the specified file before starting, exit if locked 🔒
--flock-wait — lock the specified file before starting, wait if locked ⏳
--flock2 — lock the specified file after logging/daemon setup, exit if locked 🔒
--flock-wait2 — lock the specified file after logging/daemon setup, wait if locked ⏳
--pidfile — create pidfile (before privileges drop) 📝
--pidfile2 — create pidfile (after privileges drop) 📝
--safe-pidfile — create safe pidfile (before privileges drop) 🛟
--safe-pidfile2 — create safe pidfile (after privileges drop) 🛟
--chroot — chroot() to the specified directory 📦
--pivot-root — pivot_root() to the specified directories (new_root and put_old must be separated with a space) 🔄
--pivot_root — pivot_root() to the specified directories (new_root and put_old must be separated with a space) 🔄 same thing, underscore edition
--uid — setuid to the specified user/uid 🪪
--gid — setgid to the specified group/gid 🪪
--add-gid — add the specified group id to the process credentials ➕
--immediate-uid — setuid to the specified user/uid IMMEDIATELY ⚡
--immediate-gid — setgid to the specified group/gid IMMEDIATELY ⚡
--no-initgroups — disable additional groups set via initgroups() 🚫
--cap — set process capability 🔐
--unshare — unshare() part of the processes and put it in a new namespace 🌌
--unshare2 — unshare() part of the processes and put it in a new namespace after rootfs change 🌌
--setns-socket — expose a unix socket returning namespace fds from /proc/self/ns 🔌
--setns-socket-skip — skip the specified entry when sending setns file descriptors ⏭️
--setns-skip — skip the specified entry when sending setns file descriptors ⏭️ (the short twin 🎀)
--setns — join a namespace created by an external uWSGI instance 🤝
--setns-preopen — open /proc/self/ns as soon as possible and cache fds 🗂️
--jailed — mark the instance as jailed (force the execution of post_jail hooks) ⛓️
--refork — fork() again after privileges drop. super handy for jailing systems 💖
--re-fork — same thing as --refork, fork() again after privileges drop. useful for jailing systems.
--refork-as-root — fork() again before privileges drop. also for jailing systems, bestie 🫶
--re-fork-as-root — fork() again before privileges drop. for jailing systems.
--refork-post-jail — fork() again after jailing. jailing systems, you know the vibe 💅
--re-fork-post-jail — fork() again after jailing. for jailing systems.

🎀 hooks: the "run this at exactly this moment" section 🎀

okay so these are all --hook-* and they're literally just when do you want your hook to fire. the timing IS the option. iconic honestly ✨

--hook-asap — run the specified hook as soon as possible ⚡
--hook-pre-jail — run the specified hook before jailing
--hook-post-jail — run the specified hook after jailing
--hook-in-jail — run the specified hook in jail after initialization
--hook-as-root — run the specified hook before privileges drop
--hook-as-user — run the specified hook after privileges drop
--hook-as-user-atexit — run the specified hook before app exit and reload
--hook-pre-app — run the specified hook before app loading
--hook-post-app — run the specified hook after app loading
--hook-post-fork — run the specified hook after each fork
--hook-accepting — run the specified hook after each worker enter 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 enter 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 send a stop message
--hook-emperor-reload — run the specified hook when the Emperor send a reload message
--hook-emperor-lost — run the specified hook when the Emperor connection is lost 😭
--hook-as-vassal — run the specified hook before exec()ing the vassal
--hook-as-emperor — run the specified hook in the emperor after the vassal has been started
--hook-as-mule — run the specified hook in each mule 🐴
--hook-as-gateway — run the specified hook in each gateway
--after-request-hook — run the specified function/symbol after each request
--after-request-call — run the specified function/symbol after each request

🌈 the exec twins 🌈

same timeline, but instead of a hook you're running a whole command. fr fr.

--exec-asap — run the specified command as soon as possible
--exec-pre-jail — run the specified command before jailing
--exec-post-jail — run the specified command after jailing
--exec-in-jail — run the specified command in jail after initialization
--exec-as-root — run the specified command before privileges drop
--exec-as-user — run the specified command after privileges drop
--exec-as-user-atexit — run the specified command before app exit and reload
--exec-pre-app — run the specified command before app loading
--exec-post-app — run the specified command after app loading
--exec-as-vassal — run the specified command before exec()ing the vassal
--exec-as-emperor — run the specified command in the emperor after the vassal has been started

💜 mount / umount: filesystem chaos, but scheduled 💜

mounting and unmounting at the exact right life stage. no cap, this is so useful.

--mount-asap — mount filesystem as soon as possible
--mount-pre-jail — mount filesystem before jailing
--mount-post-jail — mount filesystem after jailing
--mount-in-jail — mount filesystem in jail after initialization
--mount-as-root — mount filesystem before privileges drop
--mount-as-vassal — mount filesystem before exec()ing the vassal
--mount-as-emperor — mount filesystem in the emperor after the vassal has been started
--umount-asap — unmount filesystem as soon as possible
--umount-pre-jail — unmount filesystem before jailing
--umount-post-jail — unmount filesystem after jailing
--umount-in-jail — unmount filesystem in jail after initialization
--umount-as-root — unmount filesystem before privileges drop
--umount-as-vassal — unmount filesystem before exec()ing the vassal
--umount-as-emperor — unmount filesystem in the emperor after the vassal has been started

⭐ waiting era: patience is a virtue ⭐

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

🦋 call section (yes it's the same timeline again, but with functions) 🦋

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

bestie watch the arity 💀 — --call-as-vassal vs --call-as-vassal1 vs --call-as-vassal3, and --call-as-emperor vs 1 vs 2 vs 4 — the number literally tells you how many args the function takes. get the signature wrong and it's giving undefined behaviour. 💅

🍓 config loading era 🍓

--ini — load config from ini file
-y, --yaml — load config from yaml file
-y, --yml — load config from yaml file
-j, --json — load config from json file
-j, --js — load config from json file

✨ instance & mode vibes ✨

--weight — weight of the instance (used by clustering/lb/subscriptions)
--auto-weight — set weight of the instance (used by clustering/lb/subscriptions) automatically
--no-server — force no-server mode
--command-mode — force command mode

🔥 socket tuning, my beloved 🔥

--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 & reload limits (the intense part) 💀

--limit-as — limit processes address space/vsz
--limit-nproc — limit the number of spawnable processes
--reload-on-as — reload if address space is higher than specified megabytes
--reload-on-rss — reload if rss memory is higher than specified megabytes
--evil-reload-on-as — force the master to reload a worker if its address space is higher than specified megabytes
--evil-reload-on-rss — force the master to reload a worker if its rss memory is higher than specified megabytes
--mem-collector-freq — set the memory collector frequency when evil reloads are in place
--reload-on-fd — reload if the specified file descriptor is ready
--brutal-reload-on-fd — brutal reload if the specified file descriptor is ready
--ksm — enable Linux KSM
--pcre-jit — enable pcre jit (if available)
--never-swap — lock all memory pages avoiding swapping

🌸 touch: the file watcher era 🌸

poke a file, trigger a thing. the way that works is so satisfying 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)
--fs-reload — the moment that filesystem object you picked gets touched? graceful reload. clocked it, did it, no drama 💅
--fs-brutal-reload — same energy but make it brutal: filesystem object changes, instance gets the hard reload. no gentle goodbyes.
--fs-signal — raise a uwsgi signal when the filesystem object changes. syntax: file signal — yes bestie, both of them.
--check-mountpoint — if a filesystem dips and stops being reachable, this literally destroys the instance. v useful for reliable Fuse management. it's giving "if you can't find home, nobody gets home" 😭
--mountpoint-check — same thing, same destruction, different spelling. destroy the instance if a filesystem is no more reachable (great for reliable Fuse management).
--check-mount — you guessed it: destroy the instance when a filesystem is no longer reachable. Fuse stays reliable, periodt.
--mount-check — fourth alias of the same vibe: unreachable filesystem → instance destroyed. reliable Fuse management stays winning.
--propagate-touch — this is the over-engineering option for systems with flaky signal management. sometimes you just gotta over-engineer, iykyk 🫶
--limit-post — cap that request body. limit request body, that's it, that's the whole thing.
--no-orphans — if the master dies, workers get auto-killed too. heads up tho: this can be dangerous for availability. dramatic but true 💀
--prio — set processes/threads priority.
--cpu-affinity — set cpu affinity. tell those processes where to live.
--post-buffering — set size in bytes after which it'll buffer to disk instead of memory. memory is a vibe but disk is forever ✨
--post-buffering-bufsize — set buffer size for read() in post buffering mode.
--body-read-warning — set the amount of allowed memory allocation (in megabytes) for request body before it starts printing a warning at you.
--upload-progress — enable creation of .json files in the specified directory during a file upload. watch it go 📈
--no-default-app — do not fallback to default app. no safety net, no backup plan, we ball.
--manage-script-name — automatically rewrite SCRIPT_NAME and PATH_INFO. let it handle the naming, it's better at it than you.
--ignore-script-name — ignore SCRIPT_NAME. pretend it's not even there.
--catch-exceptions — report exception as http output. discouraged, bestie — use only for testing. do NOT ship this.
--reload-on-exception — reload a worker when an exception is raised. worker said "I'm out" and it means it.
--reload-on-exception-type — reload a worker when a specific exception type is raised. picky reloading, we love specificity.
--reload-on-exception-value — reload a worker when a specific exception value is raised.
--reload-on-exception-repr — reload a worker when a specific exception type+value (language-specific) is raised.
--exception-handler — add an exception handler. someone to catch the chaos 🧚
--enable-metrics — enable metrics subsystem. numbers, but make it fashion.
--metric — add a custom metric. yours, your design.
--metric-threshold — add a metric threshold/alarm.
--metric-alarm — add a metric threshold/alarm.
--alarm-metric — add a metric threshold/alarm. (three names, one job, iconic)
--metrics-dir — export metrics as text files to the specified directory.
--metrics-dir-restore — restore last value taken from the metrics dir. memory restored, main character energy 🎀
--metric-dir — export metrics as text files to the specified directory. (same deal, shorter name)
--metric-dir-restore — restore last value taken from the metrics dir.
--metrics-no-cores — disable generation of cores-related metrics. no cores, no metrics, no problem.
--udp — run the udp server on the specified address.
--stats — enable the stats server on the specified address.
--stats-server — enable the stats server on the specified address. same thing, alternate spelling bestie.
--stats-http — prefix stats server json output with http headers.
--stats-minified — minify statistics json output. smaller json, same truth ✨
--stats-min — minify statistics json output. (yes it's the alias, no we're not sorry)
--stats-push — push the stats json to the specified destination. send it 📤
--stats-pusher-default-freq — set the default frequency of stats pushers.
--stats-pushers-default-freq — set the default frequency of stats pushers. (plural, same function)
--stats-no-cores — disable generation of cores-related stats.
--stats-no-metrics — do not include metrics in stats output. metrics stay home.
--multicast — subscribe to specified multicast group.
--multicast-ttl — set multicast ttl.
--multicast-loop — set multicast loop (default 1).
--master-fifo — enable the master fifo. the master gets a lil communication tube 💅
--notify-socket — enable the notification socket.
--subscription-notify-socket — set the notification socket for subscriptions.
--legion — became a member of a legion. we're building an army, fr fr 👑
--legion-mcast — became a member of a legion (shortcut for multicast).
--legion-node — add a node to a legion.
--legion-freq — set the frequency of legion packets.
--legion-tolerance — set the tolerance of legion subsystem.
--legion-death-on-lord-error — if one of the lord hooks fails, declare itself as a dead node for the specified amount of seconds. dramatic? yes. effective? also yes.
--legion-skew-tolerance — set the clock skew tolerance of legion subsystem (default 30 seconds).
--legion-lord — action to call on Lord election. 👑
--legion-unlord — action to call on Lord dismiss.
--legion-setup — action to call on legion setup.
--legion-death — action to call on legion death (shutdown of the instance). rip 😭
--legion-join — action to call on legion join (first time quorum is reached).
--legion-node-joined — action to call on new node joining legion.
--legion-node-left — action to call node leaving legion.
--legion-quorum — set the quorum of a legion.
--legion-scroll — set the scroll of a legion.
--legion-scroll-max-size — set max size of legion scroll buffer.
--legion-scroll-list-max-size — set max size of legion scroll list buffer.
--subscriptions-sign-check — set digest algorithm and certificate directory for secured subscription system. signatures verified, trust established 🫶
--subscriptions-sign-check-tolerance — set the maximum tolerance (in seconds) of clock skew for secured subscription system.
--subscriptions-sign-skip-uid — skip signature check for the specified uid when using unix sockets credentials. special permission slip, just for that uid.
--subscriptions-credentials-check — add a directory to search for subscriptions key credentials.
--subscriptions-use-credentials — enable management of SCM_CREDENTIALS in subscriptions UNIX sockets.
--subscription-algo — set load balancing algorithm for the subscription system.
--subscription-dotsplit — try to fallback to the next part (dot based) in subscription key.
--subscribe-to — subscribe to the specified subscription server.
--st — subscribe to the specified subscription server. (short king option name)
--subscribe — subscribe to the specified subscription server.
--subscribe2 — subscribe to the specified subscription server using advanced keyval syntax. glow-up version ✨
--subscribe-freq — send subscription announce at the specified interval.
--subscription-tolerance — set tolerance for subscription servers.
--unsubscribe-on-graceful-reload — force unsubscribe request even during graceful reload. no lingering subscriptions, we're clean here 💅
--start-unsubscribed — configure subscriptions but do not send them (useful with master fifo). set it up, don't press send.
--subscribe-with-modifier1 — force the specififed modifier1 when subscribing.
--snmp — enable the embedded snmp server.
--snmp-community — set the snmp community string.
--ssl-verbose — be verbose about SSL errors. spill the tea, ssl 💀
--ssl-verify-depth — set maximum certificate verification depth.
--sni — add an SNI-governed SSL context.
--sni-dir — check for cert/key/client_ca file in the specified directory and create a sni/ssl context on demand. on-demand context creation, so efficient.
--sni-dir-ciphers — set ssl ciphers for sni-dir option.
--ssl-enable3 — enable SSLv3 (insecure). bestie. no. but here's the flag anyway.
--ssl-enable-sslv3 — enable SSLv3 (insecure). same warning, same yikes.
--ssl-enable-tlsv1 — enable TLSv1 (insecure). the vibes are bad on this one, keep it noted.
--ssl-option — set a raw ssl option (numeric value).
--sni-regexp — add an SNI-governed SSL context (the key is a regexp). regexp said "I'll handle the matching" 🧚
--ssl-tmp-dir — store ssl-related temp files in the specified directory.
--check-interval — set the interval (in seconds) of master checks.
--forkbomb-delay — sleep for the specified number of seconds when a forkbomb is detected. everyone take a lil nap, please 😭
--binary-path — force binary path.
--privileged-binary-patch — patch the uwsgi binary with a new command (before privileges drop).
--unprivileged-binary-patch — patch the uwsgi binary with a new command (after privileges drop).
--privileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments (before privileges drop).
--unprivileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments (after privileges drop).
--async — enable async mode with specified cores.
--max-fd — set maximum number of file descriptors (requires root privileges).
--logto — set logfile/udp address.
--logto2 — log to specified file or udp address after privileges drop. the sequel 🎬
--log-format — set advanced format for request logging.
--logformat — set advanced format for request logging. (same, minus the dash)
--logformat-strftime — apply strftime to logformat output.
--log-format-strftime — apply strftime to logformat output.
--logfile-chown — chown logfiles.
--logfile-chmod — chmod logfiles.
--log-syslog — log to syslog.
--log-socket — send logs to the specified socket.
--req-logger — set/append a request logger.
--logger-req — set/append a request logger. (yes, the name got flipped, it's still the same job)
--logger — set/append a logger.
--logger-list — list enabled loggers. roll call 📋
--loggers-list — list enabled loggers.
--threaded-logger — offload log writing to a thread. delegating, as one does 💅
--log-encoder — add an item in the log encoder chain.
--log-req-encoder — add an item in the log req encoder chain.
--log-drain — drain (do not show) log lines matching the specified regexp. those lines? never happened 🙈
--log-filter — show only log lines matching the specified regexp. curated feed, only the best.
--log-route — log to the specified named logger if regexp applied on logline matches.
--log-req-route — log requests to the specified named logger if regexp applied on logline matches.
--use-abort — call abort() on segfault/fpe, could be useful for generating a core dump.
--alarm — create a new alarm, syntax: <alarm> <plugin:args>. ⏰
--alarm-cheap — use main alarm thread rather than create dedicated threads for curl-based alarms. budget-friendly alarm, lowkey genius.

okay bestie we are still in the options, this list is literally never-ending and honestly? obsessed 💅 here's the next chunk, no skips, no shortcuts, every single flag accounted for 🫶

--alarm-freq — tunes the anti-loop alarm system (default 3 seconds)
--alarm-fd — raises the alarm you name whenever an fd is read for read; by default it reads 1 byte, so set 8 if you're dealing with eventfd ✨
--alarm-segfault — fires the alarm you specify when the segmentation fault handler runs 😭
--segfault-alarm — fires the alarm you specify when the segmentation fault handler runs (yep, same words, it's giving twin energy 💀)
--alarm-backlog — fires the alarm you specify when the socket backlog queue is full 🔥
--backlog-alarm — fires the alarm you specify when the socket backlog queue is full 🌸
--lq-alarm — fires the alarm you specify when the socket backlog queue is full 💖
--alarm-lq — fires the alarm you specify when the socket backlog queue is full ✨
--alarm-listen-queue — fires the alarm you specify when the socket backlog queue is full 👑
--listen-queue-alarm — fires the alarm you specify when the socket backlog queue is full 🌈
--log-alarm — fires the alarm you name whenever a log line matches your regexp; syntax: <alarm>[,alarm...] <regexp>
--alarm-log — fires the alarm you name whenever a log line matches your regexp; syntax: <alarm>[,alarm...] <regexp>
--not-log-alarm — skips the alarm you name when a log line matches your regexp; syntax: <alarm>[,alarm...] <regexp> 🙈
--not-alarm-log — skips the alarm you name when a log line matches your regexp; syntax: <alarm>[,alarm...] <regexp>
--alarm-list — lists all the enabled alarms 📋
--alarms-list — lists all the enabled alarms 📋
--alarm-msg-size — sets the max size of an alarm message (default 8192)
--log-master — delegates the logging to the master process 👑
--log-master-bufsize — sets the buffer size for the master logger; anything bigger gets truncated, so watch out ⚠️
--log-master-stream — creates the master logpipe as SOCK_STREAM
--log-master-req-stream — creates the master requests logpipe as SOCK_STREAM
--log-reopen — reopens the log after a reload 🦋
--log-truncate — truncates the log on startup
--log-maxsize — sets the maximum logfile size
--log-backupname — sets the logfile name to use after rotation
--logdate — prefixes logs with the date, or with a strftime string 🎀
--log-date — prefixes logs with the date, or with a strftime string 🎀
--log-prefix — prefixes logs with a string of your choosing
--log-zero — logs responses that have no body
--log-slow — logs any request slower than the number of milliseconds you give ⏱️
--log-4xx — logs requests with a 4xx response
--log-5xx — logs requests with a 5xx response
--log-big — logs requests bigger than the size you specify
--log-sendfile — logs sendfile requests 📦
--log-ioerror — logs requests that hit io errors 💀
--log-micros — reports response time in microseconds instead of milliseconds
--log-x-forwarded-for — uses the ip from the X-Forwarded-For header instead of REMOTE_ADDR
--master-as-root — leaves the master process running as root 👑 (big power, handle with care)
--drop-after-init — runs the privileges drop after plugin initialization; superseded by drop-after-apps
--drop-after-apps — runs the privileges drop after apps loading; superseded by master-as-root
--force-cwd — forces the initial working directory to the value you specify
--binsh — overrides /bin/sh (it's what the exec hooks use, and it always falls back to /bin/sh)
--chdir — chdirs to the specified directory before apps loading 🦋
--chdir2 — chdirs to the specified directory after apps loading 🦋
--lazy — sets lazy mode (loads apps in the workers instead of the master)
--lazy-apps — loads apps in each worker instead of the master
--cheap — sets cheap mode (workers only get spawned after the very first request 💸)
--cheaper — sets cheaper mode (that's the adaptive process spawning one)
--cheaper-initial — sets how many processes to spawn at the start in cheaper mode
--cheaper-algo — picks which algorithm gets used for the adaptive process spawning 🧠
--cheaper-step — how many extra processes to spawn at each overload
--cheaper-overload — increases workers after the overload you specify
--cheaper-algo-list — lists the enabled cheapers algorithms 📋
--cheaper-algos-list — lists the enabled cheapers algorithms 📋
--cheaper-list — lists the enabled cheapers algorithms 📋
--cheaper-rss-limit-soft — won't spawn new workers if the total resident memory usage of all workers is above this limit 🛑
--cheaper-rss-limit-hard — if the total workers resident memory usage is above this, it tries to stop workers 😬
--idle — sets idle mode (puts uWSGI back into cheap mode after some inactivity)
--die-on-idle — shuts uWSGI down when it goes idle 💀
--mount — loads an application under a mountpoint
--worker-mount — loads an application under a mountpoint in the worker you name, or after workers spawn
--threads — runs each worker in prethreaded mode with the number of threads you specify 🧵
--thread-stacksize — sets the threads stacksize
--threads-stacksize — sets the threads stacksize
--thread-stack-size — sets the threads stacksize
--threads-stack-size — sets the threads stacksize
--vhost — enables virtualhosting mode (it keys off the SERVER_NAME variable) 🌐
--vhost-host — enables virtualhosting mode (it keys off the HTTP_HOST variable) 🌐
--route — adds a route
--route-host — adds a route based on the Host header
--route-uri — adds a route based on REQUEST_URI
--route-qs — adds a route based on QUERY_STRING
--route-remote-addr — adds a route based on REMOTE_ADDR
--route-user-agent — adds a route based on HTTP_USER_AGENT
--route-remote-user — adds a route based on REMOTE_USER
--route-referer — adds a route based on HTTP_REFERER
--route-label — adds a routing label (for use with goto) 🏷️
--route-if — adds a route based on a condition
--route-if-not — adds a route based on a condition, but the negate version 🙃
--route-run — always runs the route action you specify
--final-route — adds a final route
--final-route-status — adds a final route for the status you specify
--final-route-host — adds a final route based on the Host header
--final-route-uri — adds a final route based on REQUEST_URI
--final-route-qs — adds a final route based on QUERY_STRING
--final-route-remote-addr — adds a final route based on REMOTE_ADDR
--final-route-user-agent — adds a final route based on HTTP_USER_AGENT
--final-route-remote-user — adds a final route based on REMOTE_USER
--final-route-referer — adds a final route based on HTTP_REFERER
--final-route-label — adds a final routing label (for use with goto) 🏷️
--final-route-if — adds a final route based on a condition
--final-route-if-not — adds a final route based on a condition, negate version 🙃
--final-route-run — always runs the final route action you specify
--error-route — adds an error route
--error-route-status — adds an error route for the status you specify
--error-route-host — adds an error route based on the Host header
--error-route-uri — adds an error route based on REQUEST_URI
--error-route-qs — adds an error route based on QUERY_STRING
--error-route-remote-addr — adds an error route based on REMOTE_ADDR
--error-route-user-agent — adds an error route based on HTTP_USER_AGENT
--error-route-remote-user — adds an error route based on REMOTE_USER
--error-route-referer — adds an error route based on HTTP_REFERER
--error-route-label — adds an error routing label (for use with goto) 🏷️
--error-route-if — adds an error route based on a condition
--error-route-if-not — adds an error route based on a condition, negate version 🙃
--error-route-run — always runs the error route action you specify
--response-route — adds a response route
--response-route-status — adds a response route for the status you specify
--response-route-host — adds a response route based on the Host header
--response-route-uri — adds a response route based on REQUEST_URI
--response-route-qs — adds a response route based on QUERY_STRING
--response-route-remote-addr — adds a response route based on REMOTE_ADDR
--response-route-user-agent — adds a response route based on HTTP_USER_AGENT
--response-route-remote-user — adds a response route based on REMOTE_USER
--response-route-referer — adds a response route based on HTTP_REFERER
--response-route-label — adds a response routing label (for use with goto) 🏷️
--response-route-if — adds a response route based on a condition
--response-route-if-not — adds a response route based on a condition, negate version 🙃
--response-route-run — always runs the response route action you specify
--router-list — lists the enabled routers 📋
--routers-list — lists the enabled routers 📋
--error-page-403 — adds an error page (html) for the managed 403 response
--error-page-404 — adds an error page (html) for the managed 404 response
--error-page-500 — adds an error page (html) for the managed 500 response
--websockets-ping-freq — sets how often (in seconds) websockets automatic ping packets go out 🏓
--websocket-ping-freq — sets how often (in seconds) websockets automatic ping packets go out 🏓
--websockets-pong-tolerance — sets the tolerance (in seconds) of the websockets ping/pong subsystem
--websocket-pong-tolerance — sets the tolerance (in seconds) of the websockets ping/pong subsystem
--websockets-max-size — sets the max allowed size of websocket messages (in Kbytes, default 1024)
--websocket-max-size — sets the max allowed size of websocket messages (in Kbytes, default 1024)
--chunked-input-limit — sets the max size of a chunked input part (default 1MB, in bytes)
--chunked-input-timeout — sets the default timeout for chunked input ⏱️
--clock — sets a clock source
--clock-list — lists the enabled clocks 📋
--clocks-list — lists the enabled clocks 📋
--add-header — automatically adds HTTP headers to your response 💌

and bestie… we are STILL not done, the options keep coming, stay with me 🧚

--rem-header — auto-yeets a specified HTTP header off the response, no cap 💅
--del-header — same energy as --rem-header: automatically removes the specified HTTP header from the response
--collect-header — stashes the specified response header into a request var (syntax: header var) 🎀
--response-header-collect — also stashes the specified response header into a request var (syntax: header var)
--pull-header — stashes the specified response header in a request var and rips it out of the response (syntax: header var)
--check-static — looks for static files in the directory you give it 🦋
--check-static-docroot — looks for static files in the requested DOCUMENT_ROOT
--static-check — looks for static files in the specified directory (yes bestie, it's the same vibe as --check-static)
--static-map — maps a mountpoint to a static directory (or a single file)
--static-map2 — like --static-map except it completely appends the requested resource onto the docroot ✨
--static-skip-ext — skips the specified extension when it's doing staticfile checks
--static-index — if someone asks for a directory, it goes searching for the specified file 👑
--static-safe — skips the security checks when the file lives under the specified path
--static-cache-paths — drops resolved paths into 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 a filename regexp
--static-expires-mtime — sets the Expires header based on a filename regexp and file mtime
--static-expires-uri — sets the Expires header based on a REQUEST_URI regexp
--static-expires-uri-mtime — sets the Expires header based on a REQUEST_URI regexp and file mtime
--static-expires-path-info — sets the Expires header based on a PATH_INFO regexp
--static-expires-path-info-mtime — sets the Expires header based on a PATH_INFO regexp and file mtime
--static-gzip — if the regexp you supplied matches the static file translation, it'll go hunt for a gzip version 🔥
--static-gzip-all — checks for a gzip version of every static file that gets requested
--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 — turns on support for the HTTP Range header 🫶
--offload-threads — sets how many offload threads to spawn (per-worker, default 0)
--offload-thread — sets how many offload threads to spawn (per-worker, default 0)
--file-serve-mode — sets the static file serving mode
--fileserve-mode — sets the static file serving mode
--disable-sendfile — disables sendfile() and makes it rely on boring old read()/write() 😭
--check-cache — checks for response data in the specified cache (leave it empty for the default cache)
--close-on-exec — sets close-on-exec on connection sockets (could be required if you're spawning processes inside requests)
--close-on-exec2 — sets close-on-exec on server sockets (could be required if you're spawning processes inside requests)
--mode — set uWSGI custom mode
--env — set environment variable
--envdir — loads a daemontools compatible envdir
--early-envdir — loads 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 the 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 — run in a new namespace under the specified rootfs
--namespace-net — adds a network namespace
--ns-net — adds a network namespace
--enable-proxy-protocol — enables PROXY1 protocol support (only for http parsers)
--reuse-port — enables the REUSE_PORT flag on the socket (BSD only, bestie, don't come for me)
--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 it's supported
--tcp-fastopen-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if it's supported
--zerg — attach to a zerg server 👾
--zerg-fallback — falls back to normal sockets if the zerg server isn't available
--zerg-server — enables the zerg server on the specified UNIX socket
--cron — add a cron task ⏰
--cron2 — add a cron task (key=val syntax)
--unique-cron — add a unique cron task
--cron-harakiri — sets the maximum time (in seconds) we wait for a cron command to complete
--legion-cron — add a cron task that's only runnable when the instance is a lord of the specified legion 👑
--cron-legion — add a cron task that's only runnable when the instance is a lord of the specified legion
--unique-legion-cron — add a unique cron task that's only runnable when the instance is a lord of the specified legion
--unique-cron-legion — add a unique cron task that's only runnable when the instance is a lord of the specified legion
--loop — select the uWSGI loop engine 🔄
--loop-list — list enabled loop engines
--loops-list — list enabled loop engines
--worker-exec — run the specified command as worker
--worker-exec2 — run the specified command as worker (after 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), 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 only runs on the legion lord node
--legion-smart-attach-daemon — same as --smart-attach-daemon but the daemon only runs on the legion lord node
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2 but the daemon only runs on the legion lord node
--daemons-honour-stdin — does not change the stdin of external daemons to /dev/null
--attach-daemon2 — the attach-daemon keyval variant (supports smart modes too)
--plugins — load uWSGI plugins 🧩
--plugin — load uWSGI plugins
--need-plugins — load uWSGI plugins (exit on error)
--need-plugin — load uWSGI plugins (exit on error)
--plugins-dir — add a directory to the uWSGI plugin search path
--plugin-dir — add a directory to the uWSGI plugin search path
--plugins-list — list enabled plugins
--plugin-list — list enabled plugins
--autoload — tries to automatically load plugins when unknown options are found 🔍
--dlopen — blindly loads a shared library (no thoughts, head empty)
--allowed-modifiers — comma separated list of allowed modifiers
--remap-modifier — remaps a request modifier from one id to another
--dump-options — dumps the full list of available options
--show-config — shows the current config reformatted as ini
--binary-append-data — returns the content of a resource to stdout 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 — sets the response header maximum size (default: 64k)

💜 the mono era 💜

okay so this whole lil cluster is the Mono plugin's moment to shine, asp.net besties rise up 🎀

--mono-app — load a Mono asp.net app from the specified directory
--mono-gc-freq — run the Mono GC every <n> requests (default: run after every request)
--mono-key — select the ApplicationHost based on the specified CGI var
--mono-version — set the Mono jit version
--mono-config — set the Mono config file
--mono-assembly — load the specified main assembly (default: uwsgi.dll)
--mono-exec — exec the specified assembly just before app loading
--mono-index — add an asp.net index file 🌈

and that's a wrap on UWSGI_MONO(1) bestie, we did it, we read the entire thing 🫶 this page came from uWSGI version 2.0.24-debian, dated April 2024, and it's filed under UWSGI_MONO(1). go forth and serve those asp.net apps, you absolute icon 💅✨

📦 where this page comes from

ubuntu noble: uwsgi-plugin-mono 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