UWSGI_ALARM_XMPP(1)

📦

version 2.0.31 · 7 versions

🌸 NAME 🌸

uwsgi_alarm_xmpp — the fast (pure C), self-healing, developer-friendly WSGI server. This is the manual page for it, bestie, and yeah there's a LOT 🫶

✨ SYNOPSIS ✨

uwsgi-core [options...]

💅 DESCRIPTION 💅

Okay so, buckle up, because this is literally a menu of every socket, worker, config and emperor knob this server has. Every single flag is listed right here, fr fr — nothing skipped, no crumbs. Let's get into it. 👑

🌈 Sockets & Protocols

-s, --socket — bind to the specified UNIX/TCP socket using the default protocol
-s, --uwsgi-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol
--suwsgi-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol over SSL
--ssl-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol over SSL
--http-socket — bind to the specified UNIX/TCP socket using the HTTP protocol
--http-socket-modifier1 — force the specified modifier1 when using the HTTP protocol
--http-socket-modifier2 — force the specified modifier2 when using the HTTP protocol
--http11-socket — bind to the specified UNIX/TCP socket using the HTTP 1.1 (Keep-Alive) protocol
--https-socket — bind to the specified UNIX/TCP socket using the HTTPS protocol
--https-socket-modifier1 — force the specified modifier1 when using the HTTPS protocol
--https-socket-modifier2 — force the specified modifier2 when using the HTTPS protocol
--fastcgi-socket — bind to the specified UNIX/TCP socket using the FastCGI protocol
--fastcgi-nph-socket — bind to the specified UNIX/TCP socket using the FastCGI protocol (nph mode)
--fastcgi-modifier1 — force the specified modifier1 when using the FastCGI protocol
--fastcgi-modifier2 — force the specified modifier2 when using the FastCGI protocol
--scgi-socket — bind to the specified UNIX/TCP socket using the SCGI protocol
--scgi-nph-socket — bind to the specified UNIX/TCP socket using the SCGI protocol (nph mode)
--scgi-modifier1 — force the specified modifier1 when using the SCGI protocol
--scgi-modifier2 — force the specified modifier2 when using the SCGI protocol
--raw-socket — bind to the specified UNIX/TCP socket using the RAW protocol
--raw-modifier1 — force the specified modifier1 when using the RAW protocol
--raw-modifier2 — force the specified modifier2 when using the RAW protocol
--puwsgi-socket — bind to the specified UNIX/TCP socket using the 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 & Harakiri

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

🎀 Config Loading & Placeholders

-x, --xmlconfig — load config from an xml file
-x, --xml — load config from an xml file
--config — load configuration using the pluggable system
--fallback-config — re-exec uwsgi with the specified config when the exit code is 1
--strict — enable strict mode (placeholder cannot be used) ⚠️
--skip-zero — skip the 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)

💜 Option 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 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 / Whitelist Context

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

💀 Write Errors & Signal Vibes

--ignore-sigpipe — do not report (annoying) SIGPIPE
--ignore-write-errors — do not report (annoying) write()/writev() errors
--write-errors-tolerance — set the maximum number of allowed write errors (default: no tolerance)
--write-errors-exception-only — only raise an exception on write errors, giving control to the app itself
--disable-write-exception — disable exception generation on write()/writev()

🌟 Templating & Includes

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

🍓 Daemon Lifecycle

-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

🔥 Sizing, Buffers & Memory

-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

👑 Socket Modes & Permissions

-c, --cgi-mode — force CGI-mode for plugins supporting it
-a, --abstract-socket — force UNIX socket in abstract mode (Linux only)
-C, --chmod-socket — chmod-socket
-C, --chmod — chmod-socket
--chown-socket — chown unix sockets
--umask — set umask
--freebind — put socket in freebind mode
--map-socket — map sockets to specific workers

🧵 Threads & Process Names

