UWSGI_JVM(1)

📦

version 2.0.31+3+0.0.7 · 3 versions

2.0.31+3+0.0.7 · ubuntu resolute, ubuntu stonking (latest)
2.0.29+1build1+0.0.6 · ubuntu questing
2.0.28+8+0.0.5 · debian trixie

💖 UWSGI_JVM(1) — User Commands 💖

okay bestie, welcome to UWSGI_JVM(1) — aka uwsgi_jvm(1) — from User Commands. this is the manual page we're about to go through like it's a group chat recap. no cap, nothing skipped. 🫶

✨ NAME ✨

uwsgi_jvm — fast (pure C), self-healing, developer-friendly WSGI server. it's giving iconic server behavior, fr fr. 💅

🌸 SYNOPSIS 🌸

uwsgi-core [options...]

💅 DESCRIPTION 💅

okay so here's the whole option buffet. every flag, every vibe, every "bestie what does this do" answered. let's get into it. ✨

-s, --socket — bind to the specified UNIX/TCP socket using default protocol. this is your main "where do I listen" moment. 💖
-s, --uwsgi-socket — bind to the specified UNIX/TCP socket using uwsgi protocol. keep the protocol as uwsgi, bestie. 🦋
--suwsgi-socket — bind to the specified UNIX/TCP socket using uwsgi protocol over SSL. secure vibes only. 🔒
--ssl-socket — bind to the specified UNIX/TCP socket using uwsgi protocol over SSL. same SSL energy, different flag name. ✨
--http-socket — bind to the specified UNIX/TCP socket using HTTP protocol. yes, plain HTTP, no cap. 🌐
--http-socket-modifier1 — force the specified modifier1 when using HTTP protocol. 💅
--http-socket-modifier2 — force the specified modifier2 when using HTTP protocol. 💅
--http11-socket — bind to the specified UNIX/TCP socket using HTTP 1.1 (Keep-Alive) protocol. keep-alive, keep thriving. 🔥
--https-socket — bind to the specified UNIX/TCP socket using HTTPS protocol. secure and slaying. 🔐
--https-socket-modifier1 — force the specified modifier1 when using HTTPS protocol. ✨
--https-socket-modifier2 — force the specified modifier2 when using HTTPS protocol. ✨
--fastcgi-socket — bind to the specified UNIX/TCP socket using FastCGI protocol. old school but still cute. 🎀
--fastcgi-nph-socket — bind to the specified UNIX/TCP socket using FastCGI protocol (nph mode). note the (nph mode), bestie. 📝
--fastcgi-modifier1 — force the specified modifier1 when using FastCGI protocol. 💅
--fastcgi-modifier2 — force the specified modifier2 when using FastCGI protocol. 💅
--scgi-socket — bind to the specified UNIX/TCP socket using SCGI protocol. SCGI said hello. 👋
--scgi-nph-socket — bind to the specified UNIX/TCP socket using SCGI protocol (nph mode). again, (nph mode) is the moment. 🌸
--scgi-modifier1 — force the specified modifier1 when using SCGI protocol. ✨
--scgi-modifier2 — force the specified modifier2 when using SCGI protocol. ✨
--raw-socket — bind to the specified UNIX/TCP socket using RAW protocol. raw and unfiltered, iykyk. 💀
--raw-modifier1 — force the specified modifier1 when using RAW protocol. 💅
--raw-modifier2 — force the specified modifier2 when using RAW protocol. 💅
--puwsgi-socket — bind to the specified UNIX/TCP socket using persistent uwsgi protocol (puwsgi). persistent queen behavior. 👑
--protocol — force the specified protocol for default sockets. default sockets, specified protocol. periodt. 💖
--socket-protocol — force the specified protocol for default sockets. same tea as above, different flag. 🍓
--shared-socket — create a shared socket for advanced jailing or ipc. advanced jailing/ipc besties, this one's for you. 🧚
--undeferred-shared-socket — create a shared socket for advanced jailing or ipc (undeferred mode). yes, (undeferred mode) is part of the vibe. ✨
-p, --processes — spawn the specified number of workers/processes. more processes, more main character energy. 💅
-p, --workers — spawn the specified number of workers/processes. same as above, just under the --workers name. 🫶
--thunder-lock — serialize accept() usage (if possible). thunder lock said "one at a time, bestie." ⚡
-t, --harakiri — set harakiri timeout. dramatic name, serious timeout. 🗡️
--harakiri-verbose — enable verbose mode for harakiri. verbose harakiri, because we need the details. 📣
--harakiri-graceful-timeout — interval between graceful harakiri attempt and a sigkill. yes, sigkill is the whole mood. 💀
--harakiri-graceful-signal — use this signal instead of sigterm for graceful harakiri attempts. pick your signal, bestie. 🚦
--harakiri-queue-threshold — only trigger harakiri if queue is greater than this threshold. threshold tea. 🍵
--harakiri-no-arh — do not enable harakiri during after-request-hook. no harakiri in the after-request-hook era. 🙅
--no-harakiri-arh — do not enable harakiri during after-request-hook. same rule, different alias. ✨
--no-harakiri-after-req-hook — do not enable harakiri during after-request-hook. the long-name version of the same boundary. 💖
--backtrace-depth — set backtrace depth. for when you need the stack trace to spill the tea. 🫖
--mule-harakiri — set harakiri timeout for mule tasks. mules get their own harakiri timer, periodt. 🐴
-x, --xmlconfig — load config from xml file. xml config loading, old school cute. 📄
-x, --xml — load config from xml file. same -x energy, shorter flag name. ✨
--config — load configuration using the pluggable system. pluggable system said "load me." 🔌
--fallback-config — re-exec uwsgi with the specified config when exit code is 1. fallback plan on exit code 1, no cap. 🚨
--strict — enable strict mode (placeholder cannot be used). strict mode is strict, bestie. 🚫
--skip-zero — skip check of file descriptor 0. fd 0 check skipped. 0️⃣
--skip-atexit — skip atexit hooks (ignored by the master). the master ignores this, but the flag exists. 💅
--skip-atexit-teardown — skip atexit teardown (ignored by the master). teardown skip, still ignored by the master. 🧹
-S, --set — set a placeholder or an option. placeholder or option, you choose. 🎀
--set-placeholder — set a placeholder. placeholder getting set, slay. ✨
--set-ph — set a placeholder. short version of placeholder-setting. 💖
--get — print the specified option value and exit. print it and dip. 🖨️
--declare-option — declare a new uWSGI custom option. custom option, custom vibes. 🛠️
--declare-option2 — declare a new uWSGI custom option (non-immediate). the (non-immediate) part matters. ⏳
--resolve — place the result of a dns query in the specified placeholder, sytax: placeholder=name (immediate option). yes, sytax is spelled like that in the source, bestie. 🌐
--for — (opt logic) for cycle. opt logic for-cycle moment. 🔁
--for-glob — (opt logic) for cycle (expand glob). glob expansion included. ✨
--for-times — (opt logic) for cycle (expand the specified num to a list starting from 1). starts from 1, no cap. 1️⃣
--for-readline — (opt logic) for cycle (expand the specified file to a list of lines). file lines become list items. 📄
--endfor — (opt logic) end for cycle. close that for cycle. 🔚
--end-for — (opt logic) end for cycle. same ending, hyphenated. ✨
--if-opt — (opt logic) check for option. opt logic if-option check. ❓
--if-not-opt — (opt logic) check for option. the "not" version still checks for option. 🤔
--if-env — (opt logic) check for environment variable. env var check, bestie. 🌱
--if-not-env — (opt logic) check for environment variable. same check, "not" flavor. 🍋
--ifenv — (opt logic) check for environment variable. short alias for the env check. ✨
--if-reload — (opt logic) check for reload. reload check incoming. 🔄
--if-not-reload — (opt logic) check for reload. reload check, but negated. 🚫
--if-hostname — (opt logic) check for hostname. hostname check, periodt. 🖥️
--if-not-hostname — (opt logic) check for hostname. hostname check, negated. 🙅
--if-hostname-match — (opt logic) try to match hostname against a regular expression. regex hostname matching, iykyk. 🧠
--if-not-hostname-match — (opt logic) try to match hostname against a regular expression. same regex, negated. ✨
--if-exists — (opt logic) check for file/directory existence. existence check for file/directory. 📁
--if-not-exists — (opt logic) check for file/directory existence. existence check, negated. 🚫
--ifexists — (opt logic) check for file/directory existence. short alias for existence checking. ✨
--if-plugin — (opt logic) check for plugin. plugin check, bestie. 🔌
--if-not-plugin — (opt logic) check for plugin. plugin check, negated. 🙅
--ifplugin — (opt logic) check for plugin. short plugin check. 💅
--if-file — (opt logic) check for file existence. file existence check. 📄
--if-not-file — (opt logic) check for file existence. file existence check, negated. 🚫
--if-dir — (opt logic) check for directory existence. directory existence check. 📂
--if-not-dir — (opt logic) check for directory existence. directory existence check, negated. 🚫
--ifdir — (opt logic) check for directory existence. short directory check. ✨
--if-directory — (opt logic) check for directory existence. long-form directory check. 📁
--endif — (opt logic) end if. close that if block. 🔚
--end-if — (opt logic) end if. same ending, hyphenated. ✨
--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. yes, (annoying) is in the original. 🚫
--ignore-write-errors — do not report (annoying) write()/writev() errors. ignore those annoying write errors. 🙈
--write-errors-tolerance — set the maximum number of allowed write errors (default: no tolerance). default is no tolerance, so don't push it. 💀
--write-errors-exception-only — only raise an exception on write errors giving control to the app itself. app gets the control. 🎮
--disable-write-exception — disable exception generation on write()/writev(). no exception generation on those calls. 🚫
--inherit — use the specified file as config template. config template energy. 📄
--include — include the specified file as immediate configuration. immediate configuration included. ⚡
--inject-before — inject a text file before the config file (advanced templating). before the config file, advanced templating. ✨
--inject-after — inject a text file after the config file (advanced templating). after the config file, advanced templating. ✨
-d, --daemonize — daemonize uWSGI. daemon mode, slay. 👻
--daemonize2 — daemonize uWSGI after app loading. daemonize after app loading, no cap. ⏳
--stop — stop an instance. stop that instance. 🛑
--reload — reload an instance. reload that instance. 🔄
--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 wait for data. 📡
--extract — fetch/dump any supported address to stdout. dump supported 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, bestie. 🧺
-m, --memory-report — enable memory report. memory report enabled. 🧠
--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). Linux only, abstract mode. 🐧
-C, --chmod-socket — chmod-socket. literally chmod-socket. 💅
-C, --chmod — chmod-socket. same -C energy, shorter name. ✨
--chown-socket — chown unix sockets. unix sockets get chowned. 👑
--umask — set umask. umask set. 🎭
--freebind — put socket in freebind mode. freebind mode, activated. 🕊️
--map-socket — map sockets to specific workers. map sockets to workers. 🗺️
-T, --enable-threads — enable threads (stub option this is true by default). stub option, and it's true by default. 🧵
--no-threads-wait — do not wait for threads cancellation on quit/reload. no waiting for threads cancellation 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. prefix added. ✨
--procname-prefix-spaced — add a spaced prefix to the process names. spaced prefix, because aesthetics. 💅
--procname-append — append a string to process names. append a string. ➕
--procname — set process names. set those process names. 📛
--procname-master — set master process name. master process name, set. 👑
-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 loaded? exit. 🚪
-M, --master — enable master process. master process enabled. 👑
--honour-stdin — do not remap stdin to /dev/null. keep stdin, do not remap to /dev/null. 🫶
--emperor — run the Emperor. run the Emperor. 👑
--emperor-proxy-socket — force the vassal to became an Emperor proxy. yes, "became" is what the page says, bestie. 🏰
--emperor-wrapper — set a binary wrapper for vassals. binary wrapper for vassals. 🎁
--emperor-wrapper-override — set a binary wrapper for vassals to try before the default one. try before the default one. 🥇
--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 checks. 🚫
--emperor-procname — set the Emperor process name. Emperor process name, set. 👑
--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 vassals tolerance, no cap. 💀

