UWSGI_XSLT(1)

📦

version 2.0.31 · 7 versions

✨ NAME ✨

uwsgi_xslt — fast (pure C), self-healing, developer-friendly WSGI server. And yes bestie, this is the man page for uwsgi_xslt in section 1 (User Commands) 💅

🦋 SYNOPSIS 🦋

uwsgi-core [options...]

💖 DESCRIPTION 💖

Okay so listen, this page is a whole buffet of options. We're gonna go through every single one, no skips, no cap. Let's get into it 👑

-s, --socket — binds to the UNIX/TCP socket you specify, using the default protocol 💅
-s, --uwsgi-socket — binds to the UNIX/TCP socket you specify, using the uwsgi protocol 🦋
--suwsgi-socket — binds to the UNIX/TCP socket you specify, using the uwsgi protocol over SSL 🔒
--ssl-socket — binds to the UNIX/TCP socket you specify, using the uwsgi protocol over SSL 🔒
--http-socket — binds to the UNIX/TCP socket you specify, using HTTP protocol 🌐
--http-socket-modifier1 — forces the specified modifier1 when using HTTP protocol 1️⃣
--http-socket-modifier2 — forces the specified modifier2 when using HTTP protocol 2️⃣
--http11-socket — binds to the UNIX/TCP socket you specify, using HTTP 1.1 (Keep-Alive) protocol 🔄
--https-socket — binds to the UNIX/TCP socket you specify, using HTTPS protocol 🔐
--https-socket-modifier1 — forces the specified modifier1 when using HTTPS protocol 1️⃣
--https-socket-modifier2 — forces the specified modifier2 when using HTTPS protocol 2️⃣
--fastcgi-socket — binds to the UNIX/TCP socket you specify, using FastCGI protocol ⚡
--fastcgi-nph-socket — binds to the UNIX/TCP socket you specify, using FastCGI protocol (nph mode) ⚡
--fastcgi-modifier1 — forces the specified modifier1 when using FastCGI protocol 1️⃣
--fastcgi-modifier2 — forces the specified modifier2 when using FastCGI protocol 2️⃣
--scgi-socket — binds to the UNIX/TCP socket you specify, using SCGI protocol 🐍
--scgi-nph-socket — binds to the UNIX/TCP socket you specify, using SCGI protocol (nph mode) 🐍
--scgi-modifier1 — forces the specified modifier1 when using SCGI protocol 1️⃣
--scgi-modifier2 — forces the specified modifier2 when using SCGI protocol 2️⃣
--raw-socket — binds to the UNIX/TCP socket you specify, using RAW protocol 🥩
--raw-modifier1 — forces the specified modifier1 when using RAW protocol 1️⃣
--raw-modifier2 — forces the specified modifier2 when using RAW protocol 2️⃣
--puwsgi-socket — binds to the UNIX/TCP socket you specify, using persistent uwsgi protocol (puwsgi) 🔁
--protocol — forces the specified protocol for default sockets 📡
--socket-protocol — forces the specified protocol for default sockets 📡
--shared-socket — creates a shared socket for advanced jailing or ipc 🔗
--undeferred-shared-socket — creates a shared socket for advanced jailing or ipc (undeferred mode) 🔗
-p, --processes — spawns the specified number of workers/processes 👯
-p, --workers — spawns the specified number of workers/processes 👯
--thunder-lock — serializes accept() usage (if possible) ⚡
-t, --harakiri — sets the harakiri timeout ⏰
--harakiri-verbose — enables verbose mode for harakiri 🗣️
--harakiri-graceful-timeout — the interval between a graceful harakiri attempt and a sigkill ⏳
--harakiri-graceful-signal — uses this signal instead of sigterm for graceful harakiri attempts 🚦
--harakiri-queue-threshold — only triggers harakiri if the queue is greater than this threshold 📊
--harakiri-no-arh — does not enable harakiri during after-request-hook 🚫
--no-harakiri-arh — does not enable harakiri during after-request-hook 🚫
--no-harakiri-after-req-hook — does not enable harakiri during after-request-hook 🚫
--backtrace-depth — sets the backtrace depth 🔍
--mule-harakiri — sets the harakiri timeout for mule tasks 🐴
-x, --xmlconfig — loads config from an xml file 📄
-x, --xml — loads config from an xml file 📄
--config — loads configuration using the pluggable system 🔌
--fallback-config — re-execs uwsgi with the specified config when the exit code is 1 🔄
--strict — enables strict mode (placeholder cannot be used) 🚫
--skip-zero — skips check of file descriptor 0 0️⃣
--skip-atexit — skips atexit hooks (ignored by the master) 🚪
--skip-atexit-teardown — skips atexit teardown (ignored by the master) 🧹
-S, --set — sets a placeholder or an option 🎯
--set-placeholder — sets a placeholder 📌
--set-ph — sets a placeholder 📌
--get — prints the specified option value and exits 📤
--declare-option — declares a new uWSGI custom option 🆕
--declare-option2 — declares a new uWSGI custom option (non-immediate) 🆕
--resolve — places the result of a dns query in the specified placeholder, syntax: placeholder=name (immediate option) 🌐
--for — (opt logic) for cycle 🔁
--for-glob — (opt logic) for cycle (expand glob) 🔁
--for-times — (opt logic) for cycle (expand the 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 ⚫
--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() 🚫
--inherit — use the specified file as a 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) 💉
-d, --daemonize — daemonize uWSGI 👻
--daemonize2 — daemonize uWSGI after app loading 👻
--stop — stop an instance 🛑
--reload — reload an instance 🔄
--pause — pause an instance ⏸️
--suspend — suspend an instance ⏸️
--resume — resume an instance ▶️
--connect-and-read — connect to a socket and wait for data from it 🔌
--extract — fetch/dump any supported address to stdout 📤
-l, --listen — set the socket listen queue size 📏
-v, --max-vars — set the amount of internal iovec/vars structures 📊
--max-apps — set the maximum number of per-worker applications 📱
-b, --buffer-size — set internal buffer size 📦
-m, --memory-report — enable memory report 🧠
--profiler — enable the specified profiler 📈
-c, --cgi-mode — force CGI-mode for plugins supporting it 🖥️
-a, --abstract-socket — force UNIX socket in abstract mode (Linux only) 🐧
-C, --chmod-socket — chmod-socket 🔧
-C, --chmod — chmod-socket 🔧
--chown-socket — chown unix sockets 👤
--umask — set umask 🎭
--freebind — put socket in freebind mode 🆓
--map-socket — map sockets to specific workers 🗺️
-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) 1️⃣
--need-app — exit if no app can be loaded 🚪
-M, --master — enable master process 👑
--honour-stdin — do not remap stdin to /dev/null 🙏
--emperor — run the Emperor 👑
--emperor-proxy-socket — force the vassal to became an Emperor proxy 🔀
--emperor-wrapper — set a binary wrapper for vassals 📦
--emperor-wrapper-override — set a binary wrapper for vassals to try before the default one 🔄
--emperor-wrapper-fallback — set a binary wrapper for vassals to try as a last resort 🆘
--emperor-nofollow — do not follow symlinks when checking for mtime 🚫
--emperor-procname — set the Emperor process name 👑
--emperor-freq — set the Emperor scan frequency (default 3 seconds) ⏱️
--emperor-required-heartbeat — set the Emperor tolerance about heartbeats 💓
--emperor-curse-tolerance — set the Emperor tolerance about cursed vassals 🧙
--emperor-pidfile — drops the Emperor's pid into the file you point at, bestie. 💖
--emperor-tyrant — flips the Emperor straight into Tyrant mode. it's giving supreme overlord energy 👑
--emperor-tyrant-nofollow — in Tyrant mode, when it's checking uid/gid, it will not follow symlinks. no sneaky shortcuts, periodt.
--emperor-stats — spins up the Emperor stats server 📊
--emperor-stats-server — same thing, also runs the Emperor stats server (yes, it's a twin, we love that for it)
--early-emperor — spawns the emperor as early as possible, because why wait ✨
--emperor-broodlord — runs the emperor in BroodLord mode 🦋 (scary name, iconic feature)
--emperor-throttle — sets the throttling level in milliseconds for vassals that are acting up (default 1000)
--emperor-max-throttle — the ceiling for that throttling, in milliseconds, for bad-behaving vassals (default 3 minutes)
--emperor-magic-exec — if a vassal's config file has the executable bit set, it gets prefixed with exec://. magic ✨
--emperor-on-demand-extension — looks for a text file named (vassal name + your extension) that holds the on-demand socket name 🔍
--emperor-on-demand-ext — literally the same thing, shorter name for the same lookup
--emperor-on-demand-directory — turns on on-demand mode and binds to the unix socket inside the directory you specify, named like the vassal + .socket
--emperor-on-demand-dir — the short version of that exact same behaviour 💅
--emperor-on-demand-exec — uses the output of the command you give as the on-demand socket name (the vassal name is handed over as the only argument)
--emperor-extra-extension — lets the Emperor accept the extension you specify; vassals get called with --config
--emperor-extra-ext — same deal, abbreviated 🎀
--emperor-no-blacklist — kills the Emperor blacklisting subsystem entirely, no cap
--emperor-use-clone — uses clone() instead of fork() and passes along the unshare() flags you specify
--emperor-graceful-shutdown — vassals get a graceful shutdown during ragnarok 🌈 (yes, that's what it's called)
--emperor-cap — sets the vassals capability
--vassals-cap — sets the vassals capability (same thing, different spelling, we stan variety)
--vassal-cap — yep, sets the vassals capability. three names, one job 😭
--imperial-monitor-list — lists the imperial monitors that are enabled 👀
--imperial-monitors-list — the pluralized twin of that, same listing
--vassals-inherit — adds config templates to the vassals config, via --inherit 📎
--vassals-include — includes config templates into the vassals config, using --include instead of --inherit
--vassals-inherit-before — adds config templates to the vassals config using --inherit, parsed before the vassal file ⏮️
--vassals-include-before — includes config templates into the vassals config using --include instead of --inherit, parsed before the vassal file
--vassals-start-hook — runs your command before each vassal starts 🏁
--vassals-stop-hook — runs your command after a vassal's death 💀
--vassal-sos — when a vassal is overloaded, it asks the emperor for reinforcement 🆘
--vassal-sos-backlog — sends that SOS if the backlog queue has more items than the value you specify
--vassals-set — automatically sets the option you give (via --set) for every single vassal
--vassal-set — same energy, same behaviour, one fewer letter
--heartbeat — announces healthiness to the emperor 💓
--reload-mercy — the max time in seconds we're willing to wait for workers and other processes to die during reload/shutdown
--worker-reload-mercy — how long a single worker gets to reload/shutdown, in seconds (default is 60)
--mule-reload-mercy — how long a mule gets to reload/shutdown, in seconds (default is 60) 🐴
--exit-on-reload — forces an exit even if a reload was requested. dramatic, but okay
--die-on-term — on SIGTERM it exits instead of doing a brutal reload
--force-gateway — forces the spawn of the first registered gateway, without a master
-h, --help — shows this help 🫶
-h, --usage — also shows this help (same flag, same help, love that for us)
--print-sym — prints the content of the binary symbol you specify
--print-symbol — prints the content of the specified binary symbol (again, two names, one vibe)
-r, --reaper — calls waitpid(-1,...) after every request so zombies get cleaned up 🧟‍♀️✨
-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 — the number of seconds a worker has to run before it's allowed to be reloaded (default is 10)
--max-worker-lifetime — reloads workers after the number of seconds you specify (default is disabled)
--max-worker-lifetime-delta — adds (worker_id * delta) seconds to the max_worker_lifetime value of each worker
-z, --socket-timeout — sets the internal sockets timeout ⏱️
--no-fd-passing — disables file descriptor passing
--locks — creates the number of shared locks you specify 🔒
--lock-engine — sets the lock engine
--ftok — sets the ipcsem key via ftok() so you avoid duplicates
--persistent-ipcsem — does not remove ipcsem's on shutdown
-A, --sharedarea — creates a raw shared memory area of the number of pages you specify (note: it supports keyval too)
--safe-fd — don't close the file descriptor you specify, keep it safe 🛡️
--fd-safe — same thing, do not close the specified file descriptor
--cache — creates a shared cache containing the given elements
--cache-blocksize — sets the cache blocksize
--cache-store — enables persistent cache to disk 💾
--cache-store-sync — sets how often the persistent cache syncs
--cache-no-expire — disables the auto sweep of expired items 🧹
--cache-expire-freq — sets how often the cache sweeper scans (default 3 seconds)
--cache-report-freed-items — constantly reports cache items freed by the sweeper. btw, use only for debug 🙈
--cache-udp-server — binds the cache udp server (used only for set/update/delete) to the socket you specify
--cache-udp-node — sends cache update/deletion over to the cache udp server you specify 📡
--cache-sync — copies the entire content of another uWSGI cache server when this server starts up
--cache-use-last-modified — updates the last_modified_at timestamp on every cache item modification (default is disabled)
--add-cache-item — adds an item into the cache
--load-file-in-cache — loads a static file into the cache 📂
--load-file-in-cache-gzip — loads a static file into the cache, gzip-compressed
--cache2 — creates a new generation shared cache (keyval syntax) ✨
--queue — enables the shared queue
--queue-blocksize — sets the queue blocksize
--queue-store — enables persistent queue to disk
--queue-store-sync — sets how often the persistent queue syncs
-Q, --spooler — runs a spooler on the directory you specify
--spooler-external — maps spooler requests to a spooler directory that's managed by an external instance
--spooler-ordered — tries to order the execution of spooler tasks 🔢
--spooler-chdir — chdir()s into the directory you specify before each spooler task
--spooler-processes — sets the number of processes for spoolers
--spooler-quiet — no being verbose about spooler tasks, shhh 🤫
--spooler-max-tasks — the maximum number of tasks to run before recycling a spooler
--spooler-harakiri — sets the harakiri timeout for spooler tasks
--spooler-frequency — sets the spooler frequency
--spooler-freq — sets the spooler frequency (short king version)
--mule — adds a mule 🐴
--mules — adds the number of mules you specify
--farm — adds a mule farm 🚜 (yes, really)
--mule-msg-size — sets the mule message buffer size
--signal — sends a uwsgi signal to a server
--signal-bufsize — sets the buffer size for the signal queue
--signals-bufsize — sets the buffer size for the signal queue (same, with an extra s)
--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 — the maximum number of rpc slots (default: 64)
-L, --disable-logging — disables request logging. quiet luxury 💅
--flock — locks the file you specify before starting, and exits if it's already locked
--flock-wait — locks the file you specify before starting, and waits if it's already locked ⏳
--flock2 — locks the file you specify after logging/daemon setup, exiting if it's locked
--flock-wait2 — locks the file you specify after logging/daemon setup, waiting if it's locked
--pidfile — creates a pidfile (before privileges drop)
--pidfile2 — creates a pidfile (after privileges drop)
--safe-pidfile — creates a safe pidfile (before privileges drop) 🛡️
--safe-pidfile2 — creates a safe pidfile (after privileges drop)
--chroot — chroot()s to the directory you specify
--pivot-root — pivot_root()s to the directories you specify (new_root and put_old must be separated with a space)
--pivot_root — pivot_root()s to the specified directories (new_root and put_old separated with a space) — underscore edition
--uid — setuids to the user/uid you specify
--gid — setgids to the group/gid you specify
--add-gid — adds the group id you specify to the process credentials
--immediate-uid — setuids to the specified user/uid IMMEDIATELY 🏃‍♀️
--immediate-gid — setgids to the specified group/gid IMMEDIATELY
--no-initgroups — disables the additional groups that would be set via initgroups()
--cap — sets the process capability
--unshare — unshare()s part of the processes and puts them in a new namespace 🌌
--unshare2 — unshare()s part of the processes and puts them in a new namespace, after the rootfs change
--setns-socket — exposes a unix socket that returns namespace fds from /proc/self/ns
--setns-socket-skip — skips the entry you specify when sending setns file descriptors
--setns-skip — skips the specified entry when sending setns file descriptors
--setns — joins a namespace that was created by an external uWSGI instance
--setns-preopen — opens /proc/self/ns as soon as possible and caches the fds ⚡
--jailed — flips the switch that says this instance is jailed, which forces the post_jail hooks to actually run 💅
--refork — does a fork() again after privileges get dropped. lowkey made for jailing setups 🧚
--re-fork — same exact energy as --refork: fork() again after privileges drop. jailing systems love this one 🫶
--refork-as-root — fork() again before privileges drop. again, for the jailing girlies 🎀
--re-fork-as-root — literally the same as --refork-as-root: fork() again before privileges drop. jailing systems, this is for y'all 💖
--refork-post-jail — fork() again after jailing. bestie it's giving jailing-system support and I'm obsessed ✨
--re-fork-post-jail — the twin of --refork-post-jail: fork() again after jailing. still for jailing systems 🌸
--hook-asap — run the hook you gave it as soon as possible, no cap ⚡
--hook-pre-jail — run that hook before jailing 🔒
--hook-post-jail — run that hook after jailing 🔓
--hook-in-jail — run that hook inside the jail, after initialization 🦋
--hook-as-root — run that hook before privileges drop 👑
--hook-as-user — run that hook after privileges drop 🙋‍♀️
--hook-as-user-atexit — run that hook before the app exits and before reload 💀
--hook-pre-app — run that hook before app loading 📦
--hook-post-app — run that hook after app loading ✅
--hook-post-fork — run that hook after every single fork 🍴
--hook-accepting — run that hook after each worker enters the accepting phase 👯
--hook-accepting1 — run that hook after the first worker enters the accepting phase 🥇
--hook-accepting-once — run that hook after each worker enters the accepting phase, but only once per-instance 🙈
--hook-accepting1-once — run that hook after the first worker enters the accepting phase, once per instance 💫
--hook-master-start — run that hook when the Master starts 👑✨
--hook-touch — run that hook when the file you name gets touched (syntax: <file> <action>) 🫰
--hook-emperor-start — run that hook when the Emperor starts 👸
--hook-emperor-stop — run that hook when the Emperor sends a stop message ✋
--hook-emperor-reload — run that hook when the Emperor sends a reload message 🔄
--hook-emperor-lost — run that hook when the Emperor connection is lost 😭
--hook-as-vassal — run that hook before exec()ing the vassal 🏃
--hook-as-emperor — run that hook in the emperor, after the vassal has been started 👸🫶
--hook-as-mule — run that hook in each mule 🐴
--hook-as-gateway — run that hook in each gateway 🚪
--after-request-hook — run the function/symbol you name after every request 💌
--after-request-call — same thing, different flag: run the function/symbol you name after every request 💌
--exec-asap — run that command as soon as possible ⚡
--exec-pre-jail — run that command before jailing 🔒
--exec-post-jail — run that command after jailing 🔓
--exec-in-jail — run that command in jail after initialization 🦋
--exec-as-root — run that command before privileges drop 👑
--exec-as-user — run that command after privileges drop 🙋‍♀️
--exec-as-user-atexit — run that command before app exit and reload 💀
--exec-pre-app — run that command before app loading 📦
--exec-post-app — run that command after app loading ✅
--exec-as-vassal — run that command before exec()ing the vassal 🏃
--exec-as-emperor — run that command in the emperor, after the vassal has been started 👸
--mount-asap — mount the filesystem as soon as possible 🗂️
--mount-pre-jail — mount the filesystem before jailing 🔒
--mount-post-jail — mount the filesystem after jailing 🔓
--mount-in-jail — mount the filesystem in jail after initialization 🦋
--mount-as-root — mount the filesystem before privileges drop 👑
--mount-as-vassal — mount the filesystem before exec()ing the vassal 🏃
--mount-as-emperor — mount the filesystem in the emperor, after the vassal has been started 👸
--umount-asap — unmount the filesystem as soon as possible 🙅
--umount-pre-jail — unmount the filesystem before jailing 🔒
--umount-post-jail — unmount the filesystem after jailing 🔓
--umount-in-jail — unmount the filesystem in jail after initialization 🦋
--umount-as-root — unmount the filesystem before privileges drop 👑
--umount-as-vassal — unmount the filesystem before exec()ing the vassal 🏃
--umount-as-emperor — unmount the filesystem in the emperor, after the vassal has been started 👸

okay now we're in the wait-for-things era and honestly? she's patient, she's gorgeous, she's organized 🌈

--wait-for-interface — wait for the network interface you name to come up before running root hooks 🛜
--wait-for-interface-timeout — set the timeout for wait-for-interface ⏰
--wait-interface — wait for the specified network interface to come up before running root hooks 🛜 (yes, same deal, shorter name bestie)
--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 filesystem item you name to appear before running root hooks 🗄️
--wait-for-file — wait for the file you name to appear before running root hooks 📄
--wait-for-dir — wait for the directory you name to appear before running root hooks 📁
--wait-for-mountpoint — wait for the mountpoint you name 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 name to be ready before loading apps 🔌
--wait-for-socket-timeout — set the timeout for wait-for-socket ⏰

and the call family, because sometimes you just need to call a function at a very specific moment in your life 💅

--call-asap — call the function you name 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 👸

--ini — load config from an ini file 📝
-y, --yaml — load config from a yaml file 🌱
-y, --yml — load config from a yaml file 🌱 (same vibe, shorter spelling)
-j, --json — load config from a json file 🧾
-j, --js — load config from a json file 🧾 (again, same thing)
--weight — the weight of the instance, used by clustering/lb/subscriptions ⚖️
--auto-weight — set the weight of the instance automatically, used by clustering/lb/subscriptions 🤖
--no-server — force no-server mode 🚫
--command-mode — force command mode ⌨️
--no-defer-accept — disable deferred-accept on sockets 🚫🔌
--tcp-nodelay — enable TCP NODELAY on each request 🚀
--so-keepalive — enable TCP KEEPALIVEs 💞
--so-send-timeout — set SO_SNDTIMEO ⏳
--socket-send-timeout — set SO_SNDTIMEO ⏳
--so-write-timeout — set SO_SNDTIMEO ⏳
--socket-write-timeout — set SO_SNDTIMEO ⏳
--socket-sndbuf — set SO_SNDBUF 📤
--socket-rcvbuf — set SO_RCVBUF 📥
--shutdown-sockets — force calling shutdown() in addition to close() when sockets are destroyed 🔌💥

--limit-as — limit the processes' address space/vsz 📏
--limit-nproc — limit how many processes can be spawned 🧮
--reload-on-as — reload if the address space goes higher than the megabytes you specify 🔁
--reload-on-rss — reload if rss memory goes higher than the megabytes you specify 🔁
--evil-reload-on-as — force the master to reload a worker if its address space goes higher than the megabytes you specify 😈
--evil-reload-on-rss — force the master to reload a worker if its rss memory goes higher than the megabytes you specify 😈
--mem-collector-freq — set the memory collector frequency when evil reloads are in place 🧹
--reload-on-fd — reload if the file descriptor you name 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 it's available) 🧠
--never-swap — lock all memory pages, avoiding swapping 🔒
--touch-reload — reload uWSGI if the file you name is modified/touched 🫰
--touch-workers-reload — trigger a reload of (only) workers if the file you name is modified/touched 👷
--touch-mules-reload — reload mules if the file you name is modified/touched 🐴
--touch-spoolers-reload — reload spoolers if the file you name is modified/touched 🌀
--touch-chain-reload — trigger a chain reload if the file you name is modified/touched ⛓️
--touch-logrotate — trigger logrotation if the file you name is modified/touched 🪵
--touch-logreopen — trigger log reopen if the file you name is modified/touched 📖
--touch-exec — run the command when the file you name is modified/touched (syntax: file command) 🫰⚡
--touch-signal — fire off a signal the moment the file you named gets modified or touched (syntax is file signal) ✨
--fs-reload — do a whole graceful reload when the filesystem object you picked gets modified
--fs-brutal-reload — same vibe but brutal reload when that filesystem object changes 💀
--fs-signal — raise a uwsgi signal when the specified filesystem object gets modified (syntax: file signal)
--check-mountpoint, --mountpoint-check, --check-mount, --mount-check — literally destroy the instance if a filesystem is no longer reachable. all four names do the same thing bestie. super useful for reliable Fuse management 🫶
--propagate-touch — the over-engineering option for systems with flaky signal management. yes it's extra, no we're not judging 🎀
--limit-post — cap the request body size
--no-orphans — auto-kill workers if the master dies. heads up: can be dangerous for availability so don't just turn it on and forget it 😭
--prio — set processes/threads priority
--cpu-affinity — set cpu affinity
--post-buffering — set the size in bytes after which stuff buffers to disk instead of memory
--post-buffering-bufsize — set the read() buffer size in post buffering mode
--body-read-warning — sets how much memory (in megabytes) a request body is allowed to allocate before it starts printing a warning at you 🙈
--upload-progress — enable creation of .json files in the directory you specify during a file upload
--no-default-app — no falling back to the default app, we're exclusive here 💅
--manage-script-name — automatically rewrite SCRIPT_NAME and PATH_INFO
--ignore-script-name — just ignore SCRIPT_NAME entirely
--catch-exceptions — report the exception as http output. discouraged, use only for testing — pls don't ship this fr fr
--reload-on-exception — reload a worker when an exception gets raised
--reload-on-exception-type — reload a worker when a specific exception type gets raised
--reload-on-exception-value — reload a worker when a specific exception value gets raised
--reload-on-exception-repr — reload a worker when a specific exception type+value is raised (language-specific ✨)
--exception-handler — add an exception handler

--enable-metrics — turn on the metrics subsystem 👑
--metric — add a custom metric
--metric-threshold, --metric-alarm, --alarm-metric — all three add a metric threshold/alarm. same thing, three names, slay 🌸
--metrics-dir — export metrics as text files into the directory you name
--metrics-dir-restore — restore the last value taken from the metrics dir
--metric-dir — export metrics as text files to the specified directory (yes it's basically a twin)
--metric-dir-restore — restore last value taken from the metrics dir
--metrics-no-cores — disable generation of cores-related metrics
--udp — run the udp server on the address you give it
--stats, --stats-server — enable the stats server on the specified address
--stats-http — prefix stats server json output with http headers
--stats-minified, --stats-min — minify the statistics json output
--stats-push — push the stats json to the destination you specify
--stats-pusher-default-freq, --stats-pushers-default-freq — set the default frequency of stats pushers
--stats-no-cores — disable generation of cores-related stats
--stats-no-metrics — don't include metrics in the stats output
--multicast — subscribe to the multicast group you specify
--multicast-ttl — set multicast ttl
--multicast-loop — set multicast loop (default is 1)
--master-fifo — enable the master fifo
--notify-socket — enable the notification socket
--subscription-notify-socket — set the notification socket for subscriptions

--legion — became a member of a legion 🔥
--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 the legion subsystem
--legion-death-on-lord-error — declare itself as a dead node for the number of seconds you specify if one of the lord hooks fails 💀
--legion-skew-tolerance — set the clock skew tolerance of the legion subsystem (default is 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 max size of the legion scroll buffer
--legion-scroll-list-max-size — set max size of the legion scroll list buffer

--subscriptions-sign-check — set the digest algorithm and certificate directory for the secured subscription system 🔐
--subscriptions-sign-check-tolerance — set the maximum tolerance (in seconds) of clock skew for the secured subscription system
--subscriptions-sign-skip-uid — skip the signature check for the uid you specify when using unix sockets credentials
--subscriptions-credentials-check — add a directory to search for subscriptions key credentials
--subscriptions-use-credentials — enable management of SCM_CREDENTIALS in subscriptions UNIX sockets
--subscription-algo — set the load balancing algorithm for the subscription system
--subscription-dotsplit — try to fall back to the next part (dot based) in the subscription key
--subscribe-to, --st, --subscribe — subscribe to the subscription server you specify ✨
--subscribe2 — subscribe to the specified subscription server using advanced keyval syntax
--subscribe-freq — send the subscription announce at the interval you specify
--subscription-tolerance — set tolerance for subscription servers
--unsubscribe-on-graceful-reload — force the unsubscribe request even during a graceful reload
--start-unsubscribed — configure subscriptions but don't actually send them (super useful with master fifo)
--subscribe-with-modifier1 — force the specified modifier1 when subscribing

--snmp — enable the embedded snmp server
--snmp-community — set the snmp community string
--ssl-verbose — be verbose about SSL errors
--ssl-verify-depth — set the maximum certificate verification depth
--sni — add an SNI-governed SSL context
--sni-dir — check for cert/key/client_ca files in the directory you specify and create a sni/ssl context on demand 🦋
--sni-dir-ciphers — set ssl ciphers for the sni-dir option
--ssl-enable3, --ssl-enable-sslv3 — enable SSLv3. (insecure) bestie why 😭
--ssl-enable-tlsv1 — enable TLSv1. (insecure) also why 😭
--ssl-option — set a raw ssl option (numeric value)
--sni-regexp — add an SNI-governed SSL context (the key is a regexp)
--ssl-tmp-dir — store ssl-related temp files in the directory you specify
--check-interval — set the interval (in seconds) of master checks
--forkbomb-delay — sleep for the number of seconds you specify when a forkbomb is detected 💀
--binary-path — force the binary path
--privileged-binary-patch — patch the uwsgi binary with a new command (before the privileges drop)
--unprivileged-binary-patch — patch the uwsgi binary with a new command (after the privileges drop)
--privileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments (before privileges drop)
--unprivileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments (after privileges drop)
--async — enable async mode with the number of cores you specify
--max-fd — set the maximum number of file descriptors (requires root privileges 👑)
--logto — set the logfile/udp address
--logto2 — log to the file or udp address you specify after the privileges drop
--log-format, --logformat — set the advanced format for request logging
--logformat-strftime, --log-format-strftime — apply strftime to the logformat output
--logfile-chown — chown logfiles
--logfile-chmod — chmod logfiles
--log-syslog — log to syslog
--log-socket — send logs to the socket you specify
--req-logger, --logger-req — set/append a request logger
--logger — set/append a logger
--logger-list, --loggers-list — list enabled loggers
--threaded-logger — offload log writing to a thread
--log-encoder — add an item to the log encoder chain
--log-req-encoder — add an item to the log req encoder chain
--log-drain — drain (a.k.a. do not show) log lines matching the regexp you give it 🙈
--log-filter — show only the log lines matching the regexp you give it
--log-route — log to the named logger you specify if the regexp applied on the logline matches
--log-req-route — log requests to the named logger you specify if the regexp applied on the logline matches
--use-abort — call abort() on segfault/fpe, could be useful for generating a core dump 💀
--alarm — create a new alarm. syntax: <alarm> <plugin:args>

okay bestie we're back in the option mines ⛏️✨ grab your emotional support snack because this stretch is long, but it's also where all the good routing nonsense lives, so buckle up 💅

--alarm-cheap — use the main alarm thread for curl-based alarms instead of spawning dedicated threads for each one 🧵 less thread-chaos, more chill.
--alarm-freq — tune how often the anti-loop alarm system fires (default 3 seconds) 🔁
--alarm-fd — raise the specified alarm when an fd is read. by default it reads 1 byte 😭 so set it to 8 if you're working with eventfd.
--alarm-segfault — raise the specified alarm when the segmentation fault handler runs 💀
--segfault-alarm — raise the specified alarm when the segmentation fault handler runs 💀 (yes bestie, same energy, it's the twin).
--alarm-backlog — raise the specified alarm when the socket backlog queue is full 😤
--backlog-alarm — raise the specified alarm when the socket backlog queue is full 😤
--lq-alarm — raise the specified alarm when the socket backlog queue is full 😤
--alarm-lq — raise the specified alarm when the socket backlog queue is full 😤
--alarm-listen-queue — raise the specified alarm when the socket backlog queue is full 😤
--listen-queue-alarm — raise the specified alarm when the socket backlog queue is full 😤 (six names, one job. slay 💅)
--log-alarm — raise the specified alarm when a log line matches the specified regexp. syntax: <alarm>[,alarm...] <regexp> 🚨
--alarm-log — raise the specified alarm when a log line matches the specified regexp. syntax: <alarm>[,alarm...] <regexp> 🚨
--not-log-alarm — skip the specified alarm when a log line matches the specified regexp. syntax: <alarm>[,alarm...] <regexp> 🙈
--not-alarm-log — skip the specified alarm when a log line matches the specified regexp. syntax: <alarm>[,alarm...] <regexp> 🙈
--alarm-list — list enabled alarms 📋
--alarms-list — list enabled alarms 📋
--alarm-msg-size — set the max size of an alarm message (default 8192) 📨

--log-master — delegate logging to the master process 👑 log duties: outsourced.
--log-master-bufsize — set the buffer size for the master logger. bigger log messages will get truncated ✂️ (rip to long lines).
--log-master-stream — create the master logpipe as SOCK_STREAM 🚰
--log-master-req-stream — create the master requests logpipe as SOCK_STREAM 🚰
--log-reopen — reopen the log after a reload 🔄
--log-truncate — truncate the log on startup 🗑️ fresh page energy.
--log-maxsize — set maximum logfile size 📏
--log-backupname — set the logfile name used after rotation 🗂️
--logdate — prefix logs with a date or a strftime string 📅
--log-date — prefix logs with a date or a strftime string 📅
--log-prefix — prefix logs with a string 🏷️
--log-zero — log responses without a body 🫥
--log-slow — log requests slower than the specified number of milliseconds 🐢
--log-4xx — log requests with a 4xx response 🚫
--log-5xx — log requests with a 5xx response 💥
--log-big — log requests bigger than the specified size 🐋
--log-sendfile — log sendfile requests 📤
--log-ioerror — log requests with io errors 🩹
--log-micros — report response time in microseconds instead of milliseconds ⏱️ (yes queen, be precise)
--log-x-forwarded-for — use the ip from the X-Forwarded-For header instead of REMOTE_ADDR 🌐

--master-as-root — leave the master process running as root 👑🔓
--drop-after-init — run privileges drop after plugin initialization, superseded by drop-after-apps 📉
--drop-after-apps — run privileges drop after apps loading, superseded by master-as-root 📉
--force-cwd — force the initial working directory to the specified value 📁
--binsh — override /bin/sh (used by exec hooks — 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 the master) 😴
--lazy-apps — load apps in each worker instead of the master 😴
--cheap — set cheap mode (spawn workers only after the first request) 🪙
--cheaper — set cheaper mode (adaptive process spawning) 📈
--cheaper-initial — set the initial number of processes to spawn in cheaper mode 🔢
--cheaper-algo — choose the algorithm used for adaptive process spawning 🧠
--cheaper-step — number of additional processes to spawn at each overload 🪜
--cheaper-overload — increase workers after the specified overload 🏋️
--cheaper-algo-list — list enabled cheapers algorithms 📜
--cheaper-algos-list — list enabled cheapers algorithms 📜
--cheaper-list — list enabled cheapers algorithms 📜
--cheaper-rss-limit-soft — don't spawn new workers if the total resident memory usage of all workers is higher than this limit 🧠🚧
--cheaper-rss-limit-hard — if total workers resident memory usage is higher, try to stop workers 🛑
--idle — set idle mode (puts uWSGI in cheap mode after inactivity) 💤
--die-on-idle — shutdown uWSGI when idle ⚰️ the ultimate nap.

--mount — load an application under a mountpoint 🏔️
--worker-mount — load an application under a mountpoint in the specified worker, or after workers spawn 🏔️🧑‍🏭
--threads — run each worker in prethreaded mode with the specified number of threads 🧵
--thread-stacksize — set the threads stacksize 📚
--threads-stacksize — set the threads stacksize 📚
--thread-stack-size — set the threads stacksize 📚
--threads-stack-size — set the threads stacksize 📚

--vhost — enable virtualhosting mode (based on the SERVER_NAME variable) 🏠
--vhost-host — enable virtualhosting mode (based on the HTTP_HOST variable) 🏠

ok here comes the routing section 🌈 (still OPTIONS, bestie, we're just vibing)

--route — add a route 🛣️
--route-host — add a route based on the Host header 🏷️
--route-uri — add a route based on REQUEST_URI 🔗
--route-qs — add a route based on QUERY_STRING ❓
--route-remote-addr — add a route based on REMOTE_ADDR 📍
--route-user-agent — add a route based on HTTP_USER_AGENT 🕵️
--route-remote-user — add a route based on REMOTE_USER 👤
--route-referer — add a route based on HTTP_REFERER ↩️
--route-label — add a routing label (for use with goto) 🔖
--route-if — add a route based on a condition 🧩
--route-if-not — add a route based on a condition (negate version) 🙃
--route-run — always run the specified route action ▶️
--final-route — add a final route 🏁
--final-route-status — add a final route for the specified status 🏁
--final-route-host — add a final route based on the Host header 🏁
--final-route-uri — add a final route based on REQUEST_URI 🏁
--final-route-qs — add a final route based on QUERY_STRING 🏁
--final-route-remote-addr — add a final route based on REMOTE_ADDR 🏁
--final-route-user-agent — add a final route based on HTTP_USER_AGENT 🏁
--final-route-remote-user — add a final route based on REMOTE_USER 🏁
--final-route-referer — add a final route based on HTTP_REFERER 🏁
--final-route-label — add a final routing label (for use with goto) 🏁🔖
--final-route-if — add a final route based on a condition 🏁
--final-route-if-not — add a final route based on a condition (negate version) 🏁🙃
--final-route-run — always run the specified final route action 🏁▶️
--error-route — add an error route 🚨
--error-route-status — add an error route for the specified status 🚨
--error-route-host — add an error route based on the Host header 🚨
--error-route-uri — add an error route based on REQUEST_URI 🚨
--error-route-qs — add an error route based on QUERY_STRING 🚨
--error-route-remote-addr — add an error route based on REMOTE_ADDR 🚨
--error-route-user-agent — add an error route based on HTTP_USER_AGENT 🚨
--error-route-remote-user — add an error route based on REMOTE_USER 🚨
--error-route-referer — add an error route based on HTTP_REFERER 🚨
--error-route-label — add an error routing label (for use with goto) 🚨🔖
--error-route-if — add an error route based on a condition 🚨
--error-route-if-not — add an error route based on a condition (negate version) 🚨🙃
--error-route-run — always run the specified error route action 🚨▶️
--response-route — add a response route 📬
--response-route-status — add a response route for the specified status 📬
--response-route-host — add a response route based on the Host header 📬
--response-route-uri — add a response route based on REQUEST_URI 📬
--response-route-qs — add a response route based on QUERY_STRING 📬
--response-route-remote-addr — add a response route based on REMOTE_ADDR 📬
--response-route-user-agent — add a response route based on HTTP_USER_AGENT 📬
--response-route-remote-user — add a response route based on REMOTE_USER 📬
--response-route-referer — add a response route based on HTTP_REFERER 📬
--response-route-label — add a response routing label (for use with goto) 📬🔖
--response-route-if — add a response route based on a condition 📬
--response-route-if-not — add a response route based on a condition (negate version) 📬🙃
--response-route-run — always run the specified response route action 📬▶️
--router-list — list enabled routers 📋
--routers-list — list enabled routers 📋

--error-page-403 — add an error page (html) for the managed 403 response 🚫
--error-page-404 — add an error page (html) for the managed 404 response 👻
--error-page-500 — add an error page (html) for the managed 500 response 💥
--websockets-ping-freq — set the frequency (in seconds) of websockets automatic ping packets 🏓
--websocket-ping-freq — set the frequency (in seconds) of websockets automatic ping packets 🏓
--websockets-pong-tolerance — set the tolerance (in seconds) of the websockets ping/pong subsystem 🏓
--websocket-pong-tolerance — set the tolerance (in seconds) of the websockets ping/pong subsystem 🏓
--websockets-max-size — set the max allowed size of websocket messages (in Kbytes, default 1024) 📦
--websocket-max-size — set the max allowed size of websocket messages (in Kbytes, default 1024) 📦
--chunked-input-limit — set the max size of a chunked input part (default 1MB, in bytes) 🧩
--chunked-input-timeout — set the default timeout for chunked input ⏳
--clock — set a clock source 🕰️
--clock-list — list enabled clocks 📋

ok that's this chunk done bestie, keep going, the options are still coming 💖✨

--clocks-list — lists all the clocks that are currently enabled, bestie ⏰
--add-header — auto-drops HTTP headers into the response for you, no manual labour 💅
--rem-header — auto-removes the HTTP header you name from the response 🫥
--del-header — same gig, different name: nukes the specified HTTP header out of the response 🗑️
--collect-header — stashes the given response header into a request var (syntax: header var) 🎀
--response-header-collect — literally the same thing: response header → request var (syntax: header var) 🎀
--pull-header — grabs the specified response header, saves it into a request var, and yeets it out of the response (syntax: header var) 🫳
--check-static — peeks for static files inside the directory you point at 📂
--check-static-docroot — peeks for static files inside the requested DOCUMENT_ROOT 🏠
--static-check — yes bestie it's the check-static twin: looks for static files in the specified directory 📂
--static-map — maps a mountpoint onto a static directory (or a single file) 🗺️
--static-map2 — like --static-map, except it fully appends the requested resource onto the docroot ✨
--static-skip-ext — skips the extension you name during staticfile checks 🙈
--static-index — if someone requests a directory, it goes hunting for the file you specified 🔍
--static-safe — skips the security checks when the file lives under the path you gave 👑
--static-cache-paths — shoves the resolved paths into the uWSGI cache for however many seconds you say 🗃️
--static-cache-paths-name — uses the cache you pick for those static paths 🎯
--mimefile — sets the mime types file path (default /etc/mime.types) 📄
--mime-file — identical twin energy: sets the mime types file path (default /etc/mime.types) 📄
--static-expires-type — sets the Expires header based on the content type 📅
--static-expires-type-mtime — sets the Expires header based on the content type and the 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 the 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 the 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 the file mtime ⏱️
--static-gzip — if the regexp you handed over matches the static file translation, it'll go looking for a gzip version 🗜️
--static-gzip-all — checks for a gzip version of every requested static file 🗜️
--static-gzip-dir — checks for a gzip version of all requested static files inside the dir/prefix you name 📁
--static-gzip-prefix — same deal, still hunting gzip versions of all requested static files in the specified dir/prefix 📁
--static-gzip-ext — hunts for a gzip version of all requested static files carrying the ext/suffix you specified 🏷️
--static-gzip-suffix — yeah it's the ext/suffix one again: gzip versions of all requested static files with that ext/suffix 🏷️
--honour-range — switches on support for the HTTP Range header 📏
--offload-threads — sets how many offload threads to spawn (per-worker, default 0) 🧵
--offload-thread — the singular-named twin, same job: 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 (yes, no dash, same vibe) 🚚
--disable-sendfile — kills sendfile() and makes everything run on plain boring read()/write() 😴
--check-cache — looks for response data in the cache you name (leave it empty for the default cache) 🔎
--close-on-exec — sets close-on-exec on connection sockets (could be required for spawning processes in requests) 🚪
--close-on-exec2 — sets close-on-exec on server sockets (could be required for spawning processes in requests) 🚪
--mode — set uWSGI custom mode 🎛️
--env — set an environment variable 🌍
--envdir — loads a daemontools compatible envdir 📂
--early-envdir — loads a daemontools compatible envdir ASAP, no waiting around ⚡
--unenv — unset an environment variable 🧹
--vacuum — tries to remove every generated file and socket on the way out 🧽
--file-write — writes the content you give to the file you give (syntax: file=value), and it happens before privileges drop ⚠️
--cgroup — drops the processes into the cgroup you specify 🪆
--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 inside a brand-new namespace under the rootfs you specify 🌌
--namespace-keep-mount — keeps the mountpoint you name alive inside your namespace 🧷
--ns — runs in a new namespace under the specified rootfs (short and sweet version) 🌌
--namespace-net — adds a network namespace 🕸️
--ns-net — adds a network namespace, tiny-name edition 🕸️
--enable-proxy-protocol — enables PROXY1 protocol support (only for http parsers) 🧾
--reuse-port — enables the REUSE_PORT flag on the socket (BSD only) 🐡
--tcp-fast-open — enables the TCP_FASTOPEN flag on TCP sockets with the qlen value you give ⚡
--tcp-fastopen — same flag, no dash: TCP_FASTOPEN on TCP sockets with your qlen value ⚡
--tcp-fast-open-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() when it's supported 🚀
--tcp-fastopen-client — identical, still sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported 🚀
--zerg — attaches 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 UNIX socket you name 🐛
--cron — adds a cron task ⏰
--cron2 — adds a cron task using key=val syntax ⏰
--unique-cron — adds a unique cron task, one of a kind 💎
--cron-harakiri — sets the maximum time (in seconds) we wait for a cron command to complete ⏳
--legion-cron — adds a cron task that only runs when the instance is a lord of the legion you specified 👑
--cron-legion — also adds a cron task runnable only when the instance is a lord of the specified legion 👑
--unique-legion-cron — adds a unique cron task that only runs when the instance is a lord of the specified legion 💎👑
--unique-cron-legion — same thing, name flipped: unique cron task, runnable only when the instance is a lord of the specified legion 💎👑
--loop — selects the uWSGI loop engine 🔁
--loop-list — lists enabled loop engines 📋
--loops-list — lists enabled loop engines (plural, same list, we love options) 📋
--worker-exec — runs the command you give as a worker 🛠️
--worker-exec2 — runs the specified command as a worker, but 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 that 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, except the daemon only runs on the legion lord node 👑
--legion-smart-attach-daemon — same as --smart-attach-daemon, except the daemon only runs on the legion lord node 👑
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2, except the daemon only runs on the legion lord node 👑
--daemons-honour-stdin — does not swap the stdin of external daemons over to /dev/null 🙅
--attach-daemon2 — the attach-daemon keyval variant (supports smart modes too) 🗝️
--plugins — loads uWSGI plugins 🧩
--plugin — loads uWSGI plugins, one-letter-shorter edition 🧩
--need-plugins — loads uWSGI plugins, and actually exits on error 🚨
--need-plugin — loads uWSGI plugins and exits on error, singular name 🚨
--plugins-dir — adds a directory to the uWSGI plugin search path 🔎
--plugin-dir — adds a directory to the uWSGI plugin search path, same path, shorter name 🔎
--plugins-list — lists enabled plugins 📋
--plugin-list — lists enabled plugins (you already know it's the twin) 📋
--autoload — tries to automatically load plugins whenever unknown options show up 🤖
--dlopen — blindly loads a shared library 🙈
--allowed-modifiers — a comma separated list of the allowed modifiers ✅
--remap-modifier — remaps a request modifier from one id to another 🔀
--dump-options — dumps the full list of every available option 🗒️
--show-config — shows the current config, reformatted as ini 📜
--binary-append-data — returns the content of a resource to stdout so you can append it to a uwsgi binary (for data:// usage) ➕
--print — simple print 🖨️
--iprint — simple print, immediate version ⚡🖨️
--exit — force exit() on 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 the uWSGI version 🏷️
--response-headers-limit — sets the response header maximum size (default: 64k) 📦

and that's the whole options buffet, bestie, we ate and left no crumbs 👑✨

this one's from uwsgi_xslt, version 2.0.31-debian, dated July 2026 — aka UWSGI_XSLT(1), and yes she's iconic, keep her close 💖🦋💅

📦 where this page comes from

ubuntu stonking: uwsgi-plugin-xslt 2.0.31-6build1 · GPL-2.0-only
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-11-02: a language model's rewrite of the original, under its terms