-T, --enable-threads — enable threads (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

⭐ App Loading & 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 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 — writes the Emperor's pid into the file you point it at 📝
--emperor-tyrant — puts the Emperor into Tyrant mode 👑
--emperor-tyrant-nofollow — while it's checking uid/gid in Tyrant mode, it will not follow symlinks 🚫🔗
--emperor-stats — runs the Emperor stats server 📊
--emperor-stats-server — also runs the Emperor stats server (same thing, other name) 📊
--early-emperor — spawns the emperor as soon as possible ⚡
--emperor-broodlord — runs the emperor in BroodLord mode 🐲
--emperor-throttle — sets the throttling level, in milliseconds, for vassals that are acting out (default 1000) 😤
--emperor-max-throttle — sets the max throttling level, in milliseconds, for those badly-behaving vassals (default 3 minutes) 🛑
--emperor-magic-exec — prefixes vassals' config files with exec:// when they have the executable bit ✨
--emperor-on-demand-extension — searches for a text file named vassal name + extension, and that file holds the on demand socket name 🔍
--emperor-on-demand-ext — same search, short-name twin of the one above 🔍
--emperor-on-demand-directory — enables on demand mode, binding to the unix socket inside the directory you specify, named like the vassal + .socket 📂
--emperor-on-demand-dir — the short-name version of that same on-demand-directory behaviour 📂
--emperor-on-demand-exec — uses the output of the command you specify as the on demand socket name, and the vassal name is passed as the one and only argument 🎯
--emperor-extra-extension — allows the extension you specify in the Emperor; the vassal gets called with --config 📎
--emperor-extra-ext — short-name twin of the extra-extension thing 📎
--emperor-no-blacklist — disables the Emperor blacklisting subsystem 🚫
--emperor-use-clone — uses clone() instead of fork(), passing the unshare() flags you specify 🧬
--emperor-graceful-shutdown — uses vassals graceful shutdown during ragnarok 🌅
--emperor-cap — sets vassals capability 🎩
--vassals-cap — sets vassals capability 🎩
--vassal-cap — sets vassals capability 🎩
--imperial-monitor-list — lists the enabled imperial monitors 📋
--imperial-monitors-list — lists the enabled imperial monitors 📋
--vassals-inherit — adds config templates to vassals config (uses --inherit) 📥
--vassals-include — includes config templates into vassals config (uses --include instead of --inherit) 📥
--vassals-inherit-before — adds config templates to vassals config (uses --inherit, and parses before the vassal file) ⏮️
--vassals-include-before — includes config templates into vassals config (uses --include instead of --inherit, and parses before the vassal file) ⏮️
--vassals-start-hook — runs the command you specify before each vassal starts 🚀
--vassals-stop-hook — runs the command you specify after a vassal's death ⚰️
--vassal-sos — asks the emperor for reinforcements when it's overloaded 🆘
--vassal-sos-backlog — asks the emperor for sos when the backlog queue has more items in it than the value you specify 🆘
--vassals-set — automatically sets the option you name (via --set) for every single vassal 🎁
--vassal-set — automatic set-for-every-vassal, short-name edition 🎁
--heartbeat — announces healthiness to the emperor 💗
--reload-mercy — sets the maximum time, in seconds, that we wait for workers and other processes to die during reload/shutdown ⏳
--worker-reload-mercy — sets the maximum time, in seconds, that a worker can take to reload/shutdown (default is 60) ⏳
--mule-reload-mercy — sets the maximum time, in seconds, that a mule can take to reload/shutdown (default is 60) ⏳
--exit-on-reload — forces exit even when a reload has been requested 🚪
--die-on-term — exits instead of doing a brutal reload on SIGTERM 💀
--force-gateway — forces the spawn of the first registered gateway with no master in play 🚪
-h, --help — shows this help 🙋
-h, --usage — shows this help 🙋
--print-sym — prints the content of the binary symbol you specify 🔎
--print-symbol — prints the content of the binary symbol you specify 🔎
-r, --reaper — calls waitpid(-1,...) after each request to get rid of zombies 🧟
-R, --max-requests — reloads workers after the amount of managed requests you specify 🔁
--max-requests-delta — adds (worker_id * delta) to the max_requests value of each worker ➕
--min-worker-lifetime — number of seconds a worker must run before it can be reloaded (default is 10) ⏱️
--max-worker-lifetime — reloads workers after the amount 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 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 dodge 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 — does not close the file descriptor you specify 🛡️
--fd-safe — does not close the file descriptor you specify 🛡️
--cache — creates a shared cache containing the elements you give it 🗄️
--cache-blocksize — sets cache blocksize 📦
--cache-store — enables persistent cache to disk 💾
--cache-store-sync — sets the frequency of sync for the persistent cache 🔄
--cache-no-expire — disables the auto sweep of expired items 🧹
--cache-expire-freq — sets the frequency of cache sweeper scans (default 3 seconds) 🧹
--cache-report-freed-items — constantly reports the cache item freed by the sweeper (use only for debug) 🐛
--cache-udp-server — binds the cache udp server (used only for set/update/delete) to the socket you specify 📡
--cache-udp-node — sends cache update/deletion to the cache udp server you specify 📡
--cache-sync — copies the whole content of another uWSGI cache server on server startup 📋
--cache-use-last-modified — updates the last_modified_at timestamp on every cache item modification (default is disabled) 🕒
--add-cache-item — adds an item in the cache ➕
--load-file-in-cache — loads a static file in the cache 📄
--load-file-in-cache-gzip — loads a static file in the cache with gzip compression 🗜️
--cache2 — creates a new generation shared cache (keyval syntax) 🆕
--queue — enables shared queue 🚶
--queue-blocksize — sets queue blocksize 📦
--queue-store — enables persistent queue to disk 💾
--queue-store-sync — sets the frequency of sync for the persistent queue 🔄
-Q, --spooler — runs a spooler on the directory you specify 🌀
--spooler-external — maps spoolers requests to a spooler directory managed by an external instance 🔗
--spooler-ordered — tries to order the execution of spooler tasks 🔢
--spooler-chdir — chdir()s to the directory you specify before each spooler task 📁
--spooler-processes — sets the number of processes for spoolers 🧵
--spooler-quiet — does not get verbose with spooler tasks 🤫
--spooler-max-tasks — sets the maximum number of tasks to run before recycling a spooler ♻️
--spooler-harakiri — sets harakiri timeout for spooler tasks 🗡️
--spooler-frequency — sets spooler frequency 🎚️
--spooler-freq — sets spooler frequency 🎚️
--mule — adds a mule 🐴
--mules — adds the number of mules you specify 🐴
--farm — adds a mule farm 🚜
--mule-msg-size — sets 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 📶
--signal-timer — adds a timer (syntax: <signal> <seconds>) ⏲️
--timer — adds a timer (syntax: <signal> <seconds>) ⏲️
--signal-rbtimer — adds a redblack timer (syntax: <signal> <seconds>) 🌲
--rbtimer — adds a redblack timer (syntax: <signal> <seconds>) 🌲
--rpc-max — maximum number of rpc slots (default: 64) 🎰
-L, --disable-logging — disables request logging 🔇
--flock — locks the file you specify before starting, and exits if it's locked 🔐
--flock-wait — locks the file you specify before starting, and waits if it's locked ⏸️
--flock2 — locks the file you specify after logging/daemon setup, and exits if it's locked 🔐
--flock-wait2 — locks the file you specify after logging/daemon setup, and waits 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 directories you specify (new_root and put_old must be separated with a space) 🌀
--uid — setuid to the user/uid you specify 👤
--gid — setgid to the group/gid you specify 👥
--add-gid — adds the group id you specify to the process credentials ➕
--immediate-uid — setuid to the user/uid you specify, IMMEDIATELY ⚡
--immediate-gid — setgid to the group/gid you specify, IMMEDIATELY ⚡
--no-initgroups — disables the additional groups set via initgroups() 🚫
--cap — sets process capability 🎩
--unshare — unshare()s part of the processes and puts it in a new namespace 🧬
--unshare2 — unshare()s part of the processes and puts it in a new namespace after the rootfs change 🧬
--setns-socket — exposes a unix socket returning namespace fds from /proc/self/ns 🔌
--setns-socket-skip — skips the entry you specify when sending setns file descriptors ⏭️
--setns-skip — skips the entry you specify when sending setns file descriptors ⏭️
--setns — joins a namespace created by an external uWSGI instance 🔗
--setns-preopen — opens /proc/self/ns as soon as possible and caches the fds 🗂️
--jailed — flags this instance as jailed, which forces the post_jail hooks to actually run. no skipping bestie 💅
--refork — does another fork() after privileges drop. perfect for jailing setups 🏰
--re-fork — same thing, another fork() after privileges drop. jailing setups stay winning ✨
--refork-as-root — does another fork() before privileges drop. jailing setups, you know the vibe 🎀
--re-fork-as-root — yep, another fork() before privileges drop. jailing setups again, iconic 🌸
--refork-post-jail — another fork() after jailing. jailing setups, slay 🦋
--re-fork-post-jail — another fork() after jailing. same energy, jailing setups 💖
--hook-asap — run that specified hook as soon as possible. like, immediately. no cap ⚡
--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 enters the accepting phase 🎯
--hook-accepting1 — run the specified hook after the first worker enters the accepting phase 🥇
--hook-accepting-once — run the specified hook after each worker enters the accepting phase, but only once per-instance ☝️
--hook-accepting1-once — run the specified hook after the first worker enters the accepting phase, once per instance ✋
--hook-master-start — run the specified hook when the Master starts 👑
--hook-touch — run the specified hook when the specified file is touched. syntax: <file> <action> 👆
--hook-emperor-start — run the specified hook when the Emperor starts 👑✨
--hook-emperor-stop — run the specified hook when the Emperor sends a stop message 🛑
--hook-emperor-reload — run the specified hook when the Emperor sends a reload message 🔄
--hook-emperor-lost — run the specified hook when the Emperor connection is lost 😭
--hook-as-vassal — run the specified hook before exec()ing the vassal 🧚
--hook-as-emperor — run the specified hook in the emperor after the vassal has been started 👑
--hook-as-mule — run the specified hook in each mule 🐴
--hook-as-gateway — run the specified hook in each gateway 🚪
--after-request-hook — run the specified function/symbol after each request 🔁
--after-request-call — run the specified function/symbol after each request. same thing, different name bestie 🫶
--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-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 👑
--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. yeah it's the same thing 🫶
--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. another nickname 📡
--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-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 👑💅
--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 name ✨
-j, --json — load config from a json file 🧾
-j, --js — load config from a json file. twin 🫶
--weight — weight of the instance (used by clustering/lb/subscriptions) ⚖️
--auto-weight — set 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 processes address space/vsz 🚧
--limit-nproc — limit the number of spawnable processes 🚧
--reload-on-as — reload if address space is higher than the specified megabytes 🔄
--reload-on-rss — reload if rss memory is higher than the specified megabytes 🔄
--evil-reload-on-as — force the master to reload a worker if its address space is higher than the specified megabytes 😈🔄
--evil-reload-on-rss — force the master to reload a worker if its rss memory is higher than the 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-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 — pings a signal when the file you picked gets modified/touched ✨ syntax goes like file signal, so like, both of those, in that order bestie 💖
--fs-reload — graceful reload the second that filesystem object you named gets modified 🦋
--fs-brutal-reload — brutal reload when that filesystem object gets modified 😤 no soft launch, it just goes
--fs-signal — raises a uwsgi signal when the specified filesystem object is modified, syntax: file signal 📣
--check-mountpoint — destroys the instance if a filesystem is no longer reachable (genuinely useful for reliable Fuse management, lowkey essential) 🍓
--mountpoint-check — same energy fr fr: destroys the instance if a filesystem is no more reachable (useful for reliable Fuse management)
--check-mount — destroys the instance if a filesystem is no more reachable (useful for reliable Fuse management) 💅
--mount-check — destroys the instance if a filesystem is no more reachable (useful for reliable Fuse management) 🎀
--propagate-touch — the over-engineering option, made for systems with flaky signal management 🙈 iykyk
--limit-post — limits the request body 🛑
--no-orphans — automatically kills workers if the master dies, and yes it can be dangerous for availability, so clock that ⚠️
--prio — sets processes/threads priority 👑
--cpu-affinity — sets cpu affinity 🌈
--post-buffering — sets the size in bytes after which it buffers to disk instead of memory 💾
--post-buffering-bufsize — sets the buffer size for read() in post buffering mode 📖
--body-read-warning — sets how much memory allocation (in megabytes) for the request body is allowed before it starts printing a warning 🚨
--upload-progress — enables creation of .json files in the directory you pick during a file upload 📂
--no-default-app — do not fallback to the default app, nope 🙅‍♀️
--manage-script-name — automatically rewrites SCRIPT_NAME and PATH_INFO 🪄
--ignore-script-name — ignores SCRIPT_NAME 💀
--catch-exceptions — reports the exception as http output (discouraged, use only for testing — like, only testing bestie) 🧪
--reload-on-exception — reloads a worker the moment an exception is raised 🔄
--reload-on-exception-type — reloads a worker when a specific exception type is raised 🎯
--reload-on-exception-value — reloads a worker when a specific exception value is raised 💥
--reload-on-exception-repr — reloads a worker when a specific exception type+value (language-specific) is raised 🫶
--exception-handler — adds an exception handler 🧤
--enable-metrics — turns on the metrics subsystem 📊
--metric — adds a custom metric ✨
--metric-threshold — adds a metric threshold/alarm 🚨
--metric-alarm — adds a metric threshold/alarm (same thing, different name, iconic) 🔔
--alarm-metric — adds a metric threshold/alarm, yes again, they really said options for days 🎀
--metrics-dir — exports metrics as text files into the directory you name 🗂️
--metrics-dir-restore — restores the last value taken from the metrics dir ♻️
--metric-dir — exports metrics as text files to the specified directory (the singular twin of the above) 📁
--metric-dir-restore — restores the last value taken from the metrics dir ♻️
--metrics-no-cores — disables generation of cores-related metrics 🚫
--udp — runs the udp server on the address you give it 📡
--stats — enables the stats server on the specified address 📈
--stats-server — enables the stats server on the specified address (same vibe) 📊
--stats-http — prefixes the stats server json output with http headers 🌐
--stats-minified — minifies the statistics json output 🗜️
--stats-min — minifies the statistics json output, short and sweet ✂️
--stats-push — pushes the stats json to the destination you specify 🚀
--stats-pusher-default-freq — sets the default frequency of stats pushers ⏱️
--stats-pushers-default-freq — sets the default frequency of stats pushers (plural moment) ⏰
--stats-no-cores — disables generation of cores-related stats 🙅
--stats-no-metrics — do not include metrics in stats output 🚫
--multicast — subscribes to the specified multicast group 📻
--multicast-ttl — sets the multicast ttl ⏳
--multicast-loop — sets multicast loop, and the default is 1 🔁
--master-fifo — enables the master fifo 🎛️
--notify-socket — enables the notification socket 🔔
--subscription-notify-socket — sets the notification socket for subscriptions 📬
--legion — becomes a member of a legion 🛡️
--legion-mcast — becomes a member of a legion, i.e. a shortcut for multicast ⚡
--legion-node — adds a node to a legion 🌟
--legion-freq — sets the frequency of legion packets 📶
--legion-tolerance — sets the tolerance of the legion subsystem 🫧
--legion-death-on-lord-error — declares itself as a dead node for however many seconds you specify if one of the lord hooks fails 💀
--legion-skew-tolerance — sets the clock skew tolerance of the legion subsystem, default is 60 seconds ⏲️
--legion-lord — the action to call on Lord election 👑
--legion-unlord — the action to call on Lord dismiss 👋
--legion-setup — the action to call on legion setup 🛠️
--legion-death — the action to call on legion death (shutdown of the instance) ⚰️
--legion-join — the action to call on legion join (the first time quorum is reached) 🎉
--legion-node-joined — the action to call on a new node joining the legion 🫂
--legion-node-left — the action to call on a node leaving the legion 🚪
--legion-quorum — sets the quorum of a legion 🗳️
--legion-scroll — sets the scroll of a legion 📜
--legion-scroll-max-size — sets the max size of the legion scroll buffer 📦
--legion-scroll-list-max-size — sets the max size of the legion scroll list buffer 🗃️
--subscriptions-sign-check — sets the digest algorithm and certificate directory for the secured subscription system 🔐
--subscriptions-sign-check-tolerance — sets the maximum tolerance (in seconds) of clock skew for the secured subscription system ⏱️
--subscriptions-sign-skip-uid — skips the signature check for the uid you specify when using unix sockets credentials 🙈
--subscriptions-credentials-check — adds a directory to search for subscriptions key credentials 🔎
--subscriptions-use-credentials — enables management of SCM_CREDENTIALS in subscriptions UNIX sockets 🔑
--subscription-algo — sets the load balancing algorithm for the subscription system ⚖️
--subscription-dotsplit — tries to fallback to the next part (dot based) in the subscription key 🔤
--subscribe-to — subscribes to the specified subscription server 📨
--st — subscribes to the specified subscription server (the tiny abbreviation, so cute) 📩
--subscribe — subscribes to the specified subscription server 📮
--subscribe2 — subscribes to the specified subscription server using advanced keyval syntax 🧠
--subscribe-freq — sends a subscription announce at the interval you specify 🔁
--subscription-tolerance — sets tolerance for subscription servers 🫶
--unsubscribe-on-graceful-reload — forces the unsubscribe request even during a graceful reload 💅
--start-unsubscribed — configures subscriptions but does not send them (useful with master fifo) 🤐
--subscribe-with-modifier1 — forces the specified modifier1 when subscribing ✏️ (yes the original says "specififed", we keep it, periodt)
--snmp — enables the embedded snmp server 🌲
--snmp-community — sets the snmp community string 🏘️
--ssl-verbose — be verbose about SSL errors 📢
--ssl-verify-depth — sets the maximum certificate verification depth 🕵️‍♀️
--sni — adds an SNI-governed SSL context 🌹
--sni-dir — checks for cert/key/client_ca files in the specified directory and creates a sni/ssl context on demand 🪄
--sni-dir-ciphers — sets ssl ciphers for the sni-dir option 🔒
--ssl-enable3 — enables SSLv3, which is insecure, so like, careful ⚠️
--ssl-enable-sslv3 — enables SSLv3 (insecure) 🚨
--ssl-enable-tlsv1 — enables TLSv1 (insecure, still, yes) 💀
--ssl-option — sets a raw ssl option, and it wants a numeric value 🔢
--sni-regexp — adds an SNI-governed SSL context, but the key is a regexp 🧩
--ssl-tmp-dir — stores ssl-related temp files in the directory you specify 🗄️
--check-interval — sets the interval (in seconds) of master checks ⏰
--forkbomb-delay — sleeps for the number of seconds you specify when a forkbomb is detected 😴
--binary-path — forces the binary path 📍
--privileged-binary-patch — patches the uwsgi binary with a new command (before privileges drop) 🔧
--unprivileged-binary-patch — patches the uwsgi binary with a new command (after privileges drop) 🪛
--privileged-binary-patch-arg — patches the uwsgi binary with a new command and arguments (before privileges drop) 🧰
--unprivileged-binary-patch-arg — patches the uwsgi binary with a new command and arguments (after privileges drop) 🧑‍🔧
--async — enables async mode with however many cores you specify ⚡
--max-fd — sets the maximum number of file descriptors, and it requires root privileges 👑
--logto — sets the logfile/udp address 📝
--logto2 — logs to the specified file or udp address after privileges drop 📄
--log-format — sets an advanced format for request logging 🎨
--logformat — sets advanced format for request logging (one word, same energy) 🖌️
--logformat-strftime — applies strftime to logformat output 🕰️
--log-format-strftime — applies strftime to logformat output (identical, we love a pair) ⏳
--logfile-chown — chowns logfiles 👤
--logfile-chmod — chmods logfiles 🔧
--log-syslog — logs to syslog 📮
--log-socket — sends logs to the socket you specify 🔌
--req-logger — sets/appends a request logger ➕
--logger-req — sets/appends a request logger (yes, same thing reversed) 🔁
--logger — sets/appends a logger 🪵
--logger-list — lists enabled loggers 📋
--loggers-list — lists enabled loggers (plural era) 🗒️
--threaded-logger — offloads log writing to a thread 🧵
--log-encoder — adds an item in the log encoder chain ⛓️
--log-req-encoder — adds an item in the log req encoder chain 🔗
--log-drain — drains (like, does not show) log lines matching the regexp you specify 🕳️
--log-filter — shows only log lines matching the specified regexp 🔍
--log-route — logs to the specified named logger if the regexp applied on the logline matches 🚏
--log-req-route — logs requests to the specified named logger if the regexp applied on the logline matches 🛤️
--use-abort — calls abort() on segfault/fpe, which could be useful for generating a core dump 🧨
--alarm — creates a new alarm, syntax: <alarm> <plugin:args> 🚨💖

--alarm-cheap — 💸 ok so this one makes uWSGI use the main alarm thread instead of spawning dedicated threads for curl-based alarms. server said "we're not making a whole new thread for that" 💅
--alarm-freq — tunes the anti-loop alarm system. default is 3 seconds ⏰
--alarm-fd — raise the specified alarm when an fd is read for read (by default it reads 1 byte, set 8 for eventfd) 🎀
--alarm-segfault — raise the specified alarm when the segmentation fault handler is executed 💀
--segfault-alarm — same description as --alarm-segfault, word for word: raise the specified alarm when the segmentation fault handler is executed 💀✨
--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 📬

bestie there are literally six of these and they all say the exact same thing. the manpage lists all of them, so here they all are. she's thorough, okay, she contains multitudes 🫶

--log-alarm — raise the specified alarm when a log line matches the specified regexp. syntax is <alarm>[,alarm...] <regexp> 🔍
--alarm-log — raise the specified alarm when a log line matches the specified regexp, same syntax: <alarm>[,alarm...] <regexp> 🔍
--not-log-alarm — the skip version: 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 is 8192 📏

✨ the logging era ✨

--log-master — delegate logging to the master process 👑
--log-master-bufsize — set the buffer size for the master logger. heads up: bigger log messages will be truncated ✂️
--log-master-stream — create the master logpipe as SOCK_STREAM 🧵
--log-master-req-stream — create the master requests logpipe as SOCK_STREAM 🧵
--log-reopen — reopen log after reload 🔄
--log-truncate — truncate log on startup 🧹
--log-maxsize — set maximum logfile size 📦
--log-backupname — set logfile name after rotation 🔁
--logdate — prefix logs with date or a strftime string 🗓️
--log-date — prefix logs with date or a strftime string 🗓️
--log-prefix — prefix logs with a string 🏷️
--log-zero — log responses without 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 🧮
--log-x-forwarded-for — use the ip from X-Forwarded-For header instead of REMOTE_ADDR 🌐

💜 privileges & where she starts from 💜

--master-as-root — leave 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 fallback to /bin/sh) 🐚
--chdir — chdir to specified directory before apps loading 🚪
--chdir2 — chdir to specified directory after apps loading 🚪