✨ OPTIONS ✨

okay bestie, buckle UP, this is the big one 💅 Emperor stuff first, because the Emperor is literally the main character here 👑

--emperor-pidfile — drops the Emperor's pid into the file you name 📝
--emperor-tyrant — flips the Emperor into Tyrant mode 👑 (yes it's giving monarchy)
--emperor-tyrant-nofollow — in Tyrant mode, don't follow symlinks while it's checking for uid/gid 🚫🔗
--emperor-stats — spin up the Emperor stats server 📊
--emperor-stats-server — same thing, spin up the Emperor stats server 📊
--early-emperor — spawn the emperor as soon as possible ⏩
--emperor-broodlord — run the emperor in BroodLord mode 🐉
--emperor-throttle — sets the throttling level, in milliseconds, for vassals that are being bad (default is 1000) 😤
--emperor-max-throttle — sets the max throttling level, in milliseconds, for badly behaved vassals (default is 3 minutes) 🔥
--emperor-magic-exec — prefixes vassals' config files with exec:// if they've got the executable bit set ✨
--emperor-on-demand-extension — looks for a text file (vassal name + extension) that contains the on demand socket name 🔍
--emperor-on-demand-ext — same deal, looks for that text file (vassal name + extension) holding the on demand socket name 🔍
--emperor-on-demand-directory — turns on on demand mode, binding to the unix socket in the directory you specify, named like the vassal + .socket 🧦
--emperor-on-demand-dir — yep, same thing: on demand mode, unix socket in your directory, named like the vassal + .socket 🧦
--emperor-on-demand-exec — uses the output of the command you give as the on demand socket name (the vassal name gets passed as the only argument) 📜
--emperor-extra-extension — lets the Emperor allow the extension you specify (the vassal gets called with --config) 🎀
--emperor-extra-ext — same energy: allows your specified extension in the Emperor (vassal gets called with --config) 🎀
--emperor-no-blacklist — turns off the Emperor blacklisting subsystem 💀🚫
--emperor-use-clone — uses clone() instead of fork(), passing the unshare() flags you specify 🧬
--emperor-graceful-shutdown — uses vassals' graceful shutdown during ragnarok 🌋 (yes, ragnarok, iconic)
--emperor-cap — sets vassals capability 🎩
--vassals-cap — sets vassals capability 🎩
--vassal-cap — sets vassals capability 🎩
--imperial-monitor-list — lists the enabled imperial monitors 👀
--imperial-monitors-list — lists the enabled imperial monitors 👀
--vassals-inherit — adds config templates to vassals config (it uses --inherit) 🧬
--vassals-include — includes config templates into vassals config (it uses --include instead of --inherit) 📥
--vassals-inherit-before — adds config templates to vassals config (uses --inherit, and parses before the vassal file) 🧬⏪
--vassals-include-before — includes config templates into vassals config (uses --include instead of --inherit, and parses before the vassal file) 📥⏪
--vassals-start-hook — runs the command you specify before every vassal starts 🏁
--vassals-stop-hook — runs the command you specify after a vassal's death 🪦
--vassal-sos — asks the emperor for reinforcement when it's overloaded 🆘
--vassal-sos-backlog — asks the emperor for sos if the backlog queue has more items than the value you specified 📈
--vassals-set — automatically sets the option you specify (via --set) for every vassal 🎛️
--vassal-set — automatically sets the option you specify (via --set) for every vassal 🎛️
--heartbeat — announces healthiness to the emperor 💓
--reload-mercy — sets the maximum time, in seconds, that we wait for workers and other processes to die during reload/shutdown ⏳
--worker-reload-mercy — sets the max time, in seconds, a worker can take to reload/shutdown (default is 60) ⏳
--mule-reload-mercy — sets the max time, in seconds, a mule can take to reload/shutdown (default is 60) 🫏⏳
--exit-on-reload — forces exit even if a reload is requested 🚪
--die-on-term — exits instead of doing a brutal reload on SIGTERM 💀
--force-gateway — forces the spawn of the first registered gateway without a master 🚪✨

and now the lil helpers 🫶

-h|--help — shows this help 🙋
-h|--usage — shows this help 🙋
--print-sym — prints the content of the binary symbol you specify 🔎
--print-symbol — prints the content of the binary symbol you specify 🔎
-r|--reaper — calls waitpid(-1,...) after each request so the zombies get gone 🧟♀️🚫
-R|--max-requests — reloads workers after the specified amount of managed requests 🔄
--max-requests-delta — adds (worker_id * delta) to the max_requests value of each worker ➕
--min-worker-lifetime — the number of seconds a worker must run before it can be reloaded (default is 10) ⏱️
--max-worker-lifetime — reloads workers after the specified amount of seconds (default is disabled) ⏱️
--max-worker-lifetime-delta — adds (worker_id * delta) seconds to the max_worker_lifetime value of each worker ➕
-z|--socket-timeout — sets internal sockets timeout 🔌
--no-fd-passing — disables file descriptor passing 🚫📁
--locks — creates the specified number of shared locks 🔒
--lock-engine — sets the lock engine ⚙️
--ftok — set the ipcsem key via ftok() for avoiding duplicates 🔑
--persistent-ipcsem — does not remove ipcsem's on shutdown 🧲
-A|--sharedarea — creates a raw shared memory area of the specified pages (note: it supports keyval too) 🧠
--safe-fd — don't close the file descriptor you specify 🛟
--fd-safe — don't close the file descriptor you specify 🛟
--cache — creates a shared cache holding the given elements 🗃️
--cache-blocksize — sets the cache blocksize 🧱
--cache-store — enables persistent cache to disk 💾
--cache-store-sync — sets the sync frequency for the persistent cache 🔄
--cache-no-expire — disables the auto sweep of expired items 🧹🚫
--cache-expire-freq — sets how often the cache sweeper scans (default 3 seconds) 🧹
--cache-report-freed-items — constantly reports the cache item freed by the sweeper (use only for debug) 🐛
--cache-udp-server — binds the cache udp server (used only for set/update/delete) to the socket you specify 📡
--cache-udp-node — sends cache update/deletion to the cache udp server you specify 📤
--cache-sync — copies the whole content of another uWSGI cache server at server startup 📋
--cache-use-last-modified — updates the last_modified_at timestamp on every cache item modification (default is disabled) 🕰️
--add-cache-item — adds an item in the cache ➕
--load-file-in-cache — loads a static file into the cache 📂
--load-file-in-cache-gzip — loads a static file into the cache with gzip compression 🗜️
--cache2 — creates a new generation shared cache (keyval syntax) 🗃️✨
--queue — enables the shared queue 📬
--queue-blocksize — sets the queue blocksize 🧱
--queue-store — enables persistent queue to disk 💾
--queue-store-sync — sets the sync frequency for the persistent queue 🔄
-Q|--spooler — runs a spooler on the directory you specify 🧵
--spooler-external — maps spooler requests to a spooler directory managed by an external instance 🔗
--spooler-ordered — tries to order the execution of spooler tasks 🔢
--spooler-chdir — chdir()s to the specified directory before each spooler task 📁
--spooler-processes — sets the number of processes for spoolers 👯
--spooler-quiet — don't be verbose with spooler tasks 🤫
--spooler-max-tasks — sets the max number of tasks to run before recycling a spooler ♻️
--spooler-harakiri — sets the harakiri timeout for spooler tasks ⚔️
--spooler-frequency — sets the spooler frequency 📶
--spooler-freq — sets the spooler frequency 📶
--mule — add a mule 🫏
--mules — add the specified number of mules 🫏🫏🫏
--farm — add a mule farm 🚜
--mule-msg-size — sets the mule message buffer size 📨
--signal — sends a uwsgi signal to a server 📶
--signal-bufsize — sets the buffer size for the signal queue 📦
--signals-bufsize — sets the buffer size for the signal queue 📦
--signal-timer — adds a timer (syntax: <signal> <seconds>) ⏲️
--timer — adds a timer (syntax: <signal> <seconds>) ⏲️
--signal-rbtimer — adds a redblack timer (syntax: <signal> <seconds>) ⏲️🌲
--rbtimer — adds a redblack timer (syntax: <signal> <seconds>) ⏲️🌲
--rpc-max — the maximum number of rpc slots (default: 64) 🎰
-L|--disable-logging — disables request logging 🤐
--flock — locks the file you specify before starting, and exits if it's locked 🔒
--flock-wait — locks the file you specify before starting, and waits if it's locked ⏳🔒
--flock2 — locks the file you specify after logging/daemon setup, exits if locked 🔒
--flock-wait2 — locks the file you specify after logging/daemon setup, waits if locked ⏳🔒
--pidfile — creates a pidfile (before the privileges drop) 📝
--pidfile2 — creates a pidfile (after the privileges drop) 📝
--safe-pidfile — creates a safe pidfile (before the privileges drop) 🛟📝
--safe-pidfile2 — creates a safe pidfile (after the privileges drop) 🛟📝
--chroot — chroot()s to the directory you specify 📦
--pivot-root — pivot_root()s to the directories you specify (new_root and put_old must be separated with a space) 🔄
--pivot_root — pivot_root()s to the directories you specify (new_root and put_old must be separated with a space) 🔄
--uid — setuid to the user/uid you specify 🆔
--gid — setgid to the group/gid you specify 🆔
--add-gid — adds the group id you specify to the process credentials ➕🆔
--immediate-uid — setuid to the user/uid you specify IMMEDIATELY ⚡🆔
--immediate-gid — setgid to the group/gid you specify IMMEDIATELY ⚡🆔
--no-initgroups — disables the additional groups set via initgroups() 🚫👥
--cap — set process capability 🎩
--unshare — unshare()s part of the processes and puts it in a new namespace 🌌
--unshare2 — unshare()s part of the processes and puts it in a new namespace after the rootfs change 🌌
--setns-socket — exposes a unix socket returning namespace fds from /proc/self/ns 🔌
--setns-socket-skip — skips the entry you specify when sending setns file descriptors ⏭️
--setns-skip — skips the entry you specify when sending setns file descriptors ⏭️
--setns — joins a namespace created by an external uWSGI instance 🌌
--setns-preopen — opens /proc/self/ns as soon as possible and caches the fds 🗂️

and that's the vibes so far, bestie — more coming, don't go anywhere 🦋

--jailed — marks the instance as jailed, which forces the execution of post_jail hooks. 💅
--refork — fork() again after privileges drop. Useful for jailing systems. 🔁
--re-fork — yep, same thing: 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 — fork() again before privileges drop. Useful for jailing systems. 🔁
--refork-post-jail — fork() again after jailing. Useful for jailing systems. 🔁
--re-fork-post-jail — fork() again after jailing. Useful for jailing systems. 🔁
--hook-asap — runs the specified hook as soon as possible. ⚡
--hook-pre-jail — runs the specified hook before jailing. 🔒
--hook-post-jail — runs the specified hook after jailing. 🔓
--hook-in-jail — runs the specified hook in jail after initialization. 🏢
--hook-as-root — runs the specified hook before privileges drop. 👑
--hook-as-user — runs the specified hook after privileges drop. 🙋
--hook-as-user-atexit — runs the specified hook before app exit and reload. 🚪
--hook-pre-app — runs the specified hook before app loading. 📦
--hook-post-app — runs the specified hook after app loading. ✅
--hook-post-fork — runs the specified hook after each fork. 🍴
--hook-accepting — runs the specified hook after each worker enters the accepting phase. 👀
--hook-accepting1 — runs the specified hook after the first worker enters the accepting phase. 🥇
--hook-accepting-once — runs the specified hook after each worker enters the accepting phase, but once per-instance. 1️⃣
--hook-accepting1-once — runs the specified hook after the first worker enters the accepting phase, once per instance. 🥇1️⃣
--hook-master-start — runs the specified hook when the Master starts. 👑
--hook-touch — runs the specified hook when the specified file is touched. Syntax: <file> <action>. 👆
--hook-emperor-start — runs the specified hook when the Emperor starts. 👑👑
--hook-emperor-stop — runs the specified hook when the Emperor sends a stop message. 🛑
--hook-emperor-reload — runs the specified hook when the Emperor sends a reload message. 🔄
--hook-emperor-lost — runs the specified hook when the Emperor connection is lost. 💔
--hook-as-vassal — runs the specified hook before exec()ing the vassal. 🧑🤝🧑
--hook-as-emperor — runs the specified hook in the emperor after the vassal has been started. 👑
--hook-as-mule — runs the specified hook in each mule. 🐴
--hook-as-gateway — runs the specified hook in each gateway. 🚪
--after-request-hook — runs the specified function/symbol after each request. 🔁
--after-request-call — runs the specified function/symbol after each request. 🔁
--exec-asap — runs the specified command as soon as possible. ⚡
--exec-pre-jail — runs the specified command before jailing. 🔒
--exec-post-jail — runs the specified command after jailing. 🔓
--exec-in-jail — runs the specified command in jail after initialization. 🏢
--exec-as-root — runs the specified command before privileges drop. 👑
--exec-as-user — runs the specified command after privileges drop. 🙋
--exec-as-user-atexit — runs the specified command before app exit and reload. 🚪
--exec-pre-app — runs the specified command before app loading. 📦
--exec-post-app — runs the specified command after app loading. ✅
--exec-as-vassal — runs the specified command before exec()ing the vassal. 🧑🤝🧑
--exec-as-emperor — runs the specified command in the emperor after the vassal has been started. 👑
--mount-asap — mounts filesystem as soon as possible. 📁
--mount-pre-jail — mounts filesystem before jailing. 🔒
--mount-post-jail — mounts filesystem after jailing. 🔓
--mount-in-jail — mounts filesystem in jail after initialization. 🏢
--mount-as-root — mounts filesystem before privileges drop. 👑
--mount-as-vassal — mounts filesystem before exec()ing the vassal. 🧑🤝🧑
--mount-as-emperor — mounts filesystem in the emperor after the vassal has been started. 👑
--umount-asap — unmounts filesystem as soon as possible. 📂
--umount-pre-jail — unmounts filesystem before jailing. 🔒
--umount-post-jail — unmounts filesystem after jailing. 🔓
--umount-in-jail — unmounts filesystem in jail after initialization. 🏢
--umount-as-root — unmounts filesystem before privileges drop. 👑
--umount-as-vassal — unmounts filesystem before exec()ing the vassal. 🧑🤝🧑
--umount-as-emperor — unmounts filesystem in the emperor after the vassal has been started. 👑
--wait-for-interface — waits for the specified network interface to come up before running root hooks. 📡
--wait-for-interface-timeout — sets the timeout for wait-for-interface. ⏱️
--wait-interface — waits for the specified network interface to come up before running root hooks. 📡
--wait-interface-timeout — sets the timeout for wait-for-interface. ⏱️
--wait-for-iface — waits for the specified network interface to come up before running root hooks. 📡
--wait-for-iface-timeout — sets the timeout for wait-for-interface. ⏱️
--wait-iface — waits for the specified network interface to come up before running root hooks. 📡
--wait-iface-timeout — sets the timeout for wait-for-interface. ⏱️
--wait-for-fs — waits for the specified filesystem item to appear before running root hooks. 📁
--wait-for-file — waits for the specified file to appear before running root hooks. 📄
--wait-for-dir — waits for the specified directory to appear before running root hooks. 📂
--wait-for-mountpoint — waits for the specified mountpoint to appear before running root hooks. 📍
--wait-for-fs-timeout — sets the timeout for wait-for-fs/file/dir. ⏱️
--wait-for-socket — waits for the specified socket to be ready before loading apps. 🔌
--wait-for-socket-timeout — sets the timeout for wait-for-socket. ⏱️
--call-asap — calls the specified function as soon as possible. ⚡
--call-pre-jail — calls the specified function before jailing. 🔒
--call-post-jail — calls the specified function after jailing. 🔓
--call-in-jail — calls the specified function in jail after initialization. 🏢
--call-as-root — calls the specified function before privileges drop. 👑
--call-as-user — calls the specified function after privileges drop. 🙋
--call-as-user-atexit — calls the specified function before app exit and reload. 🚪
--call-pre-app — calls the specified function before app loading. 📦
--call-post-app — calls the specified function after app loading. ✅
--call-as-vassal — calls the specified function() before exec()ing the vassal. 🧑🤝🧑
--call-as-vassal1 — calls the specified function(char *) before exec()ing the vassal. 🧑🤝🧑
--call-as-vassal3 — calls the specified function(char *, uid_t, gid_t) before exec()ing the vassal. 🧑🤝🧑
--call-as-emperor — calls the specified function() in the emperor after the vassal has been started. 👑
--call-as-emperor1 — calls the specified function(char *) in the emperor after the vassal has been started. 👑
--call-as-emperor2 — calls the specified function(char *, pid_t) in the emperor after the vassal has been started. 👑
--call-as-emperor4 — calls the specified function(char *, pid_t, uid_t, gid_t) in the emperor after the vassal has been started. 👑
--ini — loads config from an ini file. 📝
-y, --yaml — loads config from a yaml file. 📝
-y, --yml — loads config from a yaml file. 📝
-j, --json — loads config from a json file. 📝
-j, --js — loads config from a json file. 📝
--weight — weight of the instance (used by clustering/lb/subscriptions). ⚖️
--auto-weight — sets weight of the instance (used by clustering/lb/subscriptions) automatically. ⚖️✨
--no-server — forces no-server mode. 🚫
--command-mode — forces command mode. 💻
--no-defer-accept — disables deferred-accept on sockets. 🚫
--tcp-nodelay — enables TCP NODELAY on each request. 🚀
--so-keepalive — enables TCP KEEPALIVEs. 💓
--so-send-timeout — sets SO_SNDTIMEO. ⏱️
--socket-send-timeout — sets SO_SNDTIMEO. ⏱️
--so-write-timeout — sets SO_SNDTIMEO. ⏱️
--socket-write-timeout — sets SO_SNDTIMEO. ⏱️
--socket-sndbuf — sets SO_SNDBUF. 📤
--socket-rcvbuf — sets SO_RCVBUF. 📥
--shutdown-sockets — forces calling shutdown() in addition to close() when sockets are destroyed. 🔌
--limit-as — limits processes address space/vsz. 📉
--limit-nproc — limits the number of spawnable processes. 🚦
--reload-on-as — reloads if address space is higher than specified megabytes. 🔄
--reload-on-rss — reloads if rss memory is higher than specified megabytes. 🔄
--evil-reload-on-as — forces the master to reload a worker if its address space is higher than specified megabytes. 😈
--evil-reload-on-rss — forces the master to reload a worker if its rss memory is higher than specified megabytes. 😈
--mem-collector-freq — sets the memory collector frequency when evil reloads are in place. 🧹
--reload-on-fd — reloads if the specified file descriptor is ready. 🔄
--brutal-reload-on-fd — brutal reload if the specified file descriptor is ready. 💀
--ksm — enables Linux KSM. 🐧
--pcre-jit — enables pcre jit (if available). ⚡
--never-swap — locks all memory pages avoiding swapping. 🔒
--touch-reload — reloads uWSGI if the specified file is modified/touched. 👆
--touch-workers-reload — triggers reload of (only) workers if the specified file is modified/touched. 👆
--touch-mules-reload — reloads mules if the specified file is modified/touched. 👆
--touch-spoolers-reload — reloads spoolers if the specified file is modified/touched. 👆
--touch-chain-reload — triggers chain reload if the specified file is modified/touched. 👆
--touch-logrotate — triggers logrotation if the specified file is modified/touched. 👆
--touch-logreopen — triggers log reopen if the specified file is modified/touched. 👆
--touch-exec — runs command when the specified file is modified/touched. Syntax: file command. 👆
--touch-signal — the moment the file you named gets modified/touched, a signal goes off. syntax is <pink>file signal</pink>, bestie 🫶
--fs-reload — if that filesystem object you're watching changes, you get a graceful reload. polite. respectful. 💅
--fs-brutal-reload — same idea but the reload is BRUTAL 😤 no gentleness here
--fs-signal — raises a uwsgi signal when the filesystem object you pointed at gets modified. syntax: <purple>file signal</purple> ✨
--check-mountpoint — if a filesystem becomes unreachable, the instance gets destroyed. very much useful for reliable Fuse management 🔥
--mountpoint-check — literally the same thing: instance gets destroyed when a filesystem is no longer reachable, handy for reliable Fuse management
--check-mount — yep, same vibe: kill the instance if a filesystem goes unreachable (reliable Fuse management, you know the drill)
--mount-check — one more alias of the above 💖 destroy the instance when a filesystem is no more reachable (useful for reliable Fuse management)
--propagate-touch — okay so this one is described as an over-engineering option for system with flaky signal management 🙈 the devs said it themselves, not me
--limit-post — caps the request body. that's it, that's the whole job 🎀
--no-orphans — if the master dies, workers get killed automatically. > ⚠️ heads up bestie: this can be dangerous for availability, so know what you're doing before you turn it on 💀
--prio — sets the priority of your processes/threads 🌸
--cpu-affinity — sets cpu affinity. pin those cores, main character energy 👑
--post-buffering — sets the size in bytes at which, instead of staying in memory, stuff gets buffered to disk 📝
--post-buffering-bufsize — sets the buffer size used for read() while you're in post buffering mode
--body-read-warning — sets how much memory allocation (in megabytes) for a request body is allowed before it starts printing a warning at you 😭
--upload-progress — while a file upload is happening, .json files get created in the directory you specify. progress tracking, slay ✨
--no-default-app — no falling back to the default app. periodt.
--manage-script-name — automatically rewrites SCRIPT_NAME and PATH_INFO for you 💅
--ignore-script-name — just ignores SCRIPT_NAME entirely
--catch-exceptions — reports the exception as http output. > 🚩 the original says discouraged, use only for testing — so fr fr, testing only
--reload-on-exception — an exception gets raised, the worker reloads. simple as that 🔄
--reload-on-exception-type — reloads the worker when a specific exception type is raised 🦋
--reload-on-exception-value — reloads the worker when a specific exception value is raised
--reload-on-exception-repr — reloads the worker when a specific exception type+value combo (language-specific) is raised 🌈
--exception-handler — adds an exception handler. stack 'em up 💖
--enable-metrics — turns on the metrics subsystem. numbers time 📊
--metric — adds a custom metric of your very own ✨
--metric-threshold — adds a metric threshold/alarm 🚨
--metric-alarm — also adds a metric threshold/alarm (same thing, different name, iconic)
--alarm-metric — again: adds a metric threshold/alarm 🫶
--metrics-dir — exports your metrics as text files into the directory you name 📁
--metrics-dir-restore — restores the last value taken from the metrics dir
--metric-dir — exports metrics as text files to the specified directory (the singular twin of --metrics-dir)
--metric-dir-restore — restores the last value taken from the metrics dir (same deal, singular name)
--metrics-no-cores — disables generation of all those cores-related metrics 💀
--udp — runs the udp server on the address you give it 🌐
--stats — enables the stats server on the specified address 📈
--stats-server — enables the stats server on the specified address (yes, the same one, she has two names)
--stats-http — prefixes the stats server json output with http headers
--stats-minified — minifies the statistics json output 🗜️
--stats-min — minifies the statistics json output (short king)
--stats-push — pushes the stats json off to the destination you specify 📤
--stats-pusher-default-freq — sets the default frequency of stats pushers ⏱️
--stats-pushers-default-freq — sets the default frequency of stats pushers (plural version, same energy)
--stats-no-cores — disables generation of cores-related stats
--stats-no-metrics — metrics do not get included in the stats output 🙅‍♀️
--multicast — subscribes you to the multicast group you specify 📡
--multicast-ttl — sets multicast ttl
--multicast-loop — sets multicast loop. default is 1 💫
--master-fifo — enables the master fifo 🎀
--notify-socket — enables the notification socket 🔔
--subscription-notify-socket — sets the notification socket used for subscriptions
--legion — you become a member of a legion. very ✨legion✨ of you
--legion-mcast — becomes a member of a legion, shortcut style (it's a shortcut for multicast)
--legion-node — adds a node to a legion 🫂
--legion-freq — sets the frequency of legion packets
--legion-tolerance — sets the tolerance of the legion subsystem
--legion-death-on-lord-error — if one of the lord hooks fails, the node declares itself dead for however many seconds you specify 💀
--legion-skew-tolerance — sets the clock skew tolerance of the legion subsystem. default is 60 seconds ⏰
--legion-lord — the action to call on Lord election 👑
--legion-unlord — the action to call on Lord dismiss
--legion-setup — the action to call on legion setup
--legion-death — the action to call on legion death (that's the shutdown of the instance) ⚰️
--legion-join — the action to call on legion join, which is the first time quorum is reached 🎉
--legion-node-joined — the action to call when a new node joins the legion
--legion-node-left — the action to call when a node leaves the legion 👋
--legion-quorum — sets the quorum of a legion
--legion-scroll — sets the scroll of a legion 📜
--legion-scroll-max-size — sets the max size of the legion scroll buffer
--legion-scroll-list-max-size — sets the max size of the legion scroll list buffer
--subscriptions-sign-check — sets the digest algorithm and certificate directory for the secured subscription system 🔐
--subscriptions-sign-check-tolerance — sets the maximum tolerance (in seconds) of clock skew for the secured subscription system
--subscriptions-sign-skip-uid — skips the signature check for the uid you specify when unix sockets credentials are in play
--subscriptions-credentials-check — adds a directory to search for subscriptions key credentials 🗂️
--subscriptions-use-credentials — enables management of SCM_CREDENTIALS in subscriptions UNIX sockets
--subscription-algo — sets the load balancing algorithm for the subscription system ⚖️
--subscription-dotsplit — tries to fall back to the next part (dot based) in the subscription key
--subscribe-to — subscribes to the subscription server you specify 📬
--st — subscribes to the specified subscription server (yes, --st, she's tiny but she works)
--subscribe — subscribes to the specified subscription server
--subscribe2 — subscribes to the specified subscription server but using the advanced keyval syntax ✨ fancy
--subscribe-freq — sends the subscription announce at the interval you set
--subscription-tolerance — sets tolerance for subscription servers
--unsubscribe-on-graceful-reload — forces the unsubscribe request even during a graceful reload 💅
--start-unsubscribed — configures subscriptions but doesn't send them. useful with master fifo 🎀
--subscribe-with-modifier1 — forces the specified modifier1 when subscribing
--snmp — enables the embedded snmp server 🌲
--snmp-community — sets the snmp community string
--ssl-verbose — be verbose about SSL errors 📣
--ssl-verify-depth — sets the maximum certificate verification depth
--sni — adds an SNI-governed SSL context 🔒
--sni-dir — checks for cert/key/client_ca files in the directory you specify, and creates a sni/ssl context on demand 🪄
--sni-dir-ciphers — sets the ssl ciphers for the sni-dir option
--ssl-enable3 — enables SSLv3. > 🚨 it's marked insecure, so pls be careful
--ssl-enable-sslv3 — enables SSLv3 (also marked insecure — same warning, same red flag)
--ssl-enable-tlsv1 — enables TLSv1. > 🚨 yep, this one is insecure too
--ssl-option — sets a raw ssl option. numeric value only 🔢
--sni-regexp — adds an SNI-governed SSL context, except the key is a regexp 🧠
--ssl-tmp-dir — stores all the ssl-related temp files in the directory you name
--check-interval — sets the interval (in seconds) of master checks ⏳
--forkbomb-delay — when a forkbomb is detected, sleep for however many seconds you specify 😴
--binary-path — forces the binary path
--privileged-binary-patch — patches the uwsgi binary with a new command, and this happens before privileges drop 🩹
--unprivileged-binary-patch — patches the uwsgi binary with a new command, happening after privileges drop
--privileged-binary-patch-arg — patches the uwsgi binary with a new command and arguments, before privileges drop 🧰
--unprivileged-binary-patch-arg — patches the uwsgi binary with a new command and arguments, after privileges drop
--async — enables async mode with however many cores you specify ⚡
--max-fd — sets the maximum number of file descriptors. > 🔑 requires root privileges, no cap
--logto — sets the logfile/udp address 🪵
--logto2 — logs to the file or udp address you specify, but after privileges drop
--log-format — sets an advanced format for request logging 🎨
--logformat — sets an advanced format for request logging (the no-dash twin)
--logformat-strftime — applies strftime to logformat output 🕰️
--log-format-strftime — applies strftime to logformat output (dashed edition)
--logfile-chown — chowns logfiles
--logfile-chmod — chmods logfiles
--log-syslog — logs to syslog 📮
--log-socket — sends logs to the socket you specify 🔌
--req-logger — sets/appends a request logger
--logger-req — sets/appends a request logger (same thing, reversed name, iconic)
--logger — sets/appends a logger 🪵
--logger-list — lists enabled loggers 📋
--loggers-list — lists enabled loggers (plural, same list)
--threaded-logger — offloads log writing to a thread 🧵
--log-encoder — adds an item into the log encoder chain ⛓️
--log-req-encoder — adds an item into the log req encoder chain
--log-drain — drains (aka does not show) log lines matching the regexp you give 🤫
--log-filter — shows only log lines matching the regexp you give 🔍
--log-route — if the regexp applied on a logline matches, log to the named logger you specified 🚏
--log-req-route — logs requests to the named logger you specified, if the regexp applied on the logline matches
--use-abort — calls abort() on segfault/fpe. could be useful for generating a core dump 💥
--alarm — creates a new alarm. syntax: <purple><alarm> <plugin:args></purple> 🚨

--alarm-cheap — don't make a whole new thread for every curl-based alarm, bestie</p> — just use the main alarm thread instead. lowkey efficient 💅
--alarm-freq — tune up the anti-loop alarm system. default is 3 seconds. fr fr, that's the number.
--alarm-fd — raise the alarm you specify when an fd is read for read. by default it reads 1 byte; set it to 8 for eventfd. 🦋
--alarm-segfault — raise the alarm you specify when the segmentation fault handler runs. segfault o'clock 😭
--segfault-alarm — same vibe, same job: raise the alarm you specify when the segmentation fault handler is executed.
--alarm-backlog — raise the alarm you specify when the socket backlog queue is full. she's full, she's done, sound the alarm
--backlog-alarm — yep, the twin: raise the alarm you specify when the socket backlog queue is full.
--lq-alarm — raise the alarm you specify when the socket backlog queue is full. (lq = listen queue, iykyk)
--alarm-lq — raise the alarm you specify when the socket backlog queue is full. same energy, different word order ✨
--alarm-listen-queue — raise the alarm you specify when the socket backlog queue is full. the full-name version, we love a thorough queen
--listen-queue-alarm — raise the alarm you specify when the socket backlog queue is full. her reversed sister 🎀
--log-alarm — raise the alarm you specify whenever a log line matches the regexp you gave. syntax: <alarm>[,alarm...] <regexp>. regex girlies rise 🙈
--alarm-log — raise the alarm you specify whenever a log line matches the regexp you gave. syntax: <alarm>[,alarm...] <regexp>.
--not-log-alarm — skip the alarm you specify when a log line matches the regexp you gave. syntax: <alarm>[,alarm...] <regexp>. not her, not today 💅
--not-alarm-log — skip the alarm you specify when a log line matches the regexp you gave. syntax: <alarm>[,alarm...] <regexp>.
--alarm-list — list the enabled alarms. show me the receipts 📋
--alarms-list — list the enabled alarms. plural but same, periodt ✨
--alarm-msg-size — set the max size of an alarm message. default 8192.

--log-master — delegate logging to the master process. let the main character handle it 👑
--log-master-bufsize — set the buffer size for the master logger. bigger log messages will be truncated — no cap, they just get cut off 💀
--log-master-stream — create the master logpipe as SOCK_STREAM. streamy ✨
--log-master-req-stream — create the master requests logpipe as SOCK_STREAM.
--log-reopen — reopen the log after a reload. fresh start energy 🦋
--log-truncate — truncate the log on startup. empty it, clean slate, we move 🌸
--log-maxsize — set the maximum logfile size. she has a limit and honestly? boundaries 💅
--log-backupname — set the logfile name used after rotation. the glow-up name 🎀
--logdate — prefix your logs with a date or a strftime string. timestamp her 💖
--log-date — prefix your logs with a date or a strftime string. same thing, dash edition ✨
--log-prefix — prefix your logs with a string of your choosing. brand it, bestie 🎀
--log-zero — log responses that have no body. silence still counts 🫶
--log-slow — log requests slower than the number of milliseconds you specify. slow girls get noticed too 😭
--log-4xx — log requests with a 4xx response. client said no 💀
--log-5xx — log requests with a 5xx response. server said no 😭
--log-big — log requests bigger than the size you specify. thicc requests only 💅
--log-sendfile — log sendfile requests. sendfile girls, this one's for you 🦋
--log-ioerror — log requests that hit io errors. io oopsie, logged 📝
--log-micros — report response time in microseconds instead of milliseconds. precision queen ⭐
--log-x-forwarded-for — use the ip from the X-Forwarded-For header instead of REMOTE_ADDR. behind a proxy? this is your girl 🌈

--master-as-root — leave the master process running as root. yes, that root. be so careful, bestie 🚨
--drop-after-init — run the privileges drop after plugin initialization. superseded by drop-after-apps — so like, newer option took her spot 💅
--drop-after-apps — run the privileges drop after apps loading. superseded by master-as-root. noted, no cap.
--force-cwd — force the initial working directory to the value you specify. she goes where she's told 🎀
--binsh — override /bin/sh. it's used by exec hooks, and it always fallback to /bin/sh. the fallback is forever iykyk 🙈
--chdir — chdir to the directory you specify before apps loading. move in first, unpack later 🧳
--chdir2 — chdir to the directory you specify after apps loading. unpack first, move in after 🧳
--lazy — set lazy mode, aka load apps in workers instead of master. let the workers do it 💅
--lazy-apps — load apps in each worker instead of the master. every worker gets her own copy, iconic 🎀
--cheap — set cheap mode: spawn workers only after the first request. no requests, no workers, no stress 🦋
--cheaper — set cheaper mode, aka adaptive process spawning. she adapts, she slays 🌈
--cheaper-initial — set the initial number of processes to spawn in cheaper mode. the starter pack ⭐
--cheaper-algo — choose the algorithm used for adaptive process spawning. pick your fighter 💜
--cheaper-step — the number of additional processes to spawn at each overload. more workers, more often, periodt 💅
--cheaper-overload — increase workers after the overload you specify. overloaded? grow, girl 🌸
--cheaper-algo-list — list the enabled cheapers algorithms. 📋
--cheaper-algos-list — list the enabled cheapers algorithms. 📋✨
--cheaper-list — list the enabled cheapers algorithms. 📋🎀
--cheaper-rss-limit-soft — don't spawn new workers if the total resident memory usage of all workers is higher than this limit. chill mode activated 🫶
--cheaper-rss-limit-hard — if total workers resident memory usage is higher than this, try to stop workers. hard mode, she's actually shutting things down 😭
--idle — set idle mode, aka put uWSGI in cheap mode after inactivity. nothing happening? back to sleep 💤
--die-on-idle — shut down uWSGI when it's idle. not idle mode — actually GONE mode 💀
--mount — load an application under a mountpoint. put her where she belongs ✨
--worker-mount — load an application under a mountpoint in the worker you specify, or after workers spawn. worker-specific realness 💅
--threads — run each worker in prethreaded mode with the number of threads you specify. threads girlies, assemble 🧵
--thread-stacksize — set the threads stacksize. give her room to breathe 🦋
--threads-stacksize — set the threads stacksize. same, plural 🎀
--thread-stack-size — set the threads stacksize. same, hyphenated ✨
--threads-stack-size — set the threads stacksize. same, plural AND hyphenated 💖
--vhost — enable virtualhosting mode, based on the SERVER_NAME variable. many hosts, one server, main character energy 👑
--vhost-host — enable virtualhosting mode, based on the HTTP_HOST variable. same but HTTP_HOST 🎀

--route — add a route. 🛣️
--route-host — add a route based on the Host header. 🛣️
--route-uri — add a route based on REQUEST_URI. 🛣️
--route-qs — add a route based on QUERY_STRING. 🛣️
--route-remote-addr — add a route based on REMOTE_ADDR. 🛣️
--route-user-agent — add a route based on HTTP_USER_AGENT. 🛣️
--route-remote-user — add a route based on REMOTE_USER. 🛣️
--route-referer — add a route based on HTTP_REFERER. 🛣️
--route-label — add a routing label, for use with goto. jump girlies know 🎀
--route-if — add a route based on a condition. if this, then route ✨
--route-if-not — add a route based on a condition, but the negate version. if NOT this, then route 💅
--route-run — always run the route action you specify. no conditions, she just goes 🔥
--final-route — add a final route. 🛣️🏁
--final-route-status — add a final route for the status you specify. 🏁
--final-route-host — add a final route based on the Host header. 🏁
--final-route-uri — add a final route based on REQUEST_URI. 🏁
--final-route-qs — add a final route based on QUERY_STRING. 🏁
--final-route-remote-addr — add a final route based on REMOTE_ADDR. 🏁
--final-route-user-agent — add a final route based on HTTP_USER_AGENT. 🏁
--final-route-remote-user — add a final route based on REMOTE_USER. 🏁
--final-route-referer — add a final route based on HTTP_REFERER. 🏁
--final-route-label — add a final routing label, for use with goto. 🏁🎀
--final-route-if — add a final route based on a condition. 🏁✨
--final-route-if-not — add a final route based on a condition, negate version. 🏁💅
--final-route-run — always run the final route action you specify. 🏁🔥
--error-route — add an error route. 🛣️💀
--error-route-status — add an error route for the status you specify. 💀
--error-route-host — add an error route based on the Host header. 💀
--error-route-uri — add an error route based on REQUEST_URI. 💀
--error-route-qs — add an error route based on QUERY_STRING. 💀
--error-route-remote-addr — add an error route based on REMOTE_ADDR. 💀
--error-route-user-agent — add an error route based on HTTP_USER_AGENT. 💀
--error-route-remote-user — add an error route based on REMOTE_USER. 💀
--error-route-referer — add an error route based on HTTP_REFERER. 💀
--error-route-label — add an error routing label, for use with goto. 💀🎀
--error-route-if — add an error route based on a condition. 💀✨
--error-route-if-not — add an error route based on a condition, negate version. 💀💅
--error-route-run — always run the error route action you specify. 💀🔥
--response-route — add a response route. 🛣️🌸
--response-route-status — add a response route for the status you specify. 🌸
--response-route-host — add a response route based on the Host header. 🌸
--response-route-uri — add a response route based on REQUEST_URI. 🌸
--response-route-qs — add a response route based on QUERY_STRING. 🌸
--response-route-remote-addr — add a response route based on REMOTE_ADDR. 🌸
--response-route-user-agent — add a response route based on HTTP_USER_AGENT. 🌸
--response-route-remote-user — add a response route based on REMOTE_USER. 🌸
--response-route-referer — add a response route based on HTTP_REFERER. 🌸
--response-route-label — add a response routing label, for use with goto. 🌸🎀
--response-route-if — add a response route based on a condition. 🌸✨
--response-route-if-not — add a response route based on a condition, negate version. 🌸💅
--response-route-run — always run the response route action you specify. 🌸🔥
--router-list — list the enabled routers. 📋🌈
--routers-list — list the enabled routers. 📋🌈✨
--error-page-403 — add an error page (html) for the managed 403 response. 🚫🎀
--error-page-404 — add an error page (html) for the managed 404 response. 👻🎀
--error-page-500 — add an error page (html) for the managed 500 response. 💥🎀

--websockets-ping-freq — set the frequency, in seconds, of the websockets automatic ping packets. ping ping ping 🏓
--websocket-ping-freq — set the frequency, in seconds, of the websockets automatic ping packets. 🏓✨
--websockets-pong-tolerance — set the tolerance, in seconds, of the websockets ping/pong subsystem. give her a lil grace period 🫶
--websocket-pong-tolerance — set the tolerance, in seconds, of the websockets ping/pong subsystem. 🫶✨
--websockets-max-size — set the max allowed size of websocket messages, in Kbytes. default 1024.
--websocket-max-size — set the max allowed size of websocket messages, in Kbytes. default 1024. same, singular 🎀
--chunked-input-limit — set the max size of a chunked input part. default 1MB, in bytes. chunky but make it bounded 💅
--chunked-input-timeout — set the default timeout for chunked input. clock's ticking bestie ⏰

--clock — set a clock source. ⏰✨
--clock-list — list the enabled clocks. 📋⏰
--clocks-list — lists every clock that's actually enabled, so you can see what timers you're working with 🕰️
--add-header — auto-adds HTTP headers to the response for you, no manual labour 💅
--rem-header — auto-removes the HTTP header you name from the response ✂️
--del-header — same energy: auto-removes the HTTP header you name from the response
--collect-header — stashes that response header in a request var (syntax: header var) 📥
--response-header-collect — yeah literally the same thing: stash the response header in a request var (syntax: header var)
--pull-header — stashes the response header in a request var and yanks it out of the response (syntax: header var) 🫳

--check-static — checks for static files in the directory you give it 📂
--check-static-docroot — checks for static files in the requested DOCUMENT_ROOT
--static-check — checks for static files in the specified directory (twin of the one above, iykyk)
--static-map — maps a mountpoint onto a static directory (or a file) 🗺️
--static-map2 — like --static-map except it completely appends the requested resource to the docroot
--static-skip-ext — skips the extension you name during staticfile checks
--static-index — hunts for the file you name when a directory is requested
--static-safe — skips security checks if the file lives under the path you specify 🔐
--static-cache-paths — drops resolved paths into the uWSGI cache for however many seconds you say
--static-cache-paths-name — uses the cache you name for static paths
--mimefile — sets the mime types file path (default /etc/mime.types) 📄
--mime-file — sets the mime types file path (default /etc/mime.types) — yes bestie, same option, two names

--static-expires-type — sets the Expires header based on content type ⏳
--static-expires-type-mtime — sets the Expires header based on content type and file mtime
--static-expires — sets the Expires header based on a filename regexp
--static-expires-mtime — sets the Expires header based on a filename regexp and file mtime
--static-expires-uri — sets the Expires header based on a REQUEST_URI regexp
--static-expires-uri-mtime — sets the Expires header based on a REQUEST_URI regexp and file mtime
--static-expires-path-info — sets the Expires header based on a PATH_INFO regexp
--static-expires-path-info-mtime — sets the Expires header based on a PATH_INFO regexp and file mtime

--static-gzip — if the regexp you supply matches the static file translation, it goes looking for a gzip version 🗜️
--static-gzip-all — checks for a gzip version of all requested static files
--static-gzip-dir — checks for a gzip version of all requested static files in the dir/prefix you specify
--static-gzip-prefix — checks for a gzip version of all requested static files in the dir/prefix you specify
--static-gzip-ext — checks for a gzip version of all requested static files with the ext/suffix you specify
--static-gzip-suffix — checks for a gzip version of all requested static files with the ext/suffix you specify
--honour-range — turns on support for the HTTP Range header 📏
--offload-threads — sets how many offload threads to spawn (per-worker, default 0)
--offload-thread — sets how many offload threads to spawn (per-worker, default 0) — same vibe, singular spelling
--file-serve-mode — sets the static file serving mode
--fileserve-mode — sets the static file serving mode (the no-dash twin, she's here too)
--disable-sendfile — disables sendfile() and just relies on boring old read()/write() 😴
--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 — unsets an environment variable 🚫
--vacuum — tries to remove all of the generated file/sockets 🧹
--file-write — writes the content you give to the file you give (syntax: file=value) before privileges drop
--cgroup — puts the processes into the cgroup you name
--cgroup-opt — sets a value in the cgroup option you name
--cgroup-dir-mode — sets permission for the cgroup directory (default is 700)
--namespace — runs in a new namespace under the rootfs you specify
--namespace-keep-mount — keeps the mountpoint you specify in your namespace
--ns — runs in a new namespace under the rootfs you specify
--namespace-net — adds a network namespace 🌐
--ns-net — adds a network namespace

--enable-proxy-protocol — enables PROXY1 protocol support (only for http parsers)
--reuse-port — enables the REUSE_PORT flag on the socket (BSD only, so don't come crying to Linux)
--tcp-fast-open — enables the TCP_FASTOPEN flag on TCP sockets with the qlen value you give 🚀
--tcp-fastopen — enables the TCP_FASTOPEN flag on TCP sockets with the qlen value you give
--tcp-fast-open-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported
--tcp-fastopen-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported

--zerg — attaches to a zerg server 👾
--zerg-fallback — falls back to normal sockets if the zerg server isn't available
--zerg-server — enables the zerg server on the UNIX socket you specify
--cron — adds a cron task ⏰
--cron2 — adds a cron task (key=val syntax)
--unique-cron — adds a unique cron task
--cron-harakiri — sets the maximum time (in seconds) we wait for a cron command to complete 🔪
--legion-cron — adds a cron task that only runs when the instance is a lord of the legion you specify 👑
--cron-legion — adds a cron task that only runs when the instance is a lord of the legion you specify
--unique-legion-cron — adds a unique cron task that only runs when the instance is a lord of the legion you specify
--unique-cron-legion — adds a unique cron task that only runs when the instance is a lord of the legion you specify

--loop — selects the uWSGI loop engine 🔁
--loop-list — lists enabled loop engines
--loops-list — lists enabled loop engines
--worker-exec — runs the command you give as worker
--worker-exec2 — runs the command you give as worker (after the post_fork hook)
--attach-daemon — attaches a command/daemon to the master process (the command has to not go in background) 🧷
--attach-control-daemon — attaches a command/daemon to the master process (the command has to not go in background); when the daemon dies, the master dies too 💀
--smart-attach-daemon — attaches a command/daemon to the master process managed by a pidfile (the command has to daemonize)
--smart-attach-daemon2 — attaches a command/daemon to the master process managed by a pidfile (the command has to NOT daemonize)
--legion-attach-daemon — same as --attach-daemon but the daemon 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 — does not change the stdin of external daemons to /dev/null
--attach-daemon2 — the attach-daemon keyval variant (supports smart modes too)

--plugins — loads uWSGI plugins 🧩
--plugin — loads uWSGI plugins
--need-plugins — loads uWSGI plugins (exits on error)
--need-plugin — loads uWSGI plugins (exits on error)
--plugins-dir — adds a directory to the uWSGI plugin search path
--plugin-dir — adds a directory to the uWSGI plugin search path
--plugins-list — lists enabled plugins
--plugin-list — lists enabled plugins
--autoload — tries to automatically load plugins when unknown options are found ✨
--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 available options 📜
--show-config — shows the current config reformatted as ini
--binary-append-data — returns the content of a resource to stdout for appending to a uwsgi binary (for data:// usage)
--print — simple print 🖨️
--iprint — simple print (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 response header maximum size (default: 64k)

and that's a wrap on the whole options list, bestie 🎀✨ you made it to the end of a genuinely enormous manpage and I'm so proud of you fr fr 🫶

Quick reminder: every one of those flags above is doing real work in a real binary, so copy them character for character and don't freestyle the spelling. 💅

okay go forth and slay your config, main character energy only 💖

This page ships as uwsgi_jvm version 2.0.31-3, dated March 2026, and it's the manual page for UWSGI_JVM(1) — see you in the next one, mwah 💋🌸

📦 where this page comes from

ubuntu resolute: uwsgi-plugin-java 2.0.31+3+0.0.7 · GPL-3.0-or-later
ubuntu stonking: uwsgi-plugin-java 2.0.31+3+0.0.7 · GPL-3.0-or-later
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-18: a language model's rewrite of the original, under its terms