UWSGI_ALARM_CURL(1)

📦

version 2.0.31 · 7 versions

💖 UWSGI_ALARM_CURL(1) 💖

okay bestie, this is the User Commands manual page for uwsgi_alarm_curl, and it's lowkey iconic. no cap, we're about to go through all the flags. periodt. 💅

✨ NAME ✨

uwsgi_alarm_curl — it's giving fast (pure C), self-healing, developer-friendly WSGI server. literally the whole package. 🫶

🌸 SYNOPSIS 🌸

uwsgi-core [options...]

💅 DESCRIPTION 💅

okay so here's the vibe: you got a million options and every single one matters. let's get into it, bestie. don't skip a single one, because we keep all the details. ✨

-s, --socket — bind to the specified UNIX/TCP socket using default protocol 🌈
-s, --uwsgi-socket — bind to the specified UNIX/TCP socket using uwsgi protocol 💖
--suwsgi-socket — bind to the specified UNIX/TCP socket using uwsgi protocol over SSL 🔒
--ssl-socket — bind to the specified UNIX/TCP socket using uwsgi protocol over SSL ✨
--http-socket — bind to the specified UNIX/TCP socket using HTTP protocol 🌐
--http-socket-modifier1 — force the specified modifier1 when using HTTP protocol 💅
--http-socket-modifier2 — force the specified modifier2 when using HTTP protocol 💅
--http11-socket — bind to the specified UNIX/TCP socket using HTTP 1.1 (Keep-Alive) protocol 🔁
--https-socket — bind to the specified UNIX/TCP socket using HTTPS protocol 🔐
--https-socket-modifier1 — force the specified modifier1 when using HTTPS protocol 💅
--https-socket-modifier2 — force the specified modifier2 when using HTTPS protocol 💅
--fastcgi-socket — bind to the specified UNIX/TCP socket using FastCGI protocol ⚡
--fastcgi-nph-socket — bind to the specified UNIX/TCP socket using FastCGI protocol (nph mode) ⚡
--fastcgi-modifier1 — force the specified modifier1 when using FastCGI protocol 💅
--fastcgi-modifier2 — force the specified modifier2 when using FastCGI protocol 💅
--scgi-socket — bind to the specified UNIX/TCP socket using SCGI protocol 🌀
--scgi-nph-socket — bind to the specified UNIX/TCP socket using SCGI protocol (nph mode) 🌀
--scgi-modifier1 — force the specified modifier1 when using SCGI protocol 💅
--scgi-modifier2 — force the specified modifier2 when using SCGI protocol 💅
--raw-socket — bind to the specified UNIX/TCP socket using RAW protocol 🧪
--raw-modifier1 — force the specified modifier1 when using RAW protocol 💅
--raw-modifier2 — force the specified modifier2 when using RAW protocol 💅
--puwsgi-socket — bind to the specified UNIX/TCP socket using persistent uwsgi protocol (puwsgi) 🔁
--protocol — force the specified protocol for default sockets 💫
--socket-protocol — force the specified protocol for default sockets 💫
--shared-socket — create a shared socket for advanced jailing or ipc 🤝
--undeferred-shared-socket — create a shared socket for advanced jailing or ipc (undeferred mode) 🤝
-p, --processes — spawn the specified number of workers/processes 👯
-p, --workers — spawn the specified number of workers/processes 👯
--thunder-lock — serialize accept() usage (if possible) ⚡
-t, --harakiri — set harakiri timeout 🗡️
--harakiri-verbose — enable verbose mode for harakiri 📢
--harakiri-graceful-timeout — interval between graceful harakiri attempt and a sigkill ⏳
--harakiri-graceful-signal — use this signal instead of sigterm for graceful harakiri attempts 🚦
--harakiri-queue-threshold — only trigger harakiri if queue is greater than this threshold 📊
--harakiri-no-arh — do not enable harakiri during after-request-hook 🚫
--no-harakiri-arh — do not enable harakiri during after-request-hook 🚫
--no-harakiri-after-req-hook — do not enable harakiri during after-request-hook 🚫
--backtrace-depth — set backtrace depth 🪜
--mule-harakiri — set harakiri timeout for mule tasks 🐴
-x, --xmlconfig — load config from xml file 📄
-x, --xml — load config from xml file 📄
--config — load configuration using the pluggable system 🔌
--fallback-config — re-exec uwsgi with the specified config when exit code is 1 🔄
--strict — enable strict mode (placeholder cannot be used) 🚨
--skip-zero — skip check of file descriptor 0 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) 🔍
--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 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 — writes the Emperor's pid into the file you point at. King needs a name tag bestie 💖
--emperor-tyrant — flips the Emperor into Tyrant mode. Yeah the name is dramatic, that's the whole point.
--emperor-tyrant-nofollow — in Tyrant mode, do NOT follow symlinks while it's checking uid/gid. No shortcuts, no sneaky links 🚫
--emperor-stats — runs the Emperor stats server ✨
--emperor-stats-server — runs the Emperor stats server (same vibe, different spelling, both real)
--early-emperor — spawn the emperor ASAP, no waiting around 💅
--emperor-broodlord — runs the emperor in BroodLord mode 👑
--emperor-throttle — sets the throttling level, in milliseconds, for vassals that are acting up (default 1000)
--emperor-max-throttle — sets the MAX throttling level, in milliseconds, for vassals that are acting all the way up (default 3 minutes)
--emperor-magic-exec — prefixes vassals' config files with exec:// if they have the executable bit set 🪄
--emperor-on-demand-extension — searches for a text file named vassal name + extension that holds the on demand socket name
--emperor-on-demand-ext — searches for a text file named vassal name + extension that holds the on demand socket name (the short king version)
--emperor-on-demand-directory — turns on on demand mode, binding to the unix socket inside the directory you specify, named like the vassal + .socket
--emperor-on-demand-dir — same thing, shorter flag, same energy: on demand mode, unix socket in your directory, named like the vassal + .socket
--emperor-on-demand-exec — uses the output of the command you specify as the on demand socket name (your vassal's name gets passed in as the only argument)
--emperor-extra-extension — lets the Emperor accept the extension you specify (the vassal gets called with --config)
--emperor-extra-ext — lets the Emperor accept the extension you specify (and yep, the vassal gets called with --config)
--emperor-no-blacklist — disables the Emperor blacklisting subsystem entirely 🚫
--emperor-use-clone — uses clone() instead of fork(), passing along the unshare() flags you specify
--emperor-graceful-shutdown — vassals get a graceful shutdown during ragnarok 🕊️ (yes it really says ragnarok)
--emperor-cap — sets the vassals capability
--vassals-cap — sets the vassals capability
--vassal-cap — sets the vassals capability (three flags, one job, pick your fave)
--imperial-monitor-list — lists the enabled imperial monitors 👀
--imperial-monitors-list — lists the enabled imperial monitors (plural spelling gang)
--vassals-inherit — adds config templates to vassals config (it uses --inherit)
--vassals-include — includes config templates into vassals config (it 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 backup when the vassal is overloaded. literally screaming SOS 😭
--vassal-sos-backlog — asks the emperor for sos if the backlog queue has more items than the value you specify
--vassals-set — automatically sets the option you specify (via --set) for every vassal
--vassal-set — automatically sets the option you specify (via --set) for every vassal (singular flag, same deal)
--heartbeat — announces healthiness to the emperor 💓
--reload-mercy — sets the maximum time, in seconds, we wait for workers and other processes to die during reload/shutdown
--worker-reload-mercy — sets the maximum time, in seconds, a worker can take to reload/shutdown (default is 60)
--mule-reload-mercy — sets the maximum time, in seconds, a mule can take to reload/shutdown (default is 60)
--exit-on-reload — forces exit even if a reload was requested
--die-on-term — exits instead of doing a brutal reload on SIGTERM
--force-gateway — forces the spawn of the first registered gateway, no master needed
-h|--help — shows this help 🫶
-h|--usage — shows this help (yep, both spellings, same answer)
--print-sym — prints the content of the binary symbol you specify
--print-symbol — prints the content of the binary symbol you specify (the long way to say it)
-r|--reaper — calls waitpid(-1,...) after every request to get rid of zombies 🧟 slay
-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 must run before it can be reloaded (default is 10)
--max-worker-lifetime — reload workers after the specified amount of seconds (default is disabled)
--max-worker-lifetime-delta — adds (worker_id * delta) seconds to the max_worker_lifetime value of each worker
-z|--socket-timeout — sets 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 specified pages (heads up: it supports keyval too)
--safe-fd — do not close the file descriptor you specify
--fd-safe — do not close the file descriptor you specify (same protection, swapped order)
--cache — creates a shared cache holding the given elements
--cache-blocksize — sets the 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 this only for debug, bestie, it's chatty 🗣️)
--cache-udp-server — binds the cache udp server to the socket you specify (only used for set/update/delete)
--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 the shared queue
--queue-blocksize — sets the 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 — do not be verbose with spooler tasks 🤫
--spooler-max-tasks — sets 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 (shortened, same dial)
--mule — adds a mule 🐴
--mules — adds the number of mules you specify
--farm — adds a mule farm 🐴🐴🐴
--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 (plural variant, identical job)
--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 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, 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 (this happens before privileges drop)
--pidfile2 — creates a pidfile (this happens 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 — yep, underscore version, same rule)
--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 that get set via initgroups()
--cap — sets the process capability
--unshare — unshare()s part of the processes and drops them into a new namespace
--unshare2 — unshare()s part of the processes and drops them into 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 (short version, same skip)
--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 — stamps this instance as jailed 💅 and forces the post_jail hooks to actually fire. no jail left behind, periodt.
--refork — does a fork() again after privileges drop. lowkey iconic for jailing systems.
--re-fork — same thing, different spelling ✨ fork() again after privileges drop, and yes it's for jailing systems.
--refork-as-root — fork() again before privileges drop. also for jailing systems, bestie 🌸
--re-fork-as-root — the hyphenated twin 🫶 fork() again before privileges drop, built for jailing systems.
--refork-post-jail — fork() again after jailing. jailing systems, you know the vibe 👑
--re-fork-post-jail — same energy, extra hyphen 🎀 fork() again after jailing, for jailing systems.

okay so now we're in HOOK CITY and honestly? it's giving main character ✨ every one of these runs the specified hook at a different ✨moment✨ in the lifecycle.

🦋 the hook timing lore

--hook-asap — run the specified hook as soon as possible. literally the second it can 🏃‍♀️
--hook-pre-jail — run the specified hook before jailing.
--hook-post-jail — run the specified hook after jailing.
--hook-in-jail — run the specified hook in jail after initialization.
--hook-as-root — run the specified hook before privileges drop 👑
--hook-as-user — run the specified hook after privileges drop.
--hook-as-user-atexit — run the specified hook before app exit and reload.
--hook-pre-app — run the specified hook before app loading.
--hook-post-app — run the specified hook after app loading.
--hook-post-fork — run the specified hook after each fork 🍴
--hook-accepting — run the specified hook after each worker enter the accepting phase.
--hook-accepting1 — run the specified hook after the first worker enters the accepting phase 🥇
--hook-accepting-once — run the specified hook after each worker enter the accepting phase, but once per-instance (not once per worker, bestie).
--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 goes like this: (syntax: <file> <action>) 👀
--hook-emperor-start — run the specified hook when the Emperor starts.
--hook-emperor-stop — run the specified hook when the Emperor send a stop message.
--hook-emperor-reload — run the specified hook when the Emperor send a reload message.
--hook-emperor-lost — run the specified hook when the Emperor connection is lost 😭
--hook-as-vassal — run the specified hook before exec()ing the vassal.
--hook-as-emperor — run the specified hook in the emperor after the vassal has been started.
--hook-as-mule — run the specified hook in each mule 🐴
--hook-as-gateway — run the specified hook in each gateway 🚪
--after-request-hook — run the specified function/symbol after each request.
--after-request-call — run the specified function/symbol after each request. (yes bestie, same description, it's a real option, not a typo 💀)

🔥 exec squad, assemble

these run the specified command at every stage of the lifecycle:

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

🧚 mount / umount (filesystem fairy business)

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

🌸 waiting era (patience is a vibe)

--wait-for-interface — wait for the specified network interface to come up before running root hooks.
--wait-for-interface-timeout — set the timeout for wait-for-interface.
--wait-interface — wait for the specified network interface to come up before running root hooks.
--wait-interface-timeout — set the timeout for wait-for-interface.
--wait-for-iface — wait for the specified network interface to come up before running root hooks.
--wait-for-iface-timeout — set the timeout for wait-for-interface.
--wait-iface — wait for the specified network interface to come up before running root hooks.
--wait-iface-timeout — set the timeout for wait-for-interface.

bestie there are literally four spellings of the interface wait and four timeouts. they all do the same thing. i don't make the rules 💅

--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 squad (functions only, no shell)

these call the specified function at the vibe-appropriate moment:

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

see the numbers on the end? they're the arg count bestie, 1 = 1 arg, 2 = 2 args, 3 = 3 args, 4 = 4 args, no number = no args. slay 🫶

🎀 config files & instance identity

--ini — load config from ini file.
-y|--yaml — load config from yaml file.
-y|--yml — load config from yaml file.
-j|--json — load config from json file.
-j|--js — load config from json file.
--weight — weight of the instance (used by clustering/lb/subscriptions).
--auto-weight — set weight of the instance (used by clustering/lb/subscriptions) automatically.
--no-server — force no-server mode.
--command-mode — force command mode.

💜 socket & network tuning

--no-defer-accept — disable deferred-accept on sockets.
--tcp-nodelay — enable TCP NODELAY on each request.
--so-keepalive — enable TCP KEEPALIVEs.
--so-send-timeout — set SO_SNDTIMEO.
--socket-send-timeout — set SO_SNDTIMEO.
--so-write-timeout — set SO_SNDTIMEO.
--socket-write-timeout — set SO_SNDTIMEO.
--socket-sndbuf — set SO_SNDBUF.
--socket-rcvbuf — set SO_RCVBUF.
--shutdown-sockets — force calling shutdown() in addition to close() when sockets are destroyed.

🌈 memory & reload drama

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

🍓 touch me → reload me

--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 — it's giving watchdog energy.</p> When the file you named gets modified/touched, it raises a signal. Syntax is file signal, so you hand it both bestie: the path and the signal. 🎀
--fs-reload — if the filesystem object you specified gets modified, do a graceful reload. Softly softly, no drama. 🦋
--fs-brutal-reload — same vibe check, different ending: the filesystem object gets modified, so we do a brutal reload. No chill. Periodt. 💀
--fs-signal — filesystem object changes → raise a uwsgi signal. Syntax: file signal. ✨
--check-mountpoint — if a filesystem is no longer reachable, destroy the instance. Sounds harsh but it's genuinely useful for reliable Fuse management, iykyk. 💅
--mountpoint-check — literally the same thing as --check-mountpoint: filesystem unreachable → instance destroyed. Useful for reliable Fuse management. 🌸
--check-mount — okay so this is again the exact same deal. No filesystem, no instance. Useful for reliable Fuse management. 🫶
--mount-check — bestie this one is also the same: if the filesystem becomes unreachable, the instance gets destroyed. Useful for reliable Fuse management. Four options, one vibe. 👑
--propagate-touch — the manpage calls this "over-engineering option for system with flaky signal management." So like… a whole elaborate fit for a signal system that can't communicate. We love an overbuilt queen. 💜
--limit-post — put a cap on the request body. 🍓
--no-orphans — if the master dies, the workers get automatically killed. Keeping the family together, kind of. ⚠️ Heads up though: it can be dangerous for availability.
--prio — set the priority for your processes/threads. ✨
--cpu-affinity — set the cpu affinity. Pinning your faves to their seats. 🎀
--post-buffering — sets the size in bytes at which post buffering switches from memory to buffering to disk instead. So: past this many bytes, it's disk time. 💾
--post-buffering-bufsize — sets the buffer size used for read() while you're in post buffering mode. 🌈
--body-read-warning — sets how much memory allocation (in megabytes) is allowed for a request body before it starts printing a warning at you. It's giving concerned bestie. 😭
--upload-progress — turn on creation of .json files inside the directory you specify, while a file upload is happening. Watch it in real time. ✨
--no-default-app — do not fallback to the default app. Boundaries! 🚫
--manage-script-name — automatically rewrite SCRIPT_NAME and PATH_INFO for you. Queen behavior. 👑
--ignore-script-name — just ignore SCRIPT_NAME entirely. Not your problem, not your business. 🙈
--catch-exceptions — report the exception as http output. The manpage is very clear here: discouraged, use it only for testing. Testing-only, bestie, do not ship it. ⚠️
--reload-on-exception — when an exception is raised, reload that worker. Fresh start energy. 🔄
--reload-on-exception-type — reload the worker when a specific exception type is raised. Picky and valid. 💅
--reload-on-exception-value — reload the worker when a specific exception value is raised. 🎯
--reload-on-exception-repr — reload the worker when a specific exception type+value (language-specific, so this is speaking your app's language) is raised. 🌸
--exception-handler — add an exception handler. 🫶
--enable-metrics — turn the metrics subsystem on. Numbers era begins. 🔥
--metric — add a custom metric. Make it yours. ⭐
--metric-threshold — add a metric threshold/alarm. When the number crosses the line, alarm goes off. 🚨
--metric-alarm — also adds a metric threshold/alarm. Same beautiful thing, different name. 💖
--alarm-metric — yep, another metric threshold/alarm. They really said "three names, one feature." 😭
--metrics-dir — export your metrics as text files into the directory you name. 🗂️
--metrics-dir-restore — restore the last value that was taken from the metrics dir. Picking up right where you left off. 💫
--metric-dir — export metrics as text files to the specified directory. (Yes, singular "metric". Yes, same thing. No, I don't make the rules.) 🎀
--metric-dir-restore — restore the last value taken from the metrics dir. Again, the singular twin. 🦋
--metrics-no-cores — disable generation of cores-related metrics. Bye to the cores numbers. 🙈

--udp — run the udp server on the address you specify. 📡
--stats — enable the stats server on the specified address. 🌟
--stats-server — also enables the stats server on the specified address. Same icon, same vibe. ✨
--stats-http — prefix the stats server json output with http headers. Fancy little hat on your json. 🎀
--stats-minified — minify the statistics json output. Compact queen. 💅
--stats-min — minify the statistics json output. The short nickname for the same thing. ⭐
--stats-push — push the stats json to the destination you specify. Sending it straight to its location. 📤
--stats-pusher-default-freq — set the default frequency of stats pushers. How often the pushing happens. ⏰
--stats-pushers-default-freq — set the default frequency of stats pushers. Plural spelling, same heartbeat. 🫶
--stats-no-cores — disable generation of cores-related stats. 🚫
--stats-no-metrics — do not include metrics in the stats output. Metrics stay out of this one. 🌸
--multicast — subscribe to the multicast group you specify. 📻
--multicast-ttl — set the multicast ttl. 🕰️
--multicast-loop — set the multicast loop. Default is 1. 🌈
--master-fifo — enable the master fifo. One little pipe, so much power. 🎀
--notify-socket — enable the notification socket. 🔔
--subscription-notify-socket — set the notification socket specifically for subscriptions. Same socket energy, subscriptions-only. ✉️
--legion — become a member of a legion. Yes, a legion. It's giving chosen family. ⚔️
--legion-mcast — become a member of a legion, but as a shortcut for multicast. Speedrun version. 🏃‍♀️
--legion-node — add a node to a legion. New member, welcome to the group chat. 💌
--legion-freq — set the frequency of legion packets. 💓
--legion-tolerance — set the tolerance of the legion subsystem. Grace has limits, bestie. ⚖️
--legion-death-on-lord-error — if one of the lord hooks fails, it declares itself a dead node for however many seconds you specify. Dramatic but documented. 💀
--legion-skew-tolerance — set 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. The crown comes off. 👋
--legion-setup — the action to call on legion setup. 🛠️
--legion-death — the action to call on legion death, which means shutdown of the instance. 😭
--legion-join — the action to call on legion join, which fires the first time quorum is reached. 🎉
--legion-node-joined — the action to call when a new node joins the legion. 🫶
--legion-node-left — the action to call when a node leaves the legion. 🥲
--legion-quorum — set the quorum of a legion. 🗳️
--legion-scroll — set the scroll of a legion. 📜
--legion-scroll-max-size — set the max size of the legion scroll buffer. 🗒️
--legion-scroll-list-max-size — set the max size of the legion scroll list buffer. Yes, that's a different buffer from the one above. 💅
--subscriptions-sign-check — set the digest algorithm and the 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 — when using unix sockets credentials, skip the signature check for the uid you specify. VIP pass. 🎟️
--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. Pick your fighter. ⚔️
--subscription-dotsplit — try to fallback to the next part (dot based) in the subscription key. Following the dots. 🔵
--subscribe-to — subscribe to the subscription server you specify. 🤝
--st — subscribe to the specified subscription server. Tiny name, big job. ✨
--subscribe — subscribe to the specified subscription server. The classic. 💖
--subscribe2 — subscribe to the specified subscription server using advanced keyval syntax. The sequel, and it's more sophisticated. 💅
--subscribe-freq — send the subscription announce at the interval you specify. ⏰
--subscription-tolerance — set the tolerance for subscription servers. 🫶
--unsubscribe-on-graceful-reload — force the unsubscribe request even during a graceful reload. No lingering subscriptions, we're leaving cleanly. 🚪
--start-unsubscribed — configure your subscriptions but don't actually send them. The manpage notes this is useful with master fifo. All dressed up, not going anywhere (yet). 👗
--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. Spill the tea on every handshake problem. ☕
--ssl-verify-depth — set the maximum certificate verification depth. How far down the chain we're willing to look. 🔍
--sni — add an SNI-governed SSL context. 🌸
--sni-dir — check for the cert/key/client_ca file in the directory you specify, and create a sni/ssl context on demand. Lazy loading but make it SSL. ✨
--sni-dir-ciphers — set the ssl ciphers for the sni-dir option. 🧚
--ssl-enable3 — enable SSLv3. The manpage says it plainly: insecure. ⚠️ Like, we're telling you for your own good.
--ssl-enable-sslv3 — enable SSLv3. Also insecure. Same warning, longer name. 💀
--ssl-enable-tlsv1 — enable TLSv1. Also insecure, bestie. Do not. 🚩
--ssl-option — set a raw ssl option, and it takes a numeric value. Raw and numeric, exactly as stated. 🔢
--sni-regexp — add an SNI-governed SSL context where the key is a regexp. Pattern-matching your way into SSL. 🧩
--ssl-tmp-dir — store ssl-related temp files in the directory you specify. 🗃️
--check-interval — set the interval (in seconds) of the master checks. ⏲️
--forkbomb-delay — when a forkbomb is detected, sleep for however many seconds you specified. 🛌
--binary-path — force the binary path. 🛣️
--privileged-binary-patch — patch the uwsgi binary with a new command, and this happens before the privileges drop. 💅
--unprivileged-binary-patch — patch the uwsgi binary with a new command, after the privileges drop. 🫶
--privileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments, before the privileges drop. Arguments included, no extra charge. 🎀
--unprivileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments, after the privileges drop. 🌈
--async — enable async mode with however many cores you specify. ⚡
--max-fd — set the maximum number of file descriptors. Heads up: this requires root privileges. 👑
--logto — set the logfile/udp address. 🪵
--logto2 — log to the file or udp address you specify, but after the privileges drop. 🫧
--log-format — set an advanced format for request logging. Customize your log fit. 💅
--logformat — set advanced format for request logging. The shorter twin. ⭐
--logformat-strftime — apply strftime to the logformat output. Time stamps, glam edition. 🕰️
--log-format-strftime — apply strftime to the logformat output. Hyphenated twin, same energy. ✨
--logfile-chown — chown the logfiles. 🧾
--logfile-chmod — chmod the logfiles. 🔐
--log-syslog — log to syslog. 📮
--log-socket — send logs to the socket you specify. 🕳️
--req-logger — set/append a request logger. 📝
--logger-req — set/append a request logger. Yes, it's the same thing with the words swapped. Both real, both listed. 😭
--logger — set/append a logger. The general-purpose one. 🪄
--logger-list — list the enabled loggers. 📋
--loggers-list — list the enabled loggers. Plural twins, we stay consistent. 💖
--threaded-logger — offload log writing to a thread. Logs, but make it a background task. 🧵
--log-encoder — add an item in the log encoder chain. One link at a time. ⛓️
--log-req-encoder — add an item in the log req encoder chain. The request-specific chain. 🔗
--log-drain — drain (meaning: do not show) log lines that match the regexp you specify. Swept away, never seen. 🌊
--log-filter — show only the log lines matching the regexp you specify. Cherry-picked. 🍒
--log-route — log to the named logger you specify, if the regexp applied on the logline matches. Goes to the right place only when it qualifies. 🚏
--log-req-route — log requests to the named logger you specify, if the regexp applied on the logline matches. Request-logging edition. 📬
--use-abort — call abort() on segfault/fpe. The manpage says this could be useful for generating a core dump. 🧨
--alarm — create a new alarm. Syntax: <alarm> <plugin:args>. Alarm era, activated. 🚨
--alarm-cheap — use the main alarm thread instead of spinning up dedicated threads for curl-based alarms 🧵 no cap, saves you a whole thread-spawning situation
--alarm-freq — tunes the anti-loop alarm system (default 3 seconds) ⏰ it's giving "chill, don't spiral"
--alarm-fd — raise the specified alarm when an fd is read for read (by default it reads 1 byte, set it to 8 for eventfd) 👀
--alarm-segfault — raise the specified alarm when the segmentation fault handler is executed 💀 iconic crash-notification behaviour
--segfault-alarm — raise the specified alarm when the segmentation fault handler is executed 💀 yeah bestie this is the same thing, two names, one vibe
--alarm-backlog — raise the specified alarm when the socket backlog queue is full 😭 the queue said "I'm 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 🔔

ok so that backlog thing has six whole aliases and honestly? iconic. pick whichever one your fingers remember.

--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> 🙅‍♀️ the negation girlie
--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 📋✨ (the plural version, we love options)
--alarm-msg-size — set the max size of an alarm message (default 8192)

🪵 the logging era

--log-master — delegate logging to the master process 👑
--log-master-bufsize — set the buffer size for the master logger. bigger log messages will be truncated ✂️ rip to your long logs
--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 🗑️ fresh start energy
--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 👻 empty-body representation
--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 ⏱️ tiny numbers, huge precision
--log-x-forwarded-for — use the ip from X-Forwarded-For header instead of REMOTE_ADDR 🌐

🏃 privileges, directories & the working-dir of it all

--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 🚪
--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) 🏠

🛣️ routes, routes & more routes (the whole trilogy)

the regular route girlies

--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 routes (the dramatic finale)

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

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

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

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

okay we're still going through the options list bestie, buckle up 💅

--clocks-list — lists all the enabled clocks ⏰
--add-header — automatically adds HTTP headers to the response 🎀
--rem-header — automatically removes the HTTP header you named from the response 🫥
--del-header — same energy: automatically removes the specified HTTP header from the response 🙈
--collect-header — stashes the specified response header into a request var, syntax is header var 💾
--response-header-collect — literally the same deal, stores the specified response header in a request var, syntax header var ✨
--pull-header — stores that response header in a request var and rips it out of the response, syntax header var 🔥
--check-static — checks for static files in the directory you specify 📁
--check-static-docroot — checks for static files in the requested DOCUMENT_ROOT 🏠
--static-check — yep, again: checks for static files in the directory you specify 📂
--static-map — maps a mountpoint to a static directory (or a file) 🗺️
--static-map2 — like static-map but it completely appends the requested resource to the docroot
--static-skip-ext — skips the extension you name when doing staticfile checks 🚫
--static-index — if a directory gets requested, it searches for the file you specify
--static-safe — skips the security checks when the file lives under the path you specify 🛡️
--static-cache-paths — drops resolved paths into the uWSGI cache for however many seconds you say ⏳
--static-cache-paths-name — uses the cache you name for static paths
--mimefile — sets the mime types file path (default /etc/mime.types) 📄
--mime-file — same thing, sets the mime types file path (default /etc/mime.types)
--static-expires-type — sets the Expires header based on content type
--static-expires-type-mtime — sets the Expires header based on content type and file mtime
--static-expires — sets the Expires header based on filename regexp
--static-expires-mtime — sets the Expires header based on filename regexp and file mtime
--static-expires-uri — sets the Expires header based on REQUEST_URI regexp
--static-expires-uri-mtime — sets the Expires header based on REQUEST_URI regexp and file mtime
--static-expires-path-info — sets the Expires header based on PATH_INFO regexp
--static-expires-path-info-mtime — sets the Expires header based on PATH_INFO regexp and file mtime
--static-gzip — if the regexp you supplied matches the static file translation, it goes looking for a gzip version 🗜️
--static-gzip-all — checks for a gzip version of all requested static files
--static-gzip-dir — checks for a gzip version of all requested static files in the dir/prefix you specify
--static-gzip-prefix — checks for a gzip version of all requested static files in the dir/prefix you specify
--static-gzip-ext — checks for a gzip version of all requested static files with the ext/suffix you specify
--static-gzip-suffix — checks for a gzip version of all requested static files with the ext/suffix you specify
--honour-range — enables support for the HTTP Range header 📏
--offload-threads — sets how many offload threads to spawn (per-worker, default 0)
--offload-thread — sets how many offload threads to spawn (per-worker, default 0)
--file-serve-mode — sets the static file serving mode
--fileserve-mode — sets the static file serving mode
--disable-sendfile — disables sendfile() and makes it rely on boring old read()/write() 💀
--check-cache — checks for response data in the cache you specify (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 — sets the uWSGI custom mode
--env — sets an environment variable 🌱
--envdir — loads a daemontools compatible envdir
--early-envdir — loads a daemontools compatible envdir ASAP ⚡
--unenv — unsets an environment variable
--vacuum — tries to remove all of the generated file/sockets 🧹
--file-write — writes the content you give to the file you name (syntax: file=value) before the privileges drop ✍️
--cgroup — puts the processes in 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 in a new namespace under the rootfs you specify 📦
--namespace-keep-mount — keeps the mountpoint you specify inside your namespace
--ns — runs in a new namespace under the rootfs you specify
--namespace-net — adds a network namespace 🌐
--ns-net — adds a network namespace
--enable-proxy-protocol — enables PROXY1 protocol support (only for http parsers!) 🎯
--reuse-port — enables the REUSE_PORT flag on the socket (BSD only) 🍎
--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 — 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 specify
--cron — adds a cron task ⏲️
--cron2 — adds a cron task (key=val syntax)
--unique-cron — adds a unique cron task
--cron-harakiri — sets the maximum time (in seconds) we wait for a cron command to complete ⌛
--legion-cron — adds a cron task that's runnable only when the instance is a lord of the legion you specify 👑
--cron-legion — adds a cron task that's runnable only when the instance is a lord of the legion you specify
--unique-legion-cron — adds a unique cron task runnable only when the instance is a lord of the legion you specify
--unique-cron-legion — adds a unique cron task runnable only when the instance is a lord of the legion you specify
--loop — selects the uWSGI loop engine 🔁
--loop-list — lists the enabled loop engines
--loops-list — lists the enabled loop engines
--worker-exec — runs the command you specify as a worker 🔧
--worker-exec2 — runs the command you specify as a worker (after the post_fork hook)
--attach-daemon — attaches a command/daemon to the master process (heads up: the command has to not go in the background!)
--attach-control-daemon — attaches a command/daemon to the master process (the command has to not go in background), and when the daemon dies, the master dies too 💀
--smart-attach-daemon — attaches a command/daemon to the master process managed by a pidfile (the command has to daemonize)
--smart-attach-daemon2 — attaches a command/daemon to the master process managed by a pidfile (the command has to NOT daemonize)
--legion-attach-daemon — same as --attach-daemon but the daemon only runs on the legion lord node 👑
--legion-smart-attach-daemon — same as --smart-attach-daemon but the daemon runs only on the legion lord node
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2 but the daemon runs only on the legion lord node
--daemons-honour-stdin — doesn't change the stdin of external daemons to /dev/null 🫶
--attach-daemon2 — the attach-daemon keyval variant (supports smart modes too)
--plugins — loads uWSGI plugins 🔌
--plugin — loads uWSGI plugins
--need-plugins — loads uWSGI plugins (exits on error) 🚨
--need-plugin — loads uWSGI plugins (exits on error)
--plugins-dir — adds a directory to the uWSGI plugin search path 🗂️
--plugin-dir — adds a directory to the uWSGI plugin search path
--plugins-list — lists the enabled plugins
--plugin-list — lists the enabled plugins
--autoload — tries to automatically load plugins when unknown options are found 🕵️
--dlopen — blindly loads a shared library 🙈
--allowed-modifiers — comma separated list of the allowed modifiers
--remap-modifier — remaps a request modifier from one id to another
--dump-options — dumps the full list of available options 🗒️
--show-config — shows the current config reformatted as ini ✨
--binary-append-data — returns the content of a resource to stdout for appending to a uwsgi binary (for data:// usage)
--print — a simple print 🖨️
--iprint — a simple print, but the immediate version ⚡
--exit — forces exit() of the instance 🚪
--cflags — reports the uWSGI CFLAGS (super 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 thing bestie, you made it to the end 🎉 this page is from uwsgi_alarm_curl version 2.0.31-debian, dated July 2026, and it's the UWSGI_ALARM_CURL(1) manual page 🫶 now go configure something iconic, mwah 💅💖

📦 where this page comes from

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