🌸 workers, laziness & the cheaper economy 🌸

--lazy — set lazy mode (load apps in workers instead of master) 😴
--lazy-apps — load apps in each worker instead of the master 😴
--cheap — set cheap mode (spawn workers only after the first request) 🪙
--cheaper — set cheaper mode (adaptive process spawning) 📉
--cheaper-initial — set the initial number of processes to spawn in cheaper mode 🔢
--cheaper-algo — choose to algorithm used for adaptive process spawning 🧠
--cheaper-step — number of additional processes to spawn at each overload ➕
--cheaper-overload — increase workers after 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 total resident memory usage of all workers is higher than this limit 🧠✋
--cheaper-rss-limit-hard — if total workers resident memory usage is higher try to stop workers 🛑
--idle — set idle mode (put uWSGI in cheap mode after inactivity) 😴
--die-on-idle — shutdown uWSGI when idle 💀
--mount — load application under mountpoint ⛰️
--worker-mount — load application under mountpoint in the specified worker or after workers spawn 👷
--threads — run each worker in prethreaded mode with the specified number of threads 🧵
--thread-stacksize — set threads stacksize 📚
--threads-stacksize — set threads stacksize 📚
--thread-stack-size — set threads stacksize 📚
--threads-stack-size — set threads stacksize 📚
--vhost — enable virtualhosting mode (based on SERVER_NAME variable) 🏠
--vhost-host — enable virtualhosting mode (based on HTTP_HOST variable) 🏠

