UWSGI_CURL_CRON(1)

📦

version 2.0.31 · 7 versions

🌸 NAME 🌸

uwsgi_curl_cron — a fast (pure C), self-healing, developer-friendly WSGI server 💅✨

🎀 SYNOPSIS 🎀

uwsgi-core [options...]

like. that's it. that's the whole vibe. you run uwsgi-core, you hand it [options...], and you go 🦋

💖 DESCRIPTION 💖

okay bestie, first things first: this page right here is UWSGI_CURL_CRON(1), pulled straight out of the User Commands corner of the manual, and what follows is a LOT of options. like, a lot a lot. some of them are literally the same thing wearing a different name (uWSGI is an icon who believes in options, we respect that 🫶), and every single one is listed below. no cap. let's get into it.

heads up: every bullet here is a flag you can pass, and the literal option names are sacred — copy them exactly, don't freestyle 💀

🧦 the sockets section (where everything starts)

-s, --socket — bind to the specified UNIX/TCP socket using the default protocol
-s, --uwsgi-socket — bind to the specified UNIX/TCP socket, but using the uwsgi protocol specifically
--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, but in 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, in 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 (yes, same energy, different flag name 😌)
--shared-socket — create a shared socket for advanced jailing or ipc
--undeferred-shared-socket — create a shared socket for advanced jailing or ipc, but in undeferred mode

👑 workers, processes & the harakiri hall of fame

-p, --processes — spawn the specified number of workers/processes
-p, --workers — spawn the specified number of workers/processes (same thing, different alias, we love a duo)
--thunder-lock — serialize accept() usage (if possible) ⚡
-t, --harakiri — set the harakiri timeout
--harakiri-verbose — turn on 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 & the opt-logic girlies

