UWSGI_JVM_OPENJDK17(1)

hey bestie! welcome to the UWSGI_JVM_OPENJDK17(1) manual — User Commands section, and yes, we're doing this together. ✨ part 1, no cap. grab a strawberry 🍓 and let's vibe check this whole thing.

---

NAME 🌸

uwsgi_jvm_openjdk17 — fast (pure C), self-healing, developer-friendly WSGI server. it's giving server that literally heals itself, and I'm obsessed. 💖

SYNOPSIS ✨

uwsgi-core-local [options...]

DESCRIPTION 🌈

okay so this whole section is the flag menu. one bullet per option, exactly as the manual serves it. let's go, bestie. 💅

• -s, --socket — bind the specified UNIX/TCP socket with the default protocol. the classic default-protocol bind. ✨
• -s, --uwsgi-socket — bind the specified UNIX/TCP socket with the uwsgi protocol. uwsgi protocol only, bestie. 💖
• --suwsgi-socket — bind the specified UNIX/TCP socket with the uwsgi protocol over SSL. yes, SSL on top. 🔒
• --ssl-socket — bind the specified UNIX/TCP socket with the uwsgi protocol over SSL. same SSL energy, different flag. 🌸
• --http-socket — bind the specified UNIX/TCP socket with the HTTP protocol. HTTP bestie. 🌐
• --http-socket-modifier1 — force the specified modifier1 when you're using HTTP protocol. modifier1 said so. 💅
• --http-socket-modifier2 — force the specified modifier2 when you're using HTTP protocol. modifier2 also said so. 💅
• --http11-socket — bind the specified UNIX/TCP socket with the HTTP 1.1 (Keep-Alive) protocol. keep-alive era. 🔥
• --https-socket — bind the specified UNIX/TCP socket with the HTTPS protocol. secure vibes. 🔐
• --https-socket-modifier1 — force the specified modifier1 when you're using HTTPS protocol. HTTPS but with modifier1. ✨
• --https-socket-modifier2 — force the specified modifier2 when you're using HTTPS protocol. HTTPS but with modifier2. ✨
• --fastcgi-socket — bind the specified UNIX/TCP socket with the FastCGI protocol. FastCGI, iconic. 🦋
• --fastcgi-nph-socket — bind the specified UNIX/TCP socket with the FastCGI protocol (nph mode). nph mode, specifically. 💫
• --fastcgi-modifier1 — force the specified modifier1 when you're using FastCGI protocol. FastCGI modifier1. 💅
• --fastcgi-modifier2 — force the specified modifier2 when you're using FastCGI protocol. FastCGI modifier2. 💅
• --scgi-socket — bind the specified UNIX/TCP socket with the SCGI protocol. SCGI bestie. 🌈
• --scgi-nph-socket — bind the specified UNIX/TCP socket with the SCGI protocol (nph mode). nph mode again. ✨
• --scgi-modifier1 — force the specified modifier1 when you're using SCGI protocol. SCGI modifier1. 💅
• --scgi-modifier2 — force the specified modifier2 when you're using SCGI protocol. SCGI modifier2. 💅
• --raw-socket — bind the specified UNIX/TCP socket with the RAW protocol. RAW and unfiltered. 🔥
• --raw-modifier1 — force the specified modifier1 when you're using RAW protocol. RAW modifier1. 💅
• --raw-modifier2 — force the specified modifier2 when you're using RAW protocol. RAW modifier2. 💅
• --puwsgi-socket — bind the specified UNIX/TCP socket with the persistent uwsgi protocol (puwsgi). persistent uwsgi, periodt. 💖
• --protocol — force the specified protocol for default sockets. default sockets, specified protocol. ✨
• --socket-protocol — force the specified protocol for default sockets. same energy. 💫
• --shared-socket — create a shared socket for advanced jailing or ipc. advanced jailing/ipc vibes. 🦋
• --undeferred-shared-socket — create a shared socket for advanced jailing or ipc (undeferred mode). undeferred mode, specifically. 💅
• -p, --processes — spawn the specified number of workers/processes. that many processes. 👑
• -p, --workers — spawn the specified number of workers/processes. same thing, worker edition. 💖
• --thunder-lock — serialize accept() usage (if possible). thunder lock, if possible. ⚡
• -t, --harakiri — set the harakiri timeout. harakiri timeout, bestie. 🗡️
• --harakiri-verbose — enable verbose mode for harakiri. verbose harakiri. 📢
• --harakiri-graceful-timeout — interval between a graceful harakiri attempt and a sigkill. graceful then sigkill. 💀
• --harakiri-graceful-signal — use this signal instead of sigterm for graceful harakiri attempts. not sigterm, this signal. 🚦
• --harakiri-queue-threshold — only trigger harakiri if queue is greater than this threshold. queue threshold gate. 🚧
• --harakiri-no-arh — do not enable harakiri during after-request-hook. no harakiri in ARH. 🙅
• --no-harakiri-arh — do not enable harakiri during after-request-hook. same no-harakiri ARH energy. 🙅
• --no-harakiri-after-req-hook — do not enable harakiri during after-request-hook. literally the same. 🙅
• --backtrace-depth — set the backtrace depth. depth, set. 🧵
• --mule-harakiri — set the harakiri timeout for mule tasks. mule tasks get harakiri timeout. 🐴
• -x, --xmlconfig — load config from an xml file. xml config, bestie. 📄
• -x, --xml — load config from an xml file. same xml config energy. 📄
• --config — load configuration using the pluggable system. pluggable system, go. 🔌
• --fallback-config — re-exec uwsgi with the specified config when exit code is 1. exit code 1 fallback. 🔁
• --strict — enable strict mode (placeholder cannot be used). strict mode, so placeholders are a no. 🚫
• --skip-zero — skip check of file descriptor 0. fd 0 check skipped. 0️⃣
• --skip-atexit — skip atexit hooks (ignored by the master). atexit hooks skipped, master ignores it. 🙈
• --skip-atexit-teardown — skip atexit teardown (ignored by the master). teardown skipped, master ignores it. 🙈
• -S, --set — set a placeholder or an option. placeholder or option, your call. 🎀
• --set-placeholder — set a placeholder. placeholder set. 💖
• --set-ph — set a placeholder. placeholder set, short version. 💖
• --get — print the specified option value and exit. print it and bounce. 🖨️
• --declare-option — declare a new uWSGI custom option. new custom option, declared. 📜
• --declare-option2 — declare a new uWSGI custom option (non-immediate). non-immediate custom option. ⏳
• --resolve — place the result of a dns query in the specified placeholder, sytax: placeholder=name (immediate option). yes, sytax is literally the typo, iconic. immediate option. 🔍
• --for — (opt logic) for cycle. opt logic for loop. 🔁
• --for-glob — (opt logic) for cycle (expand glob). for cycle with glob expansion. 🌐
• --for-times — (opt logic) for cycle (expand the specified num to a list starting from 1). num to list starting at 1. 🔢
• --for-readline — (opt logic) for cycle (expand the specified file to a list of lines). file to lines. 📄
• --endfor — (opt logic) end for cycle. end for. 🛑
• --end-for — (opt logic) end for cycle. end for again. 🛑
• --if-opt — (opt logic) check for option. if option. ❓
• --if-not-opt — (opt logic) check for option. if not option. ❓
• --if-env — (opt logic) check for environment variable. if env var. 🌿
• --if-not-env — (opt logic) check for environment variable. if not env var. 🌿
• --ifenv — (opt logic) check for environment variable. ifenv, same check. 🌿
• --if-reload — (opt logic) check for reload. if reload. 🔄
• --if-not-reload — (opt logic) check for reload. if not reload. 🔄
• --if-hostname — (opt logic) check for hostname. if hostname. 🏠
• --if-not-hostname — (opt logic) check for hostname. if not hostname. 🏠
• --if-hostname-match — (opt logic) try to match hostname against a regular expression. hostname regex match. 🧬
• --if-not-hostname-match — (opt logic) try to match hostname against a regular expression. hostname regex non-match. 🧬
• --if-exists — (opt logic) check for file/directory existence. if file/dir exists. 📁
• --if-not-exists — (opt logic) check for file/directory existence. if file/dir does not exist. 📁
• --ifexists — (opt logic) check for file/directory existence. ifexists, same check. 📁
• --if-plugin — (opt logic) check for plugin. if plugin. 🔌
• --if-not-plugin — (opt logic) check for plugin. if not plugin. 🔌
• --ifplugin — (opt logic) check for plugin. ifplugin, same check. 🔌
• --if-file — (opt logic) check for file existance. yes, existance with an a, love that. 📄
• --if-not-file — (opt logic) check for file existance. same existance energy. 📄
• --if-dir — (opt logic) check for directory existance. directory existance, iconic. 📁
• --if-not-dir — (opt logic) check for directory existance. same. 📁
• --ifdir — (opt logic) check for directory existance. ifdir. 📁
• --if-directory — (opt logic) check for directory existance. if-directory. 📁
• --endif — (opt logic) end if. end if. 🛑
• --end-if — (opt logic) end if. end if again. 🛑
• --blacklist — set options blacklist context. blacklist context set. ⛔
• --end-blacklist — clear options blacklist context. blacklist context cleared. ✅
• --whitelist — set options whitelist context. whitelist context set. ✅
• --end-whitelist — clear options whitelist context. whitelist context cleared. ✅
• --ignore-sigpipe — do not report (annoying) SIGPIPE. bye annoying SIGPIPE reports. 🙉
• --ignore-write-errors — do not report (annoying) write()/writev() errors. bye annoying write errors. 🙉
• --write-errors-tolerance — set the maximum number of allowed write errors (default: no tolerance). default is no tolerance, bestie. 🚦
• --write-errors-exception-only — only raise an exception on write errors giving control to the app itself. exception only, app gets control. 🎮
• --disable-write-exception — disable exception generation on write()/writev(). no write exceptions generated. 🚫
• --inherit — use the specified file as a config template. config template file. 🧬
• --include — include the specified file as immediate configuration. immediate config include. 📥
• --inject-before — inject a text file before the config file (advanced templating). advanced templating, before. 💉
• --inject-after — inject a text file after the config file (advanced templating). advanced templating, after. 💉
• -d, --daemonize — daemonize uWSGI. daemonize it. 😈
• --daemonize2 — daemonize uWSGI after app loading. daemonize after app load. 😈
• --stop — stop an instance. stop it. 🛑
• --reload — reload an instance. reload it. 🔄
• --pause — pause an instance. pause it. ⏸️
• --suspend — suspend an instance. suspend it. ⏸️
• --resume — resume an instance. resume it. ▶️
• --connect-and-read — connect to a socket and wait for data from it. connect, then read. 🔌
• --extract — fetch/dump any supported address to stdout. dump that address to stdout. 📤
• -l, --listen — set the socket listen queue size. listen queue size, set. 🎧
• -v, --max-vars — set the amount of internal iovec/vars structures. iovec/vars structures amount. 🧮
• --max-apps — set the maximum number of per-worker applications. max per-worker apps. 📱
• -b, --buffer-size — set internal buffer size. buffer size, internal. 🧺
• -m, --memory-report — enable memory report. memory report on. 🧠
• --profiler — enable the specified profiler. profiler enabled. 📊
• -c, --cgi-mode — force CGI-mode for plugins supporting it. CGI-mode for the plugins that support it. 🐚
• -a, --abstract-socket — force UNIX socket in abstract mode (Linux only). abstract mode, Linux only. 🐧
• -C, --chmod-socket — chmod-socket. chmod the socket. 🔐
• -C, --chmod — chmod-socket. same chmod socket energy. 🔐
• --chown-socket — chown unix sockets. chown those unix sockets. 👑
• --umask — set umask. umask, set. 🎭
• --freebind — put socket in freebind mode. freebind mode. 🕊️
• --map-socket — map sockets to specific workers. socket-to-worker mapping. 🗺️
• -T, --enable-threads — enable threads. threads on. 🧵
• --no-threads-wait — do not wait for threads cancellation on quit/reload. no waiting on quit/reload. ⏭️
• --auto-procname — automatically set processes name to something meaningful. auto meaningful process names. 🏷️
• --procname-prefix — add a prefix to the process names. process name prefix. 🔤
• --procname-prefix-spaced — add a spaced prefix to the process names. spaced prefix. ␣
• --procname-append — append a string to process names. append to process names. ➕
• --procname — set process names. set those process names. 🏷️
• --procname-master — set master process name. master process name. 👑
• -i, --single-interpreter — do not use multiple interpreters (where available). single interpreter, where available. 1️⃣
• --need-app — exit if no app can be loaded. no app? exit. 🚪
• -M, --master — enable master process. master process on. 👑
• --honour-stdin — do not remap stdin to /dev/null. stdin stays stdin, not /dev/null. 📥
• --emperor — run the Emperor. Emperor mode. 👑
• --emperor-proxy-socket — force the vassal to became an Emperor proxy. yes, became, iconic. vassal becomes proxy. 🛰️
• --emperor-wrapper — set a binary wrapper for vassals. vassal binary wrapper. 🎁
• --emperor-wrapper-override — set a binary wrapper for vassals to try before the default one. try this wrapper before default. 🥇
• --emperor-wrapper-fallback — set a binary wrapper for vassals to try as a last resort. last-resort wrapper. 🆘
• --emperor-nofollow — do not follow symlinks when checking for mtime. no symlink following for mtime. 🚫
• --emperor-procname — set the Emperor process name. Emperor process name. 👑
• --emperor-freq — set the Emperor scan frequency (default 3 seconds). default is 3 seconds. ⏱️
• --emperor-required-heartbeat — set the Emperor tolerance about heartbeats. heartbeat tolerance. 💓
• --emperor-curse-tolerance — set the Emperor tolerance about cursed vassals. cursed vassal tolerance. 🧙
• --emperor-pidfile — write the Emperor pid in the specified file. Emperor pid goes in the file. 📝
• --emperor-tyrant — okay so this puts the Emperor in Tyrant mode, absolute monarchy era 👑 periodt
• --emperor-tyrant-nofollow — in Tyrant mode, do not follow symlinks when checking uid/gid — no cap, we don't chase links 🚫🔗
• --emperor-stats — run the Emperor stats server, it's giving dashboard energy 📊
• --emperor-stats-server — same vibe: run the Emperor stats server 📊
• --early-emperor — spawn the emperor as soon as possibile (yes, that's the original spelling, iconic) ⏰
• --emperor-broodlord — run the emperor in BroodLord mode, main character energy 👑
• --emperor-throttle — set throttling level (in milliseconds) for bad behaving vassals — default is 1000 🐢
• --emperor-max-throttle — set max throttling level (in milliseconds) for bad behaving vassals — default is 3 minutes 🐢
• --emperor-magic-exec — prefix vassals config files with exec:// if they have the executable bit, slay ✨
• --emperor-on-demand-extension — search for text file (vassal name + extension) containing the on demand socket name 🔍
• --emperor-on-demand-ext — same thing, 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, unbothered 🚫
• --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, flex 💪
• --vassals-cap — set vassals capability, same flex 💪
• --vassal-cap — set vassals capability, singular flex 💪
• --imperial-monitor-list — list enabled imperial monitors 📋
• --imperial-monitors-list — list enabled imperial monitors (plural monitors, iykyk) 📋
• --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 🔄
• --min-worker-lifetime — number of seconds worker must run before being reloaded (default is 60) ⏱️
• --max-worker-lifetime — reload workers after the specified amount of seconds (default is disabled) ⏱️
• --max-worker-lifetime-delta — add (worker_id * delta) seconds to the max_worker_lifetime value of each worker ➕
• -z, --socket-timeout — set internal sockets timeout ⏰
• --no-fd-passing — disable file descriptor passing 🚫
• --locks — create the specified number of shared locks 🔒
• --lock-engine — set the lock engine 🔒
• --ftok — set the ipcsem key via ftok() for avoiding duplicates 🔑
• --persistent-ipcsem — do not remove ipcsem's on shutdown 🛡️
• -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 — mark the instance as jailed (force the execution of post_jail hooks) 🔒

Lowkey the next chunk is where uWSGI starts showing off its lifecycle hook era 💅 like, you can inject yourself into literally every moment of the process's lil journey. Obsessed.

---

🎀 THE REFORK FAMILY (yes, there's a lot of them)

• --refork — fork() again after privileges drop. Useful for jailing systems.
• --re-fork — same vibe, same energy: fork() again after privileges drop. Useful for jailing systems.
• --refork-as-root — fork() again before privileges drop. Useful for jailing systems.
• --re-fork-as-root — the hyphenated twin 💖 fork() again before privileges drop. Useful for jailing systems.
• --refork-post-jail — fork() again after jailing. Useful for jailing systems.
• --re-fork-post-jail — you guessed it bestie: fork() again after jailing. Useful for jailing systems.

---

✨ HOOKS: the "run my lil script at this exact moment" collection

ngl these are giving main character energy — you're telling uWSGI "when X happens, go do Y." The <action> is yours to choose, the timing is uWSGI's.

• --hook-asap — run the specified hook as soon as possible.
• --hook-pre-jail — run the specified hook before jailing.
• --hook-post-jail — run the specified hook after jailing.
• --hook-in-jail — run the specified hook in jail after initialization.
• --hook-as-root — run the specified hook before privileges drop.
• --hook-as-user — run the specified hook after privileges drop.
• --hook-as-user-atexit — run the specified hook before app exit and reload.
• --hook-pre-app — run the specified hook before app loading.
• --hook-post-app — run the specified hook after app loading.
• --hook-post-fork — run the specified hook after each fork.
• --hook-accepting — run the specified hook after each worker enter the accepting phase.
• --hook-accepting1 — run the specified hook after the first worker enters the accepting phase.
• --hook-accepting-once — run the specified hook after each worker enter the accepting phase (once per-instance).
• --hook-accepting1-once — run the specified hook after the first worker enters the accepting phase (once per instance).
• --hook-master-start — run the specified hook when the Master starts. 👑
• --hook-touch — run the specified hook when the specified file is touched (syntax: <file> <action>).
• --hook-emperor-start — run the specified hook when the Emperor starts.
• --hook-emperor-stop — run the specified hook when the Emperor send a stop message.
• --hook-emperor-reload — run the specified hook when the Emperor send a reload message.
• --hook-emperor-lost — run the specified hook when the Emperor connection is lost. 😭
• --hook-as-vassal — run the specified hook before exec()ing the vassal.
• --hook-as-emperor — run the specified hook in the emperor after the vassal has been started.
• --hook-as-mule — run the specified hook in each mule.
• --hook-as-gateway — run the specified hook in each gateway.
• --after-request-hook — run the specified function/symbol after each request.
• --after-request-call — run the specified function/symbol after each request.

---

💀 EXECS: same timing slots, but it's a command this time

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

---

🦋 MOUNTS & UMOUNTS: filesystem girlies rise up

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

---

🧚 THE WAIT-FOR GIRLIES (patience is a virtue fr fr)

So many aliases, bestie — they all do the exact same thing, pick whichever one your fingers vibe with.

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

---

🍓 CALLS: function-flavoured, with the arg count baked in

Watch the numbers on the emperor/vassal ones — they're not decorative, they tell you the signature 💅

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

---

🌸 CONFIG LOADING & MODES

• --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 TWEAKS (networking glow-up)

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

---

⭐ LIMITS, MEMORY & RELOADS

• --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-* FAMILY: poke a file, trigger a thing

It's giving "touch grass" but for your server 🫶

• --touch-reload — reload uWSGI if the specified file is modified/touched.
• --touch-workers-reload — trigger reload of (only) workers if the specified file is modified/touched.
• --touch-mules-reload — reload mules if the specified file is modified/touched.
• --touch-spoolers-reload — reload spoolers if the specified file is modified/touched.
• --touch-chain-reload — trigger chain reload if the specified file is modified/touched.
• --touch-logrotate — trigger logrotation if the specified file is modified/touched.
• --touch-logreopen — trigger log reopen if the specified file is modified/touched.
• --touch-exec — run command when the specified file is modified/touched (syntax: file command).
• --touch-signal — signal when the specified file is modified/touched (syntax: file signal).
• --fs-reload — graceful reload when the specified filesystem object is modified ✨
• --fs-brutal-reload — brutal reload when the specified filesystem object is modified 💀
• --fs-signal — raise a uwsgi signal when the specified filesystem object is modified. syntax: file signal 📡
• --check-mountpoint — destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management) 🫠
• --mountpoint-check — same energy: destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management) 💅
• --check-mount — destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management) 🧚
• --mount-check — destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management) 🌸
• --propagate-touch — over-engineering option for systems with flaky signal management 🙈
• --limit-post — limit request body 🚫
• --no-orphans — automatically kill workers if master dies (can be dangerous for availability) 😭
• --prio — set processes/threads priority 👑
• --cpu-affinity — set cpu affinity 🧠
• --post-buffering — set size in bytes after which it will buffer to disk instead of memory 💾
• --post-buffering-bufsize — set buffer size for read() in post buffering mode 📖
• --body-read-warning — set the amount of allowed memory allocation (in megabytes) for request body before starting printing a warning ⚠️
• --upload-progress — enable creation of .json files in the specified directory during a file upload 📤
• --no-default-app — do not fallback to default app 🚫
• --manage-script-name — automatically rewrite SCRIPT_NAME and PATH_INFO ✍️
• --ignore-script-name — ignore SCRIPT_NAME 🙈
• --catch-exceptions — report exception as http output (discouraged, use only for testing) 🧪
• --reload-on-exception — reload a worker when an exception is raised 🔄
• --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 🛠️
• --enable-metrics — enable metrics subsystem 📊
• --metric — add a custom metric 📈
• --metric-threshold — add a metric threshold/alarm 🚨
• --metric-alarm — add a metric threshold/alarm 🚨
• --alarm-metric — add a metric threshold/alarm 🚨
• --metrics-dir — export metrics as text files to the specified directory 📁
• --metrics-dir-restore — restore last value taken from the metrics dir ♻️
• --metric-dir — export metrics as text files to the specified directory 📁
• --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 📊
• --stats-http — prefix stats server json output with http headers 🌐
• --stats-minified — minify statistics json output 🗜️
• --stats-min — minify statistics json output 🗜️
• --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 ⏱️
• --stats-no-cores — disable generation of cores-related stats 🚫
• --stats-no-metrics — do not include metrics in stats output 🚫
• --multicast — subscribe to specified multicast group 📻
• --multicast-ttl — set 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 ⚔️
• --legion-mcast — became a member of a legion (shortcut for multicast) ⚔️📻
• --legion-node — add a node to a legion ➕
• --legion-freq — set the frequency of legion packets 📦
• --legion-tolerance — set the tolerance of legion subsystem 🤝
• --legion-death-on-lord-error — declare itself as a dead node for the specified amount of seconds if one of the lord hooks fails 💀
• --legion-skew-tolerance — set the clock skew tolerance of legion subsystem (default 30 seconds) ⏰
• --legion-lord — action to call on Lord election 👑
• --legion-unlord — action to call on Lord dismiss 👋
• --legion-setup — action to call on legion setup 🛠️
• --legion-death — action to call on legion death (shutdown of the instance) ⚰️
• --legion-join — action to call on legion join (first time quorum is reached) 🎉
• --legion-node-joined — action to call on new node joining legion 🎊
• --legion-node-left — action to call node leaving legion 🚪
• --legion-quorum — set the quorum of a legion 🗳️
• --legion-scroll — set the scroll of a legion 📜
• --legion-scroll-max-size — set max size of legion scroll buffer 📏
• --legion-scroll-list-max-size — set max size of legion scroll list buffer 📏
• --subscriptions-sign-check — set digest algorithm and certificate directory for secured subscription system 🔐
• --subscriptions-sign-check-tolerance — set the maximum tolerance (in seconds) of clock skew for secured subscription system ⏱️
• --subscriptions-sign-skip-uid — skip signature check for the specified uid when using unix sockets credentials 🆔
• --subscriptions-credentials-check — add a directory to search for subscriptions key credentials 🔑
• --subscriptions-use-credentials — enable management of SCM_CREDENTIALS in subscriptions UNIX sockets 🪪
• --subscription-algo — set load balancing algorithm for the subscription system ⚖️
• --subscription-dotsplit — try to fallback to the next part (dot based) in subscription key 🔍
• --subscribe-to — subscribe to the specified subscription server 📬
• --st — subscribe to the specified subscription server 📬
• --subscribe — subscribe to the specified subscription server 📬
• --subscribe2 — subscribe to the specified subscription server using advanced keyval syntax 🗝️
• --subscribe-freq — send subscription announce at the specified interval 📣
• --subscription-tolerance — set tolerance for subscription servers 🤝
• --unsubscribe-on-graceful-reload — force unsubscribe request even during graceful reload 🚪
• --start-unsubscribed — configure subscriptions but do not send them (useful with master fifo) 🛑
• --subscribe-with-modifier1 — force the specififed modifier1 when subscribing 🧩
• --snmp — enable the embedded snmp server 🌐
• --snmp-community — set the snmp community string 🔑
• --ssl-verbose — be verbose about SSL errors 🗣️
• --ssl-verify-depth — set maximum certificate verification depth 📏
• --sni — add an SNI-governed SSL context 🎫
• --sni-dir — check for cert/key/client_ca file in the specified directory and create a sni/ssl context on demand 📂
• --sni-dir-ciphers — set ssl ciphers for sni-dir option 🔒
• --ssl-enable3 — enable SSLv3 (insecure) ⚠️
• --ssl-enable-sslv3 — enable SSLv3 (insecure) ⚠️
• --ssl-enable-tlsv1 — enable TLSv1 (insecure) ⚠️
• --ssl-option — set a raw ssl option (numeric value) 🔢
• --sni-regexp — add an SNI-governed SSL context (the key is a regexp) 🧩
• --ssl-tmp-dir — store ssl-related temp files in the 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 💣
• --binary-path — force binary path 📍
• --privileged-binary-patch — patch the uwsgi binary with a new command (before privileges drop) 🩹
• --unprivileged-binary-patch — patch the uwsgi binary with a new command (after privileges drop) 🩹
• --privileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments (before privileges drop) 🩹
• --unprivileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments (after privileges drop) 🩹
• --async — enable async mode with specified cores ⚡
• --max-fd — set maximum number of file descriptors (requires root privileges) 📂
• --logto — set logfile/udp address 📝
• --logto2 — log to specified file or udp address after privileges drop 📝
• --log-format — set advanced format for request logging 🎨
• --logformat — set advanced format for request logging 🎨
• --logformat-strftime — apply strftime to logformat output 🕰️
• --log-format-strftime — apply strftime to logformat output 🕰️
• --logfile-chown — chown logfiles 👤
• --logfile-chmod — chmod logfiles 🔧
• --log-syslog — log to syslog 📋
• --log-socket — send logs to the specified socket 🔌
• --req-logger — set/append a request logger 📋
• --logger-req — set/append a request logger 📋
• --logger — set/append a logger 📋
• --logger-list — list enabled loggers 📃
• --loggers-list — list enabled loggers 📃
• --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 regexp applied on logline matches 🛣️
• --log-req-route — log requests to the specified named logger if regexp applied on logline matches 🛣️
• --use-abort — call abort() on segfault/fpe, could be useful for generating a core dump 💥
• --alarm — create a new alarm, syntax: <alarm> <plugin:args> 🚨
• --alarm-cheap — use main alarm thread rather than create dedicated threads for curl-based alarms 🧵
• --alarm-freq — tunes the anti-loop alarm system, and the default is 3 seconds. it's the vibe check that stops your alarms from spam-firing ✨
• --alarm-fd — fires the alarm you picked whenever an fd gets read for read. by default it reads 1 byte, but set it to 8 if you're dealing with an eventfd 💅
• --alarm-segfault — raises the alarm you name whenever the segmentation fault handler runs 😭
• --segfault-alarm — same exact energy: raises the alarm you name when the segmentation fault handler runs 💀
• --alarm-backlog — raises the alarm you name when the socket backlog queue is full 🫣
• --backlog-alarm — again bestie, raises the alarm you name when the socket backlog queue is full
• --lq-alarm — raises the alarm you name when the socket backlog queue is full (yes, the same thing, just a different alias ✨)
• --alarm-lq — raises the alarm you name when the socket backlog queue is full
• --alarm-listen-queue — raises the alarm you name when the socket backlog queue is full
• --listen-queue-alarm — raises the alarm you name when the socket backlog queue is full, iconic of it
• --log-alarm — raises the alarm you name whenever a log line matches your regexp. syntax is <alarm>[,alarm...] <regexp> 🔍
• --alarm-log — same thing, raises the alarm you name when a log line matches the regexp. syntax: <alarm>[,alarm...] <regexp>
• --not-log-alarm — skips the alarm you name when a log line matches the regexp. syntax: <alarm>[,alarm...] <regexp>
• --not-alarm-log — skips the alarm you name when a log line matches the regexp. syntax: <alarm>[,alarm...] <regexp>
• --alarm-list — lists all the enabled alarms 📋
• --alarms-list — also lists the enabled alarms, bc one alias is never enough
• --alarm-msg-size — sets the max size of an alarm message, default 8192 💖
• --log-master — delegates logging to the master process 👑
• --log-master-bufsize — sets the buffer size for the master logger. heads up bestie, bigger log messages get truncated
• --log-master-stream — creates the master logpipe as SOCK_STREAM 🦋
• --log-master-req-stream — creates the master requests logpipe as SOCK_STREAM
• --log-reopen — reopens the log after a reload 🔄
• --log-truncate — truncates the log on startup, clean slate energy ✨
• --log-maxsize — sets the maximum logfile size
• --log-backupname — sets the logfile name to use after rotation 🎀
• --logdate — prefixes logs with a date, or with a strftime string 📅
• --log-date — prefixes logs with a date or a strftime string (same vibe, different spelling)
• --log-prefix — prefixes logs with a string you choose 💅
• --log-zero — logs responses that have no body
• --log-slow — logs requests that are slower than the number of milliseconds you specify 🐌
• --log-4xx — logs requests that got a 4xx response
• --log-5xx — logs requests that got a 5xx response 😭
• --log-big — logs requestes bigger than the size you specify (yes, the typo is theirs, we're keeping it fr fr)
• --log-sendfile — logs sendfile requests
• --log-ioerror — logs requests that hit io errors 💀
• --log-micros — reports response time in microseconds instead of milliseconds ⏱️
• --log-x-forwarded-for — uses the ip from the X-Forwarded-For header instead of REMOTE_ADDR
• --master-as-root — leaves the master process running as root 👑 (yes, it's giving dangerous, be careful)
• --drop-after-init — runs the privileges drop after plugin initialization, and it's superseded by drop-after-apps
• --drop-after-apps — runs the privileges drop after apps loading, and it's superseded by master-as-root
• --force-cwd — forces the initial working directory to the value you give it 📁
• --binsh — overrides /bin/sh (used by exec hooks, and it always falls back to /bin/sh) 🐚
• --chdir — chdirs to the directory you specify before apps loading
• --chdir2 — chdirs to the directory you specify after apps loading
• --lazy — sets lazy mode (loads apps in workers instead of the master) 😴
• --lazy-apps — loads apps in each worker instead of the master
• --cheap — sets cheap mode (spawns workers only after the first request) 💸
• --cheaper — sets cheaper mode (adaptive process spawning) 📉
• --cheaper-initial — sets the initial number of processes to spawn in cheaper mode
• --cheaper-algo — chooses the algorithm used for adaptive process spawning
• --cheaper-step — number of additional processes to spawn at each overload
• --cheaper-overload — increases workers after the overload you specify
• --cheaper-algo-list — lists the enabled cheapers algorithms
• --cheaper-algos-list — lists the enabled cheapers algorithms
• --cheaper-list — lists the enabled cheapers algorithms (three aliases, one job 💅)
• --cheaper-rss-limit-soft — won't spawn new workers if the total resident memory usage of all workers is higher than this limit
• --cheaper-rss-limit-hard — if total workers resident memory usage is higher, it tries to stop workers 🛑
• --idle — sets idle mode (puts uWSGI in cheap mode after inactivity) 😴
• --die-on-idle — shuts down uWSGI when it's idle 💀
• --mount — loads an application under the mountpoint you give it 📌
• --worker-mount — loads an application under a mountpoint in the worker you specify, or after workers spawn
• --threads — runs each worker in prethreaded mode with the number of threads you specify 🧵
• --thread-stacksize — sets threads stacksize
• --threads-stacksize — sets threads stacksize
• --thread-stack-size — sets threads stacksize
• --threads-stack-size — sets threads stacksize (four spellings, all iconic, all the same)
• --vhost — enables virtualhosting mode (based on the SERVER_NAME variable) 🌐
• --vhost-host — enables virtualhosting mode (based on the HTTP_HOST variable)
• --route — adds a route 🛣️
• --route-host — adds a route based on the Host header
• --route-uri — adds a route based on REQUEST_URI
• --route-qs — adds a route based on QUERY_STRING
• --route-remote-addr — adds a route based on REMOTE_ADDR
• --route-user-agent — adds a route based on HTTP_USER_AGENT
• --route-remote-user — adds a route based on REMOTE_USER
• --route-referer — adds a route based on HTTP_REFERER
• --route-label — adds a routing label (for use with goto) 🏷️
• --route-if — adds a route based on a condition
• --route-if-not — adds a route based on a condition (the negate version) 🙃
• --route-run — always runs the route action you specify
• --final-route — adds a final route 🏁
• --final-route-status — adds a final route for the status you specify
• --final-route-host — adds a final route based on the Host header
• --final-route-uri — adds a final route based on REQUEST_URI
• --final-route-qs — adds a final route based on QUERY_STRING
• --final-route-remote-addr — adds a final route based on REMOTE_ADDR
• --final-route-user-agent — adds a final route based on HTTP_USER_AGENT
• --final-route-remote-user — adds a final route based on REMOTE_USER
• --final-route-referer — adds a final route based on HTTP_REFERER
• --final-route-label — adds a final routing label (for use with goto) 🏷️
• --final-route-if — adds a final route based on a condition
• --final-route-if-not — adds a final route based on a condition (negate version) 🙃
• --final-route-run — always runs the final route action you specify
• --error-route — adds an error route 🚨
• --error-route-status — adds an error route for the status you specify
• --error-route-host — adds an error route based on the Host header
• --error-route-uri — adds an error route based on REQUEST_URI
• --error-route-qs — adds an error route based on QUERY_STRING
• --error-route-remote-addr — adds an error route based on REMOTE_ADDR
• --error-route-user-agent — adds an error route based on HTTP_USER_AGENT
• --error-route-remote-user — adds an error route based on REMOTE_USER
• --error-route-referer — adds an error route based on HTTP_REFERER
• --error-route-label — adds an error routing label (for use with goto) 🏷️
• --error-route-if — adds an error route based on a condition
• --error-route-if-not — adds an error route based on a condition (negate version) 🙃
• --error-route-run — always runs the error route action you specify
• --response-route — adds a response route 📬
• --response-route-status — adds a response route for the status you specify
• --response-route-host — adds a response route based on the Host header
• --response-route-uri — adds a response route based on REQUEST_URI
• --response-route-qs — adds a response route based on QUERY_STRING
• --response-route-remote-addr — adds a response route based on REMOTE_ADDR
• --response-route-user-agent — adds a response route based on HTTP_USER_AGENT
• --response-route-remote-user — adds a response route based on REMOTE_USER
• --response-route-referer — adds a response route based on HTTP_REFERER
• --response-route-label — adds a response routing label (for use with goto) 🏷️
• --response-route-if — adds a response route based on a condition
• --response-route-if-not — adds a response route based on a condition (negate version) 🙃
• --response-route-run — always runs the response route action you specify
• --router-list — lists the enabled routers 📋
• --routers-list — lists the enabled routers (yes bestie, plural alias, same list)
• --error-page-403 — adds an error page (html) for a managed 403 response 🚫
• --error-page-404 — adds an error page (html) for a managed 404 response 🔍
• --error-page-500 — adds an error page (html) for a managed 500 response 💥
• --websockets-ping-freq — sets the frequency (in seconds) of websockets automatic ping packets 🏓
• --websocket-ping-freq — sets the frequency (in seconds) of websockets automatic ping packets
• --websockets-pong-tolerance — sets the tolerance (in seconds) of the websockets ping/pong subsystem
• --websocket-pong-tolerance — sets the tolerance (in seconds) of the websockets ping/pong subsystem
• --websockets-max-size — sets the max allowed size of websocket messages (in Kbytes, default 1024) 📏
• --websocket-max-size — sets the max allowed size of websocket messages (in Kbytes, default 1024)
• --chunked-input-limit — sets the max size of a chunked input part (default 1MB, in bytes)
• --chunked-input-timeout — sets the default timeout for chunked input ⏳
• --clock — sets a clock source 🕰️
• --clock-list — lists the enabled clocks
• --clocks-list — lists the enabled clocks
• --add-header — automatically adds HTTP headers to the response ✨
• --rem-header — automatically remove the specified HTTP header from the response 💖
• --del-header — same energy: automatically remove the specified HTTP header from the response 🗑️
• --collect-header — store the specified response header in a request var (syntax: header var) 📥
• --response-header-collect — store the specified response header in a request var (syntax: header var) ✨
• --pull-header — store the specified response header in a request var and remove it from the response (syntax: header var) 💅
• --check-static — check for static files in the specified directory 📂
• --check-static-docroot — check for static files in the requested DOCUMENT_ROOT 🌳
• --static-check — check for static files in the specified directory 🔍
• --static-map — map a mountpoint to a static directory (or file) 🗺️
• --static-map2 — like --static-map but it completely appends the requested resource to the docroot 🧩
• --static-skip-ext — skip the specified extension from staticfile checks ⏭️
• --static-index — search for the specified file if a directory is requested 📇
• --static-safe — skip security checks if the file is under the specified path 🛡️
• --static-cache-paths — put resolved paths in the uWSGI cache for the specified amount of seconds ⏳
• --static-cache-paths-name — use the specified cache for static paths 🏷️
• --mimefile — set the mime types file path (default /etc/mime.types) 📄
• --mime-file — set the mime types file path (default /etc/mime.types) 🗂️
• --static-expires-type — set the Expires header based on content type 📅
• --static-expires-type-mtime — set the Expires header based on content type and file mtime 🕰️
• --static-expires — set the Expires header based on filename regexp 🔎
• --static-expires-mtime — set the Expires header based on filename regexp and file mtime 📆
• --static-expires-uri — set the Expires header based on REQUEST_URI regexp 🔗
• --static-expires-uri-mtime — set the Expires header based on REQUEST_URI regexp and file mtime ⏱️
• --static-expires-path-info — set the Expires header based on PATH_INFO regexp 🛤️
• --static-expires-path-info-mtime — set the Expires header based on PATH_INFO regexp and file mtime 🕓
• --static-gzip — if the supplied regexp matches the static file translation, it will search for a gzip version 🗜️
• --static-gzip-all — check for a gzip version of all requested static files 🧬
• --static-gzip-dir — check for a gzip version of all requested static files in the specified dir/prefix 📁
• --static-gzip-prefix — check for a gzip version of all requested static files in the specified dir/prefix 🏷️
• --static-gzip-ext — check for a gzip version of all requested static files with the specified ext/suffix 🔤
• --static-gzip-suffix — check for a gzip version of all requested static files with the specified ext/suffix 🧾
• --honour-range — enable support for the HTTP Range header 📏
• --offload-threads — set the number of offload threads to spawn (per-worker, default 0) 🧵
• --offload-thread — set the number of offload threads to spawn (per-worker, default 0) 🪡
• --file-serve-mode — set static file serving mode 🚚
• --fileserve-mode — set static file serving mode 📦
• --disable-sendfile — disable sendfile() and rely on boring read()/write() 😴
• --check-cache — check for response data in the specified cache (empty for default cache) 🗄️
• --close-on-exec — set close-on-exec on connection sockets (could be required for spawning processes in requests) 🔒
• --close-on-exec2 — set close-on-exec on server sockets (could be required for spawning processes in requests) 🔐
• --mode — set uWSGI custom mode 🎛️
• --env — set environment variable 🌱
• --envdir — load a daemontools compatible envdir 📂
• --early-envdir — load a daemontools compatible envdir ASAP ⚡
• --unenv — unset environment variable 🚫
• --vacuum — try to remove all of the generated file/sockets 🧹
• --file-write — write the specified content to the specified file (syntax: file=value) before privileges drop ✍️
• --cgroup — put the processes in the specified cgroup 🧺
• --cgroup-opt — set value in specified cgroup option ⚙️
• --cgroup-dir-mode — set permission for cgroup directory (default is 700) 🔐
• --namespace — run in a new namespace under the specified rootfs 🌌
• --namespace-keep-mount — keep the specified mountpoint in your namespace 📌
• --ns — run in a new namespace under the specified rootfs 🌠
• --namespace-net — add network namespace 🌐
• --ns-net — add network namespace 🕸️
• --enable-proxy-protocol — enable PROXY1 protocol support (only for http parsers) 📡
• --reuse-port — enable REUSE_PORT flag on socket (BSD only) ♻️
• --tcp-fast-open — enable TCP_FASTOPEN flag on TCP sockets with the specified qlen value 🚀
• --tcp-fastopen — enable TCP_FASTOPEN flag on TCP sockets with the specified qlen value 💨
• --tcp-fast-open-client — use sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported 📤
• --tcp-fastopen-client — use sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported 📥
• --zerg — attach to a zerg server 👾
• --zerg-fallback — fallback to normal sockets if the zerg server is not available 🛟
• --zerg-server — enable the zerg server on the specified UNIX socket 🐜
• --cron — add a cron task ⏰
• --cron2 — add a cron task (key=val syntax) 🗓️
• --unique-cron — add a unique cron task 🌟
• --cron-harakiri — set the maximum time (in seconds) we wait for cron command to complete ⌛
• --legion-cron — add a cron task runnable only when the instance is a lord of the specified legion 👑
• --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 — list enabled loop engines 📋
• --loops-list — list enabled loop engines 📝
• --worker-exec — run the specified command as worker 🧑‍🏭
• --worker-exec2 — run the specified command as worker (after post_fork hook) 🔄
• --attach-daemon — attach a command/daemon to the master process (the command has to not go in background) 🧷
• --attach-control-daemon — attach a command/daemon to the master process (the command has to not go in background); when the daemon dies, the master dies too 💀
• --smart-attach-daemon — attach a command/daemon to the master process managed by a pidfile (the command has to daemonize) 🧠
• --smart-attach-daemon2 — attach a command/daemon to the master process managed by a pidfile (the command has to NOT daemonize) 🚫
• --legion-attach-daemon — same as --attach-daemon but the daemon runs only 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 — do not change the stdin of external daemons to /dev/null 🛑
• --attach-daemon2 — attach-daemon keyval variant (supports smart modes too) 🔑
• --plugins — load uWSGI plugins 🔌
• --plugin — load uWSGI plugins 🧩
• --need-plugins — load uWSGI plugins (exit on error) ❗
• --need-plugin — load uWSGI plugins (exit on error) ‼️
• --plugins-dir — add a directory to uWSGI plugin search path 📁
• --plugin-dir — add a directory to uWSGI plugin search path 🗂️
• --plugins-list — list enabled plugins 📃
• --plugin-list — list enabled plugins 📜
• --autoload — try to automatically load plugins when unknown options are found 🤖
• --dlopen — blindly load a shared library 🙈
• --allowed-modifiers — comma separated list of allowed modifiers ✅
• --remap-modifier — remap request modifier from one id to another 🔀
• --dump-options — dump the full list of available options 🗃️
• --show-config — show the current config reformatted as ini 📝
• --binary-append-data — return the content of a resource to stdout for appending to a uwsgi binary (for data:// usage) 📎
• --print — simple print 🖨️
• --iprint — simple print (immediate version) ⚡
• --exit — force exit() of the instance 🚪
• --cflags — report uWSGI CFLAGS (useful for building external plugins) 🏗️
• --dot-h — dump the uwsgi.h used for building the core (useful for building external plugins) 📄
• --config-py — dump the uwsgiconfig.py used for building the core (useful for building external plugins) 🐍
• --build-plugin — build a uWSGI plugin for the current binary 🔨
• --version — print uWSGI version 🏷️
• --response-headers-limit — set response header maximum size (default: 64k) 📏

---

and that’s a wrap on the options, bestie! source/version: uwsgi_jvm_openjdk17 2.0.24-debian, April 2024, from the UWSGI_JVM_OPENJDK17(1) manual — go hydrate and touch some grass, you absolute legend 💖🌸