🦋 routing, my beloved 🦋

--route — add a route 🛣️
--route-host — add a route based on 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 condition 🤔
--route-if-not — add a route based on 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 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 condition 🏁
--final-route-if-not — add a final route based on 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 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 condition 🚨
--error-route-if-not — add an error route based on 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 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 condition 📨
--response-route-if-not — add a response route based on condition (negate version) 📨
--response-route-run — always run the specified response route action 📨
--router-list — list enabled routers 📋
--routers-list — list enabled routers 📋

🎀 error pages & websockets & clocks 🎀

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

lowkey the clock ones feel like a lil cliffhanger and that's because they ARE. more coming, bestie, don't go anywhere 🌈

--clocks-list — show off every clock that's currently enabled, bestie ⌚✨
--add-header — auto-slaps HTTP headers onto the response, no manual labour required 💖
--rem-header — auto-yeets the specified HTTP header out of the response 🗑️
--del-header — literally the same thing: auto-removes the specified HTTP header from the response
--collect-header — stores the specified response header into a request var (syntax: header var) 📥
--response-header-collect — yep, same energy: stores the specified response header in a request var (syntax: header var)
--pull-header — stores the specified response header in a request var and pulls it out of the response (syntax: header var) — it's giving "you can look but you can't keep it"
--check-static — peek for static files in the directory you named 📂
--check-static-docroot — peek for static files in the requested DOCUMENT_ROOT
--static-check — once again, check for static files in the specified directory (twins fr)
--static-map — maps a mountpoint to a static directory (or a file)
--static-map2 — like --static-map but it fully appends the requested resource onto the docroot
--static-skip-ext — skips the extension you name when doing staticfile checks 🙈
--static-index — if someone asks for a directory, search for the file you specify instead
--static-safe — skips security checks when the file lives under the path you gave
--static-cache-paths — drops resolved paths into the uWSGI cache for however many seconds you say 🗂️
--static-cache-paths-name — use the cache you named for static paths
--mimefile — set the mime types file path (default /etc/mime.types)
--mime-file — set the mime types file path (default /etc/mime.types) — same option, different spelling, iconic behaviour
--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 your regexp matches the static file translation, it goes 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 in the dir/prefix you name
--static-gzip-prefix — checks for a gzip version of all requested static files in the dir/prefix you name (same vibe, same job)
--static-gzip-ext — checks for a gzip version of all requested static files with the ext/suffix you name
--static-gzip-suffix — checks for a gzip version of all requested static files with the ext/suffix you name
--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) — singular name, same energy
--file-serve-mode — set the static file serving mode
--fileserve-mode — set the static file serving mode (yes bestie, it's the same thing)
--disable-sendfile — disables sendfile() and leans on boring old read()/write() instead 😴
--check-cache — check 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 inside requests)
--close-on-exec2 — sets close-on-exec on server sockets (could be required for spawning processes inside requests)
--mode — set a uWSGI custom mode
--env — set an environment variable 🌱
--envdir — load a daemontools-compatible envdir
--early-envdir — load a daemontools-compatible envdir ASAP ⚡
--unenv — unset an environment variable 🚫
--vacuum — tries to remove every generated file/socket when it's done 🧹
--file-write — writes the content you give to the file you give (syntax: file=value) before privileges get dropped
--cgroup — put the processes into the cgroup you name
--cgroup-opt — set a value in the cgroup option you name
--cgroup-dir-mode — sets permission for the cgroup directory (default is 700) 🔐
--namespace — run in a new namespace under the specified rootfs
--namespace-keep-mount — keep the mountpoint you name in your namespace
--ns — run in a new namespace under the specified rootfs (short king 👑)
--namespace-net — add a network namespace
--ns-net — add a network namespace (same one, snappier name)
--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 — enables the TCP_FASTOPEN flag on TCP sockets with the qlen value you give
--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 UNIX socket you name
--cron — add a cron task ⏰
--cron2 — add a cron task (key=val syntax)
--unique-cron — add a unique cron task
--cron-harakiri — sets the max time (in seconds) we wait for a cron command to finish
--legion-cron — add a cron task that only runs when the instance is a lord of the legion you name ⚔️
--cron-legion — add a cron task that only runs when the instance is a lord of the legion you name
--unique-legion-cron — add a unique cron task that only runs when the instance is a lord of the legion you name
--unique-cron-legion — add a unique cron task that only runs when the instance is a lord of the legion you name
--loop — select the uWSGI loop engine 🔁
--loop-list — list the loop engines that are enabled
--loops-list — list the loop engines that are enabled (plural, same list)
--worker-exec — run the command you name as a worker
--worker-exec2 — run the command you name as a worker (after the post_fork hook)
--attach-daemon — attach a command/daemon to the master process (the command has to not go into the background)
--attach-control-daemon — attach a command/daemon to the master process (the command has to not go into the background); when the daemon dies, the master dies too 💀
--smart-attach-daemon — attach a command/daemon to the master process managed by a pidfile (the command has to daemonize)
--smart-attach-daemon2 — attach a command/daemon to the master process managed by a pidfile (the command has to NOT daemonize)
--legion-attach-daemon — same as --attach-daemon but 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 — do 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 the plugins that are enabled
--plugin-list — list the plugins that are enabled
--autoload — try to automatically load plugins when it bumps into unknown options ✨
--dlopen — blindly load a shared library 🙈
--allowed-modifiers — a comma-separated list of allowed modifiers
--remap-modifier — remap a request modifier from one id to another
--dump-options — dump the whole list of available options
--show-config — show the current config reformatted as ini
--binary-append-data — return the content of a resource to stdout for appending to a uwsgi binary (for data:// usage)
--print — simple print 🖨️
--iprint — simple print, immediate version ⚡
--exit — force an exit() of the instance 🚪
--cflags — report the 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 the uWSGI version
--response-headers-limit — set the response header maximum size (default: 64k)

And that's a wrap on the options, bestie 🎀 you just read through a lot of them and honestly? slay. This page is from uwsgi_alarm_xmpp version 2.0.31-debian, dated July 2026, and it's filed under UWSGI_ALARM_XMPP(1). Go forth and sysadmin like the main character you are 💅🌈👑

📦 where this page comes from

ubuntu stonking: uwsgi-plugin-alarm-xmpp 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