-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 (this one is ignored by the master)
--skip-atexit-teardown — skip atexit teardown (also 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, syntax: placeholder=name (immediate option)
--for — (opt logic) for cycle
--for-glob — (opt logic) for cycle (expand glob)
--for-times — (opt logic) for cycle (expand the specified num to a list starting from 1)
--for-readline — (opt logic) for cycle (expand the specified file to a list of lines)
--endfor — (opt logic) end for cycle
--end-for — (opt logic) end for cycle
--if-opt — (opt logic) check for option
--if-not-opt — (opt logic) check for option
--if-env — (opt logic) check for environment variable
--if-not-env — (opt logic) check for environment variable
--ifenv — (opt logic) check for environment variable
--if-reload — (opt logic) check for reload
--if-not-reload — (opt logic) check for reload
--if-hostname — (opt logic) check for hostname
--if-not-hostname — (opt logic) check for hostname
--if-hostname-match — (opt logic) try to match hostname against a regular expression
--if-not-hostname-match — (opt logic) try to match hostname against a regular expression
--if-exists — (opt logic) check for file/directory existence
--if-not-exists — (opt logic) check for file/directory existence
--ifexists — (opt logic) check for file/directory existence
--if-plugin — (opt logic) check for plugin
--if-not-plugin — (opt logic) check for plugin
--ifplugin — (opt logic) check for plugin
--if-file — (opt logic) check for file existence
--if-not-file — (opt logic) check for file existence
--if-dir — (opt logic) check for directory existence
--if-not-dir — (opt logic) check for directory existence
--ifdir — (opt logic) check for directory existence
--if-directory — (opt logic) check for directory existence
--endif — (opt logic) end if
--end-if — (opt logic) end if
--blacklist — set options blacklist context
--end-blacklist — clear options blacklist context
--whitelist — set options whitelist context
--end-whitelist — clear options whitelist context

🙈 errors, signals & templates

--ignore-sigpipe — do not report the (annoying) SIGPIPE
--ignore-write-errors — do not report the (annoying) write()/writev() errors
--write-errors-tolerance — set the maximum number of allowed write errors (default: no tolerance — and bestie, that default means exactly what it sounds like 😭)
--write-errors-exception-only — only raise an exception on write errors, giving control to the app itself
--disable-write-exception — disable exception generation on write()/writev()
--inherit — use the specified file as a config template
--include — include the specified file as immediate configuration
--inject-before — inject a text file before the config file (advanced templating)
--inject-after — inject a text file after the config file (advanced templating)

🫡 daemon mode, instance management & the little knobs

-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 the 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 process names 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 the master process name
-i, --single-interpreter — do not use multiple interpreters (where available)
--need-app — exit if no app can be loaded
-M, --master — enable master process
--honour-stdin — do not remap stdin to /dev/null

🌈 the Emperor era (yes, it gets its own cluster, as it should)

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

and bestie… we are genuinely not even close to done yet 💀 there's more of this page coming, so don't you dare close the tab 🫶✨

✨ OPTIONS ✨

--emperor-pidfile — write the Emperor pid in the specified file 💖
--emperor-tyrant — put the Emperor in Tyrant mode 👑
--emperor-tyrant-nofollow — do not follow symlinks when checking for uid/gid in Tyrant mode 🙅‍♀️
--emperor-stats — run the Emperor stats server 📊
--emperor-stats-server — run the Emperor stats server 📊
--early-emperor — spawn the emperor as soon as possible ⏰
--emperor-broodlord — run the emperor in BroodLord mode 🐣
--emperor-throttle — set throttling level (in milliseconds) for bad behaving vassals (default 1000) 😤
--emperor-max-throttle — set max throttling level (in milliseconds) for bad behaving vassals (default 3 minutes) 🛑
--emperor-magic-exec — prefix vassals config files with exec:// if they have the executable bit ✨
--emperor-on-demand-extension — search for text file (vassal name + extension) containing the on demand socket name 🔍
--emperor-on-demand-ext — search for text file (vassal name + extension) containing the on demand socket name 🔍
--emperor-on-demand-directory — enable on demand mode binding to the unix socket in the specified directory named like the vassal + .socket 🔌
--emperor-on-demand-dir — enable on demand mode binding to the unix socket in the specified directory named like the vassal + .socket 🔌
--emperor-on-demand-exec — use the output of the specified command as on demand socket name (the vassal name is passed as the only argument) 🏃‍♀️
--emperor-extra-extension — allows the specified extension in the Emperor (vassal will be called with --config) 📁
--emperor-extra-ext — allows the specified extension in the Emperor (vassal will be called with --config) 📁
--emperor-no-blacklist — disable Emperor blacklisting subsystem 🚫
--emperor-use-clone — use clone() instead of fork() passing the specified unshare() flags 🧬
--emperor-graceful-shutdown — use vassals graceful shutdown during ragnarok 🌅
--emperor-cap — set vassals capability 🎩
--vassals-cap — set vassals capability 🎩
--vassal-cap — set vassals capability 🎩
--imperial-monitor-list — list enabled imperial monitors 📋
--imperial-monitors-list — list enabled imperial monitors 📋
--vassals-inherit — add config templates to vassals config (uses --inherit) 🧬
--vassals-include — include config templates to vassals config (uses --include instead of --inherit) 🧬
--vassals-inherit-before — add config templates to vassals config (uses --inherit, parses before the vassal file) 🧬
--vassals-include-before — include config templates to vassals config (uses --include instead of --inherit, parses before the vassal file) 🧬
--vassals-start-hook — run the specified command before each vassal starts 🏁
--vassals-stop-hook — run the specified command after vassal's death ⚰️
--vassal-sos — ask emperor for reinforcement when overloaded 🆘
--vassal-sos-backlog — ask emperor for sos if backlog queue has more items than the value specified 🆘
--vassals-set — automatically set the specified option (via --set) for every vassal ⚙️
--vassal-set — automatically set the specified option (via --set) for every vassal ⚙️
--heartbeat — announce healthiness to the emperor 💓
--reload-mercy — set the maximum time (in seconds) we wait for workers and other processes to die during reload/shutdown 🕊️
--worker-reload-mercy — set the maximum time (in seconds) a worker can take to reload/shutdown (default is 60) 🕊️
--mule-reload-mercy — set the maximum time (in seconds) a mule can take to reload/shutdown (default is 60) 🕊️
--exit-on-reload — force exit even if a reload is requested 🚪
--die-on-term — exit instead of brutal reload on SIGTERM 💀
--force-gateway — force the spawn of the first registered gateway without a master 🚪
-h|--help — show this help 🆘
-h|--usage — show this help 🆘
--print-sym — print content of the specified binary symbol 🔣
--print-symbol — print content of the specified binary symbol 🔣
-r|--reaper — call waitpid(-1,...) after each request to get rid of zombies 🧟
-R|--max-requests — reload workers after the specified amount of managed requests 🔄
--max-requests-delta — add (worker_id * delta) to the max_requests value of each worker ➕
--min-worker-lifetime — number of seconds worker must run before being reloaded (default is 10) ⏳
--max-worker-lifetime — reload workers after the specified amount of seconds (default is disabled) ⏳
--max-worker-lifetime-delta — add (worker_id * delta) seconds to the max_worker_lifetime value of each worker ➕
-z|--socket-timeout — set internal sockets timeout ⏱️
--no-fd-passing — disable file descriptor passing 🚫
--locks — create the specified number of shared locks 🔒
--lock-engine — set the lock engine 🔧
--ftok — set the ipcsem key via ftok() for avoiding duplicates 🔑
--persistent-ipcsem — do not remove ipcsem's on shutdown 🧊
-A|--sharedarea — create a raw shared memory area of specified pages (note: it supports keyval too) 🧠
--safe-fd — do not close the specified file descriptor 🔐
--fd-safe — do not close the specified file descriptor 🔐
--cache — create a shared cache containing given elements 🗃️
--cache-blocksize — set cache blocksize 🧱
--cache-store — enable persistent cache to disk 💾
--cache-store-sync — set frequency of sync for persistent cache 🔄
--cache-no-expire — disable auto sweep of expired items 🧹
--cache-expire-freq — set the frequency of cache sweeper scans (default 3 seconds) 🧹
--cache-report-freed-items — constantly report the cache item freed by the sweeper (use only for debug) 🐞
--cache-udp-server — bind the cache udp server (used only for set/update/delete) to the specified socket 📡
--cache-udp-node — send cache update/deletion to the specified cache udp server 📡
--cache-sync — copy the whole content of another uWSGI cache server on server startup 🗃️
--cache-use-last-modified — update last_modified_at timestamp on every cache item modification (default is disabled) 🕒
--add-cache-item — add an item in the cache ➕
--load-file-in-cache — load a static file in the cache 📄
--load-file-in-cache-gzip — load a static file in the cache with gzip compression 🗜️
--cache2 — create a new generation shared cache (keyval syntax) 🗃️
--queue — enable shared queue 📬
--queue-blocksize — set queue blocksize 🧱
--queue-store — enable persistent queue to disk 💾
--queue-store-sync — set frequency of sync for persistent queue 🔄
-Q|--spooler — run a spooler on the specified directory 🧵
--spooler-external — map spoolers requests to a spooler directory managed by an external instance 🌐
--spooler-ordered — try to order the execution of spooler tasks 🔢
--spooler-chdir — chdir() to specified directory before each spooler task 📂
--spooler-processes — set the number of processes for spoolers 🧵
--spooler-quiet — do not be verbose with spooler tasks 🤫
--spooler-max-tasks — set the maximum number of tasks to run before recycling a spooler 🔄
--spooler-harakiri — set harakiri timeout for spooler tasks 🗡️
--spooler-frequency — set spooler frequency ⏱️
--spooler-freq — set spooler frequency ⏱️
--mule — add a mule 🐴
--mules — add the specified number of mules 🐴
--farm — add a mule farm 🚜
--mule-msg-size — set mule message buffer size 📨
--signal — send a uwsgi signal to a server 📶
--signal-bufsize — set buffer size for signal queue 📶
--signals-bufsize — set buffer size for signal queue 📶
--signal-timer — add a timer (syntax: <signal> <seconds>) ⏲️
--timer — add a timer (syntax: <signal> <seconds>) ⏲️
--signal-rbtimer — add a redblack timer (syntax: <signal> <seconds>) ⏲️
--rbtimer — add a redblack timer (syntax: <signal> <seconds>) ⏲️
--rpc-max — maximum number of rpc slots (default: 64) 📞
-L|--disable-logging — disable request logging 🔇
--flock — lock the specified file before starting, exit if locked 🔒
--flock-wait — lock the specified file before starting, wait if locked 🔒
--flock2 — lock the specified file after logging/daemon setup, exit if locked 🔒
--flock-wait2 — lock the specified file after logging/daemon setup, wait if locked 🔒
--pidfile — create pidfile (before privileges drop) 📄
--pidfile2 — create pidfile (after privileges drop) 📄
--safe-pidfile — create safe pidfile (before privileges drop) 📄
--safe-pidfile2 — create safe pidfile (after privileges drop) 📄
--chroot — chroot() to the specified directory 🏰
--pivot-root — pivot_root() to the specified directories (new_root and put_old must be separated with a space) 🔄
--pivot_root — pivot_root() to the specified directories (new_root and put_old must be separated with a space) 🔄
--uid — setuid to the specified user/uid 👤
--gid — setgid to the specified group/gid 👥
--add-gid — add the specified group id to the process credentials ➕
--immediate-uid — setuid to the specified user/uid IMMEDIATELY ⚡
--immediate-gid — setgid to the specified group/gid IMMEDIATELY ⚡
--no-initgroups — disable additional groups set via initgroups() 🚫
--cap — set process capability 🎩
--unshare — unshare() part of the processes and put it in a new namespace 🧬
--unshare2 — unshare() part of the processes and put it in a new namespace after rootfs change 🧬
--setns-socket — expose a unix socket returning namespace fds from /proc/self/ns 🔌
--setns-socket-skip — skip the specified entry when sending setns file descriptors ⏭️
--setns-skip — skip the specified entry when sending setns file descriptors ⏭️
--setns — join a namespace created by an external uWSGI instance 🚪
--setns-preopen — open /proc/self/ns as soon as possible and cache fds 🗂️
--jailed — okay so this marks the instance as jailed, which forces the post_jail hooks to actually run. it's giving "I'm in jail, do the thing" energy 💅
--refork — fork() again after privileges drop. super useful for jailing systems, bestie 🫶
--re-fork — same vibe as --refork: fork() again after privileges drop. jailing systems love this ✨
--refork-as-root — fork() again before privileges drop. also for jailing systems, iconic behavior 🔥
--re-fork-as-root — literally the same as --refork-as-root: fork() again before privileges drop. jailing systems stay winning 💅
--refork-post-jail — fork() again after jailing. jailing systems, this one's for you 🧚
--re-fork-post-jail — twin of --refork-post-jail: fork() again after jailing. for all the jailing systems out there 💖
--hook-asap — run the specified hook as soon as possible. no waiting, 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 ✨
--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 🌐
--wait-interface-timeout — set the timeout for wait-for-interface ⏳
--wait-for-iface — wait for the specified network interface to come up before running root hooks 🌐
--wait-for-iface-timeout — set the timeout for wait-for-interface ⏳
--wait-iface — wait for the specified network interface to come up before running root hooks 🌐
--wait-iface-timeout — set the timeout for wait-for-interface ⏳
--wait-for-fs — wait for the specified filesystem item to appear before running root hooks 📁
--wait-for-file — wait for the specified file to appear before running root hooks 📄
--wait-for-dir — wait for the specified directory to appear before running root hooks 📂
--wait-for-mountpoint — wait for the specified mountpoint to appear before running root hooks 📍
--wait-for-fs-timeout — set the timeout for wait-for-fs/file/dir ⏳
--wait-for-socket — wait for the specified socket to be ready before loading apps 🔌
--wait-for-socket-timeout — set the timeout for wait-for-socket ⏳
--call-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 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 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 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-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 — filesystem watch duty activated ✨ whenever the file you point at gets modified or touched, it fires off a signal. Syntax is literally file signal 🎀
--fs-reload — when the filesystem object you named gets modified, do a graceful reload 🦋 smooth, polite, immaculate.
--fs-brutal-reload — same vibe check, zero chill: filesystem object changes → brutal reload 💀
--fs-signal — when that filesystem object gets modified, raise a uwsgi signal. Syntax: file signal 🌸
--check-mountpoint — if a filesystem is no longer reachable, the instance gets destroyed. Genuinely useful for reliable Fuse management 👑
--mountpoint-check — bestie this is the exact same thing as --check-mountpoint: filesystem unreachable → instance destroyed, and yes it's for reliable Fuse management 💅
--check-mount — yep, another alias. Filesystem no longer reachable → destroy the instance, useful for reliable Fuse management 🦋
--mount-check — the fourth and final twin of this little quartet. Unreachable filesystem → destroyed instance, reliable Fuse management, periodt 💜
--propagate-touch — an over-engineering option for systems with flaky signal management 🙈 like, it exists specifically for that chaos.
--limit-post — limit the request body. Cap it. Set the boundary 🔥
--limit-post, --no-orphans girlies listen up — wait no, real talk: --no-orphans automatically kills workers if the master dies. Can be dangerous for availability, so know what you're doing ⚠️
--prio — set the priority of processes/threads 🎀
--cpu-affinity — set CPU affinity. Pin those babies down 💅
--post-buffering — set the size in bytes after which it buffers to disk instead of memory 🧚
--post-buffering-bufsize — set the buffer size for read() in post buffering mode 🌸
--body-read-warning — set how much memory allocation (in megabytes) is allowed for a request body before it starts printing a warning 👀
--upload-progress — enable creation of .json files in the specified directory during a file upload ✨ like, live updates on the upload, we love to see it.
--no-default-app — do not fall back to the default app. No safety net, no plan B 💀
--manage-script-name — automatically rewrite SCRIPT_NAME and PATH_INFO for you 🫶 it's giving helpful.
--ignore-script-name — ignore SCRIPT_NAME entirely 🙈
--catch-exceptions — report exceptions as http output. Discouraged — use only for testing 🔥 do not ship this, bestie.
--reload-on-exception — an exception gets raised → the worker reloads 👑
--reload-on-exception-type — reload a worker when a specific exception type is raised 🎀
--reload-on-exception-value — reload a worker when a specific exception value is raised 💜
--reload-on-exception-repr — reload a worker when a specific exception type + value (language-specific) is raised 🦋
--exception-handler — add an exception handler. Catch it, handle it, slay 🌸

--enable-metrics — turn the metrics subsystem on 💅
--metric — add a custom metric, your own little number to obsess over ✨
--metric-threshold — add a metric threshold/alarm 🚨
--metric-alarm — add a metric threshold/alarm (same thing, different name, iconic) 🔥
--alarm-metric — and once more for the people in the back: add a metric threshold/alarm 💀
--metrics-dir — export metrics as text files into the specified directory 🎀
--metrics-dir-restore — restore the last value taken from the metrics dir 🦋
--metric-dir — export metrics as text files into the specified directory (singular metric, same energy) 💜
--metric-dir-restore — restore last value taken from the metrics dir 🌸
--metrics-no-cores — disable generation of cores-related metrics 🙈
--udp — run the udp server on the specified address 📡
--stats — enable the stats server on the specified address 👑
--stats-server — enable the stats server on the specified address (the alias said "me too") 💅
--stats-http — prefix the stats server json output with http headers 🌐
--stats-minified — minify the statistics json output, compact queen ✨
--stats-min — minify statistics json output, the short name version 🎀
--stats-push — push the stats json to the specified destination 🚀
--stats-pusher-default-freq — set the default frequency of stats pushers ⏱️
--stats-pushers-default-freq — set the default frequency of stats pushers (plural pushers, same deal) 💜
--stats-no-cores — disable generation of cores-related stats 🙈
--stats-no-metrics — do not include metrics in the stats output 🦋
--multicast — subscribe to the specified multicast group 📻
--multicast-ttl — set the multicast ttl 🌸
--multicast-loop — set multicast loop (default 1) 🔁
--master-fifo — enable the master fifo 🎀
--notify-socket — enable the notification socket 🔔
--subscription-notify-socket — set the notification socket for subscriptions 📬

--legion — became a member of a legion ⚔️ main character energy fr.
--legion-mcast — became a member of a legion, but as a shortcut for multicast 🦋
--legion-node — add a node to a legion 👑
--legion-freq — set the frequency of legion packets 📡
--legion-tolerance — set the tolerance of the legion subsystem 💜
--legion-death-on-lord-error — if one of the lord hooks fails, declare itself a dead node for the specified amount of seconds 💀 dramatic but valid.
--legion-skew-tolerance — set the clock skew tolerance of the legion subsystem (default 60 seconds) ⏱️
--legion-lord — action to call on Lord election 👑
--legion-unlord — action to call on Lord dismiss 👋
--legion-setup — action to call on legion setup 🛠️
--legion-death — action to call on legion death (shutdown of the instance) 🪦
--legion-join — action to call on legion join (first time quorum is reached) 🎉
--legion-node-joined — action to call on a new node joining the legion 🫶
--legion-node-left — action to call on a node leaving the legion 🚪
--legion-quorum — set the quorum of a legion 🗳️
--legion-scroll — set the scroll of a legion 📜
--legion-scroll-max-size — set the max size of the legion scroll buffer 📦
--legion-scroll-list-max-size — set the max size of the legion scroll list buffer 📚
--subscriptions-sign-check — set the digest algorithm and certificate directory for the secured subscription system 🔐
--subscriptions-sign-check-tolerance — set the maximum tolerance (in seconds) of clock skew for the secured subscription system ⏱️
--subscriptions-sign-skip-uid — skip the signature check for the specified uid when using unix sockets credentials 🙈
--subscriptions-credentials-check — add a directory to search for subscriptions key credentials 🔑
--subscriptions-use-credentials — enable management of SCM_CREDENTIALS in subscriptions UNIX sockets 🎀
--subscription-algo — set the load balancing algorithm for the subscription system ⚖️
--subscription-dotsplit — try to fall back to the next part (dot based) in the subscription key 🌸
--subscribe-to — subscribe to the specified subscription server 📬
--st — subscribe to the specified subscription server (short king) 💅
--subscribe — subscribe to the specified subscription server (the classic) ✨
--subscribe2 — subscribe to the specified subscription server using the advanced keyval syntax 🦋
--subscribe-freq — send the subscription announce at the specified interval 📣
--subscription-tolerance — set tolerance for subscription servers 💜
--unsubscribe-on-graceful-reload — force the unsubscribe request even during a graceful reload 👋 no loose ends.
--start-unsubscribed — configure subscriptions but do not send them — useful with master fifo 🤫
--subscribe-with-modifier1 — force the specified modifier1 when subscribing 🎀

--snmp — enable the embedded snmp server 📊
--snmp-community — set the snmp community string 🔤
--ssl-verbose — be verbose about SSL errors, spill the tea on what broke 🫖
--ssl-verify-depth — set the maximum certificate verification depth 🪜
--sni — add an SNI-governed SSL context 🌐
--sni-dir — check for cert/key/client_ca files in the specified directory and create a sni/ssl context on demand 📂
--sni-dir-ciphers — set ssl ciphers for the sni-dir option 🔐
--ssl-enable3 — enable SSLv3. Insecure, bestie, like genuinely ⚠️
--ssl-enable-sslv3 — enable SSLv3. Also insecure 💀
--ssl-enable-tlsv1 — enable TLSv1. Insecure too 🙈
--ssl-option — set a raw ssl option (numeric value) 🔢
--sni-regexp — add an SNI-governed SSL context, but the key is a regexp 🧠
--ssl-tmp-dir — store ssl-related temp files in the specified directory 🗂️

--check-interval — set the interval (in seconds) of master checks ⏰
--forkbomb-delay — sleep for the specified number of seconds when a forkbomb is detected 😴 crisis nap.
--binary-path — force the binary path 📍
--privileged-binary-patch — patch the uwsgi binary with a new command (before privileges drop) 🔧
--unprivileged-binary-patch — patch the uwsgi binary with a new command (after privileges drop) 🛠️
--privileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments (before privileges drop) 🎀
--unprivileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments (after privileges drop) 💜
--async — enable async mode with the specified cores ⚡
--max-fd — set the maximum number of file descriptors (requires root privileges) 👑
--logto — set the logfile/udp address 📝
--logto2 — log to the specified file or udp address after privileges drop 🪂
--log-format — set an advanced format for request logging 🎨
--logformat — set advanced format for request logging (the no-dash twin) ✨
--logformat-strftime — apply strftime to the logformat output 🕰️
--log-format-strftime — apply strftime to the logformat output (dashed flavour) 🌸
--logfile-chown — chown logfiles 🧾
--logfile-chmod — chmod logfiles 🔒
--log-syslog — log to syslog 📮
--log-socket — send logs to the specified socket 🔌
--req-logger — set/append a request logger 📋
--logger-req — set/append a request logger (flipped name, same job) 💅
--logger — set/append a logger 🗒️
--logger-list — list enabled loggers 📜
--loggers-list — list enabled loggers (plural edition) 🦋
--threaded-logger — offload log writing to a thread 🧵
--log-encoder — add an item in the log encoder chain 🔗
--log-req-encoder — add an item in the log req encoder chain 🔗
--log-drain — drain (do not show) log lines matching the specified regexp 🚫
--log-filter — show only log lines matching the specified regexp 🔍
--log-route — log to the specified named logger if the regexp applied on the logline matches 🎯
--log-req-route — log requests to the specified named logger if the regexp applied on the logline matches 🎯
--use-abort — call abort() on segfault/fpe, which could be useful for generating a core dump 💥
--alarm — create a new alarm 🚨 syntax is literally <alarm> <plugin:args> — like for real, that's the format, bestie.
--alarm-cheap — use the main alarm thread instead of creating dedicated threads for curl-based alarms. shared thread energy, less chaos 💖
--alarm-freq — tune the anti-loop alarm system, default is 3 seconds. Keep that loop from becoming a toxic situationship. ⏰
--alarm-fd — raise the specified alarm when an fd is read for read (by default it reads 1 byte, set 8 for eventfd). bytes are literally the blueprint 📟
--alarm-segfault — raise the specified alarm when the segmentation fault handler is executed. 💀 segfault jumpscare
--segfault-alarm — same slay, same job: 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 said no more room bestie 🚨
--backlog-alarm — raise the specified alarm when the socket backlog queue is full. same drama, different flag name 🚨
--lq-alarm — raise the specified alarm when the socket backlog queue is full. listen queue said capacity who? 🚨
--alarm-lq — raise the specified alarm when the socket backlog queue is full. yes, another alias, we love consistency 🚨
--alarm-listen-queue — raise the specified alarm when the socket backlog queue is full. the queue is full and it's giving overwhelmed 🚨
--listen-queue-alarm — raise the specified alarm when the socket backlog queue is full. same alarm, just doing a little name reveal 🚨
--log-alarm — raise the specified alarm when a log line matches the specified regexp. Syntax: <alarm>[,alarm...] <regexp>. regexp girlies rise 🔍
--alarm-log — raise the specified alarm when a log line matches the specified regexp. Syntax: <alarm>[,alarm...] <regexp>. alias behavior, iconic 🔍
--not-log-alarm — skip the specified alarm when a log line matches the specified regexp. Syntax: <alarm>[,alarm...] <regexp>. not me, not today 🙈
--not-alarm-log — skip the specified alarm when a log line matches the specified regexp. Syntax: <alarm>[,alarm...] <regexp>. same skip, different spelling 🙈
--alarm-list — list enabled alarms. show me the roster 📋
--alarms-list — list enabled alarms. plural version, still just listing them 📋
--alarm-msg-size — set the max size of an alarm message, default 8192. big messages need boundaries too 📨
--log-master — delegate logging to the master process. master said I'll handle the diary 📝
--log-master-bufsize — set the buffer size for the master logger. Bigger log messages will be truncated. truncation is not a vibe but it happens ✂️
--log-master-stream — create the master logpipe as SOCK_STREAM. stream mode activated 🌊
--log-master-req-stream — create the master requests logpipe as SOCK_STREAM. requests logpipe also gets the stream treatment 🌊
--log-reopen — reopen log after reload. fresh log, fresh me 🔄
--log-truncate — truncate log on startup. clean slate, no receipts 🧹
--log-maxsize — set maximum logfile size. cap it before it caps you 📏
--log-backupname — set logfile name after rotation. rotated logs need a new name tag 🏷️
--logdate — prefix logs with date or a strftime string. timestamps are the moment 🕰️
--log-date — prefix logs with date or a strftime string. same timestamp energy, dash included 🕰️
--log-prefix — prefix logs with a string. put a little label on it 🎀
--log-zero — log responses without body. empty body representation matters 🫥
--log-slow — log requests slower than the specified number of milliseconds. slow requests get exposed 🐌
--log-4xx — log requests with a 4xx response. client said oops 🚫
--log-5xx — log requests with a 5xx response. server said uh oh 💥
--log-big — log requests bigger than the specified size. thicc requests get noticed 🍑
--log-sendfile — log sendfile requests. sendfile stays on the record 📤
--log-ioerror — log requests with io errors. io errors, we see you 👀
--log-micros — report response time in microseconds instead of milliseconds. micro precision, we love to see it 🔬
--log-x-forwarded-for — use the ip from X-Forwarded-For header instead of REMOTE_ADDR. real ip reveal era 🌐
--master-as-root — leave master process running as root. root privileges stay on, be careful bestie 👑
--drop-after-init — run privileges drop after plugin initialization, superseded by drop-after-apps. old way, newer option took the crown ⏳
--drop-after-apps — run privileges drop after apps loading, superseded by master-as-root. also superseded, the plot thickens ⏳
--force-cwd — force the initial working directory to the specified value. cwd said you will be here 📁
--binsh — override /bin/sh (used by exec hooks, it always fallback to /bin/sh). shell override with a fallback safety net 🐚
--chdir — chdir to specified directory before apps loading. move before the apps show up 🚪
--chdir2 — chdir to specified directory after apps loading. move after the apps are already seated 🚪
--lazy — set lazy mode (load apps in workers instead of master). lazy mode but make it strategic 😴
--lazy-apps — load apps in each worker instead of the master. every worker gets its own app loading moment 😴
--cheap — set cheap mode (spawn workers only after the first request). workers said we'll show up when needed 💸
--cheaper — set cheaper mode (adaptive process spawning). adaptive spawning, main character efficiency 📈
--cheaper-initial — set the initial number of processes to spawn in cheaper mode. starting lineup size 🧮
--cheaper-algo — choose to algorithm used for adaptive process spawning. pick your algorithm fighter 🤖
--cheaper-step — number of additional processes to spawn at each overload. overload says add more ➕
--cheaper-overload — increase workers after specified overload. after this much overload, spawn more ⚡
--cheaper-algo-list — list enabled cheapers algorithms. show the algorithm menu 📜
--cheaper-algos-list — list enabled cheapers algorithms. plural alias, same list energy 📜
--cheaper-list — list enabled cheapers algorithms. short and sweet alias 📜
--cheaper-rss-limit-soft — don't spawn new workers if total resident memory usage of all workers is higher than this limit. soft limit says maybe chill 🧠
--cheaper-rss-limit-hard — if total workers resident memory usage is higher try to stop workers. hard limit says okay stop 🛑
--idle — set idle mode (put uWSGI in cheap mode after inactivity). idle mode, cozy but efficient 🛋️
--die-on-idle — shutdown uWSGI when idle. idle means goodbye 💀
--mount — load application under mountpoint. mount it like it's meant to be there 🏔️
--worker-mount — load application under mountpoint in the specified worker or after workers spawn. worker-specific mount moment 🏔️
--threads — run each worker in prethreaded mode with the specified number of threads. prethreaded mode, thread count activated 🧵
--thread-stacksize — set threads stacksize. stacksize but for threads 📚
--threads-stacksize — set threads stacksize. plural alias doing the same 📚
--thread-stack-size — set threads stacksize. dash version, still stacksize 📚
--threads-stack-size — set threads stacksize. all the aliases came to the function 📚
--vhost — enable virtualhosting mode (based on SERVER_NAME variable). virtualhosting via SERVER_NAME 🏠
--vhost-host — enable virtualhosting mode (based on HTTP_HOST variable). virtualhosting via HTTP_HOST 🏠
--route — add a route. routing era begins 🛣️
--route-host — add a route based on Host header. host header decides 🏷️
--route-uri — add a route based on REQUEST_URI. uri-based routing 🔗
--route-qs — add a route based on QUERY_STRING. query string in the driver's seat ❓
--route-remote-addr — add a route based on REMOTE_ADDR. remote addr says this way 📍
--route-user-agent — add a route based on HTTP_USER_AGENT. user agent routing 🕵️
--route-remote-user — add a route based on REMOTE_USER. remote user gets a route 👤
--route-referer — add a route based on HTTP_REFERER. referer-based routing, messy but valid ↩️
--route-label — add a routing label (for use with goto). label it for the goto girlies 🏷️
--route-if — add a route based on condition. if this, route that 🤔
--route-if-not — add a route based on condition (negate version). if not, route anyway 🙅
--route-run — always run the specified route action. no conditions, just run it 🏃
--final-route — add a final route. final route, last stop energy 🏁
--final-route-status — add a final route for the specified status. final route by status 🏁
--final-route-host — add a final route based on Host header. final route by host 🏁
--final-route-uri — add a final route based on REQUEST_URI. final route by uri 🏁
--final-route-qs — add a final route based on QUERY_STRING. final route by query string 🏁
--final-route-remote-addr — add a final route based on REMOTE_ADDR. final route by remote addr 🏁
--final-route-user-agent — add a final route based on HTTP_USER_AGENT. final route by user agent 🏁
--final-route-remote-user — add a final route based on REMOTE_USER. final route by remote user 🏁
--final-route-referer — add a final route based on HTTP_REFERER. final route by referer 🏁
--final-route-label — add a final routing label (for use with goto). final label for goto 🏷️
--final-route-if — add a final route based on condition. final if-route 🤔
--final-route-if-not — add a final route based on condition (negate version). final not-if route 🙅
--final-route-run — always run the specified final route action. final route action, always runs 🏃
--error-route — add an error route. error routing time 🚨
--error-route-status — add an error route for the specified status. error route by status 🚨
--error-route-host — add an error route based on Host header. error route by host 🚨
--error-route-uri — add an error route based on REQUEST_URI. error route by uri 🚨
--error-route-qs — add an error route based on QUERY_STRING. error route by query string 🚨
--error-route-remote-addr — add an error route based on REMOTE_ADDR. error route by remote addr 🚨
--error-route-user-agent — add an error route based on HTTP_USER_AGENT. error route by user agent 🚨
--error-route-remote-user — add an error route based on REMOTE_USER. error route by remote user 🚨
--error-route-referer — add an error route based on HTTP_REFERER. error route by referer 🚨
--error-route-label — add an error routing label (for use with goto). error label for goto 🏷️
--error-route-if — add an error route based on condition. error route if condition 🤔
--error-route-if-not — add an error route based on condition (negate version). error route if not condition 🙅
--error-route-run — always run the specified error route action. error route action, always runs 🏃
--response-route — add a response route. response routing era 📬
--response-route-status — add a response route for the specified status. response route by status 📬
--response-route-host — add a response route based on Host header. response route by host 📬
--response-route-uri — add a response route based on REQUEST_URI. response route by uri 📬
--response-route-qs — add a response route based on QUERY_STRING. response route by query string 📬
--response-route-remote-addr — add a response route based on REMOTE_ADDR. response route by remote addr 📬
--response-route-user-agent — add a response route based on HTTP_USER_AGENT. response route by user agent 📬
--response-route-remote-user — add a response route based on REMOTE_USER. response route by remote user 📬
--response-route-referer — add a response route based on HTTP_REFERER. response route by referer 📬
--response-route-label — add a response routing label (for use with goto). response label for goto 🏷️
--response-route-if — add a response route based on condition. response route if condition 🤔
--response-route-if-not — add a response route based on condition (negate version). response route if not condition 🙅
--response-route-run — always run the specified response route action. response route action, always runs 🏃
--router-list — list enabled routers. show me the routers 📡
--routers-list — list enabled routers. plural alias, same router roster 📡
--error-page-403 — add an error page (html) for managed 403 response. 403 but make it html 🚫
--error-page-404 — add an error page (html) for managed 404 response. 404 but make it html 🔍
--error-page-500 — add an error page (html) for managed 500 response. 500 but make it html 💥
--websockets-ping-freq — set the frequency (in seconds) of websockets automatic ping packets. ping frequency, keep the connection alive 🏓
--websocket-ping-freq — set the frequency (in seconds) of websockets automatic ping packets. singular alias, same ping energy 🏓
--websockets-pong-tolerance — set the tolerance (in seconds) of websockets ping/pong subsystem. pong tolerance, be patient 🏓
--websocket-pong-tolerance — set the tolerance (in seconds) of websockets ping/pong subsystem. same tolerance, singular spelling 🏓
--websockets-max-size — set the max allowed size of websocket messages (in Kbytes, default 1024). max websocket message size, default 1024 Kbytes 📦
--websocket-max-size — set the max allowed size of websocket messages (in Kbytes, default 1024). alias with the same size cap 📦
--chunked-input-limit — set the max size of a chunked input part (default 1MB, in bytes). chunked input limit, default 1MB in bytes 🧩
--chunked-input-timeout — set default timeout for chunked input. chunked input timeout, default style ⏳
--clock — set a clock source. pick your clock source 🕰️
--clock-list — list enabled clocks. list the clocks that made the cut 🕰️
--clocks-list — lists every clock that's currently enabled ✨
--add-header — automatically drops HTTP headers into your response, zero effort 💅
--rem-header — automatically removes the HTTP header you name from the response
--del-header — word for word the same job: automatically remove the specified HTTP header from the response
--collect-header — tucks a chosen response header into a request var (syntax: header var) 🎀
--response-header-collect — 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 off the response entirely (syntax: header var) 😤

--check-static — go looking for static files inside the directory you point at 🦋
--check-static-docroot — go looking for static files inside the requested DOCUMENT_ROOT
--static-check — again: check the specified directory for static files
--static-map — maps a mountpoint onto a static directory (or a single file) 🗺️
--static-map2 — like --static-map, except it appends the requested resource onto the docroot in full
--static-skip-ext — skip that extension when doing static file checks
--static-index — if someone requests a directory, hunt for the file you name here
--static-safe — skips the security checks for a file sitting under the path you specify
--static-cache-paths — dumps 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 — yep, also sets the mime types file path (default /etc/mime.types)
--static-expires-type — builds the Expires header off the content type
--static-expires-type-mtime — builds the Expires header off the content type and the file mtime
--static-expires — builds the Expires header off a filename regexp
--static-expires-mtime — builds the Expires header off a filename regexp and the file mtime
--static-expires-uri — builds the Expires header off a REQUEST_URI regexp
--static-expires-uri-mtime — builds the Expires header off a REQUEST_URI regexp and the file mtime
--static-expires-path-info — builds the Expires header off a PATH_INFO regexp
--static-expires-path-info-mtime — builds the Expires header off a PATH_INFO regexp and the file mtime
--static-gzip — if your regexp matches the static file translation, it'll go hunting for a gzip version 🗜️
--static-gzip-all — checks for a gzip version of every requested static file, no filter
--static-gzip-dir — checks for a gzip version of all requested static files under the dir/prefix you give
--static-gzip-prefix — same thing, checks for a gzip version of all requested static files using the dir/prefix you give
--static-gzip-ext — checks for a gzip version of all requested static files with the ext/suffix you give
--static-gzip-suffix — again, checks for a gzip version of all requested static files with that ext/suffix
--honour-range — turns on support for the HTTP Range header
--offload-threads — how many offload threads to spawn (per-worker, default 0) 🧵
--offload-thread — the exact same knob: number of offload threads to spawn (per-worker, default 0)
--file-serve-mode — sets the static file serving mode
--fileserve-mode — yes bestie, sets the static file serving mode
--disable-sendfile — kills sendfile() and makes it lean on boring read()/write() instead 💀
--check-cache — checks for response data in the cache you name (leave it empty for the default cache)
--close-on-exec — sets close-on-exec on connection sockets (could be required for spawning processes in requests)
--close-on-exec2 — sets close-on-exec on server sockets (could be required for spawning processes in requests)

--mode — set uWSGI custom mode
--env — set environment variable 🌈
--envdir — loads a daemontools compatible envdir
--early-envdir — loads a daemontools compatible envdir ASAP
--unenv — unset environment variable 🙈
--vacuum — does its best 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 the privileges drop
--cgroup — puts the processes into the cgroup you name
--cgroup-opt — sets a value in the cgroup option you specify
--cgroup-dir-mode — sets permission for the cgroup directory (default is 700)
--namespace — runs inside a brand new namespace under the rootfs you specify 👑
--namespace-keep-mount — keeps the mountpoint you name inside your namespace
--ns — runs in a new namespace under the specified rootfs
--namespace-net — adds a network namespace
--ns-net — also adds a network namespace
--enable-proxy-protocol — turns on PROXY1 protocol support (only for http parsers)
--reuse-port — enables the REUSE_PORT flag on the socket (BSD only) ⭐
--tcp-fast-open — enables the TCP_FASTOPEN flag on TCP sockets with the qlen value you give
--tcp-fastopen — same flag, TCP_FASTOPEN on TCP sockets, with your qlen value
--tcp-fast-open-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if it's supported ⚡
--tcp-fastopen-client — again, sendto(..., MSG_FASTOPEN, ...) instead of connect() where supported
--zerg — attach to a zerg server 🐛
--zerg-fallback — falls back to normal sockets if that zerg server isn't around
--zerg-server — enables the zerg server on the UNIX socket you specify

--cron — add a cron task ⏰
--cron2 — add a cron task (key=val syntax)
--unique-cron — add a unique cron task
--cron-harakiri — the max time, in seconds, we'll wait for a cron command to finish before... yeah 😭
--legion-cron — add a cron task that only runs when this instance is a lord of the legion you name
--cron-legion — add a cron task runnable only when the instance is a lord of the specified legion
--unique-legion-cron — add a unique cron task runnable only when the instance is a lord of the specified legion
--unique-cron-legion — add a unique cron task runnable only when the instance is a lord of the specified legion
--loop — select the uWSGI loop engine 🔁
--loop-list — lists the enabled loop engines
--loops-list — lists the enabled loop engines (plural, same energy)
--worker-exec — run the command you give as a worker
--worker-exec2 — run the specified command as a worker (after the post_fork hook)
--attach-daemon — attaches a command/daemon to the master process (the command has to not go into 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, except the daemon only runs on the legion lord node
--legion-smart-attach-daemon — same as --smart-attach-daemon, except the daemon only runs on the legion lord node
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2, except the daemon only runs on the legion lord node
--daemons-honour-stdin — stops uWSGI swapping the stdin of external daemons over to /dev/null
--attach-daemon2 — the attach-daemon keyval variant (smart modes included too) 🎀

--plugins — load uWSGI plugins 🔌
--plugin — load uWSGI plugins
--need-plugins — load uWSGI plugins, and exit if it errors out
--need-plugin — load uWSGI plugins (exit on error), same vibe
--plugins-dir — add a directory to the uWSGI plugin search path
--plugin-dir — add 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 it runs into unknown options
--dlopen — blindly loads a shared library 🙈
--allowed-modifiers — a comma separated list of allowed modifiers
--remap-modifier — remaps a request modifier from one id to another
--dump-options — dumps the full list of every available option 📜
--show-config — shows the current config, reformatted as ini
--binary-append-data — prints the content of a resource to stdout so you can append it to a uwsgi binary (for data:// usage)
--print — simple print
--iprint — simple print, but the immediate version ⚡
--exit — force exit() of the instance
--cflags — reports uWSGI CFLAGS (useful for building external plugins) 🔧
--dot-h — dumps the uwsgi.h used for building the core (useful for building external plugins)
--config-py — dumps the uwsgiconfig.py used for building the core (useful for building external plugins)
--build-plugin — builds a uWSGI plugin for the current binary
--version — prints the uWSGI version 👑
--response-headers-limit — sets the max size of a response header (default: 64k)

And that's a wrap on this whole thing, bestie — every last option, delivered 💖 This page is uwsgi_curl_cron 2.0.31-debian, dated July 2026, and it lives in section UWSGI_CURL_CRON(1). Go serve some static files, no cap 🦋✨

📦 where this page comes from

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