UWSGI_RADOS(1)

🌸 NAME 🌸

bestie. sit down. hydrate. because we're about to talk about uwsgi_rados — aka the fast (pure C), self-healing, developer-friendly WSGI server. yes. all of that. in one sentence. she's an icon, she's a legend, and she is the moment.

this is the manual page for UWSGI_RADOS(1), filed under User Commands, and it is long, so we're doing it in parts. no skipping. i will know. 🫶

---

✨ SYNOPSIS ✨

like. the whole vibe in one line:

uwsgi-core [options...]

that's it. that's the girl. everything else is just options on top of options. slay. 💅

---

👑 DESCRIPTION 👑

okay so this is the part where we go through literally every single option, one at a time, and i tell you what each one does. no cap, no summarising, no "and then there were more options, you get it". we're doing all of them. grab a snack. 🍓

🔌 the socket era 🔌

• -s, --socket — bind to the specified UNIX/TCP socket using the default protocol. the classic. the starter pack.
• -s, --uwsgi-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol. same flag letter, different protocol, we love a multitasker.
• --suwsgi-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol over SSL. secure little thing.
• --ssl-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol over SSL. yes bestie, she also exists, and she's separate, and i'm not merging them.
• --http-socket — bind to the specified UNIX/TCP socket using the HTTP protocol. your browser's new bestie.
• --http-socket-modifier1 — force the specified modifier1 when using the HTTP protocol. you don't get to choose naturally, so here's your override. 💅
• --http-socket-modifier2 — force the specified modifier2 when using the HTTP protocol. same energy, different digit.
• --http11-socket — bind to the specified UNIX/TCP socket using HTTP 1.1 (Keep-Alive) protocol. she stays connected. obsessed.
• --https-socket — bind to the specified UNIX/TCP socket using HTTPS protocol. http but with a glow-up and a certificate.
• --https-socket-modifier1 — force the specified modifier1 when using the HTTPS protocol.
• --https-socket-modifier2 — force the specified modifier2 when using the HTTPS protocol.
• --fastcgi-socket — bind to the specified UNIX/TCP socket using FastCGI protocol.
• --fastcgi-nph-socket — bind to the specified UNIX/TCP socket using FastCGI protocol (nph mode). nph. periodt.
• --fastcgi-modifier1 — force the specified modifier1 when using FastCGI protocol.
• --fastcgi-modifier2 — force the specified modifier2 when using FastCGI protocol.
• --scgi-socket — bind to the specified UNIX/TCP socket using SCGI protocol.
• --scgi-nph-socket — bind to the specified UNIX/TCP socket using SCGI protocol (nph mode).
• --scgi-modifier1 — force the specified modifier1 when using SCGI protocol.
• --scgi-modifier2 — force the specified modifier2 when using SCGI protocol.
• --raw-socket — bind to the specified UNIX/TCP socket using RAW protocol. no manners, no framing, just vibes.
• --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). she never leaves the group chat.
• --protocol — force the specified protocol for default sockets.
• --socket-protocol — force the specified protocol for default sockets. (yes, same description. no, i'm not skipping one. they're both here. 💀)
• --shared-socket — create a shared socket for advanced jailing or ipc. fancy girl behaviour.
• --undeferred-shared-socket — create a shared socket for advanced jailing or ipc (undeferred mode).

---

🧑🍳 workers, harakiri & the whole crew 🧑🍳

• -p, --processes — spawn the specified number of workers/processes. more workers = more hands = more slay.
• -p, --workers — spawn the specified number of workers/processes. same flag, same job, different name. they're twins, not duplicates. 🫶
• --thunder-lock — serialize accept() usage (if possible). the "if possible" is doing a lot of heavy lifting there bestie, don't @ me.
• -t, --harakiri — set harakiri timeout. yes it's named after ritual suicide. yes it means your worker gets merked if it's too slow. moving on. 😭
• --harakiri-verbose — enable verbose mode for harakiri. so you get the full play-by-play of the murder.
• --harakiri-graceful-timeout — interval between graceful harakiri attempt and a sigkill. so: ask nicely, then don't.
• --harakiri-graceful-signal — use this signal instead of sigterm for graceful harakiri attempts. customise your goodbye. 🎀
• --harakiri-queue-threshold — only trigger harakiri if queue is greater than this threshold. she's polite about it.
• --harakiri-no-arh — do not enable harakiri during after-request-hook.
• --no-harakiri-arh — do not enable harakiri during after-request-hook. (same thing, different order of words. we love a trio.)
• --no-harakiri-after-req-hook — do not enable harakiri during after-request-hook. three of them. three. i'm just the messenger. 💀
• --backtrace-depth — set backtrace depth. how far back in the drama do we go.
• --mule-harakiri — set harakiri timeout for mule tasks. even the mules get timed out.

---

📜 config & placeholder nation 📜

• -x, --xmlconfig — load config from xml file.
• -x, --xml — load config from xml file. twin behaviour again, we stan.
• --config — load configuration using the pluggable system. plug it in, plug it in. 🔌
• --fallback-config — re-exec uwsgi with the specified config when exit code is 1. the backup plan. the situationship safety net.
• --strict — enable strict mode (placeholder cannot be used). no placeholders. none. she's on her no-nonsense era.
• --skip-zero — skip check of file descriptor 0.
• --skip-atexit — skip atexit hooks (ignored by the master).
• --skip-atexit-teardown — skip atexit teardown (ignored by the master).
• -S, --set — set a placeholder or an option. versatile queen.
• --set-placeholder — set a placeholder.
• --set-ph — set a placeholder. short queen.
• --get — print the specified option value and exit.
• --declare-option — declare a new uWSGI custom option.
• --declare-option2 — declare a new uWSGI custom option (non-immediate).
• --resolve — place the result of a dns query in the specified placeholder, sytax: placeholder=name (immediate option). and yes, sytax is spelled like that in the original and i am not fixing it, she's canon now. 😭

---

🔁 the opt logic cinematic universe 🔁

this whole section is basically if/for but for your config file. lowkey iconic.

• --for — (opt logic) for cycle.
• --for-glob — (opt logic) for cycle (expand glob).
• --for-times — (opt logic) for cycle (expand the specified num to a list starting from 1).
• --for-readline — (opt logic) for cycle (expand the specified file to a list of lines).
• --endfor — (opt logic) end for cycle.
• --end-for — (opt logic) end for cycle.
• --if-opt — (opt logic) check for option.
• --if-not-opt — (opt logic) check for option.
• --if-env — (opt logic) check for environment variable.
• --if-not-env — (opt logic) check for environment variable.
• --ifenv — (opt logic) check for environment variable.
• --if-reload — (opt logic) check for reload.
• --if-not-reload — (opt logic) check for reload.
• --if-hostname — (opt logic) check for hostname.
• --if-not-hostname — (opt logic) check for hostname.
• --if-hostname-match — (opt logic) try to match hostname against a regular expression.
• --if-not-hostname-match — (opt logic) try to match hostname against a regular expression.
• --if-exists — (opt logic) check for file/directory existence.
• --if-not-exists — (opt logic) check for file/directory existence.
• --ifexists — (opt logic) check for file/directory existence.
• --if-plugin — (opt logic) check for plugin.
• --if-not-plugin — (opt logic) check for plugin.
• --ifplugin — (opt logic) check for plugin.
• --if-file — (opt logic) check for file existence.
• --if-not-file — (opt logic) check for file existence.
• --if-dir — (opt logic) check for directory existence.
• --if-not-dir — (opt logic) check for directory existence.
• --ifdir — (opt logic) check for directory existence.
• --if-directory — (opt logic) check for directory existence.
• --endif — (opt logic) end if.
• --end-if — (opt logic) end if.
• --blacklist — set options blacklist context.
• --end-blacklist — clear options blacklist context.
• --whitelist — set options whitelist context.
• --end-whitelist — clear options whitelist context.

---

😤 write errors & the SIGPIPE agenda 😤

• --ignore-sigpipe — do not report (annoying) SIGPIPE. she said enough.
• --ignore-write-errors — do not report (annoying) write()/writev() errors. same energy.
• --write-errors-tolerance — set the maximum number of allowed write errors (default: no tolerance). default is zero patience. periodt.
• --write-errors-exception-only — only raise an exception on write errors giving control to the app itself.
• --disable-write-exception — disable exception generation on write()/writev().

---

🧩 templates, includes & daemon drama 🧩

• --inherit — use the specified file as config template.
• --include — include the specified file as immediate configuration.
• --inject-before — inject a text file before the config file (advanced templating).
• --inject-after — inject a text file after the config file (advanced templating).
• -d, --daemonize — daemonize uWSGI. bye bestie, you live in the background now. 👋
• --daemonize2 — daemonize uWSGI after app loading. slightly more considerate about it.
• --stop — stop an instance.
• --reload — reload an instance.
• --pause — pause an instance.
• --suspend — suspend an instance.
• --resume — resume an instance.
• --connect-and-read — connect to a socket and wait for data from it.
• --extract — fetch/dump any supported address to stdout.

---

⚙️ tuning, buffers & the little knobs ⚙️

• -l, --listen — set the socket listen queue size.
• -v, --max-vars — set the amount of internal iovec/vars structures.
• --max-apps — set the maximum number of per-worker applications.
• -b, --buffer-size — set internal buffer size.
• -m, --memory-report — enable memory report.
• --profiler — enable the specified profiler.
• -c, --cgi-mode — force CGI-mode for plugins supporting it.
• -a, --abstract-socket — force UNIX socket in abstract mode (Linux only).
• -C, --chmod-socket — chmod-socket.
• -C, --chmod — chmod-socket. same flag letter, same job, two names. iconic.
• --chown-socket — chown unix sockets.
• --umask — set umask.
• --freebind — put socket in freebind mode.
• --map-socket — map sockets to specific workers.
• -T, --enable-threads — enable threads (stub option this is true by default). so she's already on. she was always on. 💅
• --no-threads-wait — do not wait for threads cancellation on quit/reload.
• --auto-procname — automatically set processes name to something meaningful.
• --procname-prefix — add a prefix to the process names.
• --procname-prefix-spaced — add a spaced prefix to the process names.
• --procname-append — append a string to process names.
• --procname — set process names.
• --procname-master — set master process name.
• -i, --single-interpreter — do not use multiple interpreters (where available).
• --need-app — exit if no app can be loaded. she does not do empty-handed. 😤
• -M, --master — enable master process. the main character, literally.
• --honour-stdin — do not remap stdin to /dev/null.

---

👑 the emperor section 👑 (yes she gets her own)

• --emperor — run the Emperor.
• --emperor-proxy-socket — force the vassal to became an Emperor proxy. (and yes, became. original. keeping it. 🫶)
• --emperor-wrapper — set a binary wrapper for vassals.
• --emperor-wrapper-override — set a binary wrapper for vassals to try before the default one.
• --emperor-wrapper-fallback — set a binary wrapper for vassals to try as a last resort.
• --emperor-nofollow — do not follow symlinks when checking for mtime.
• --emperor-procname — set the Emperor process name.
• --emperor-freq — set the Emperor scan frequency (default 3 seconds).
• --emperor-required-heartbeat — set the Emperor tolerance about heartbeats. 💓
• --emperor-curse-tolerance — set the Emperor tolerance about cursed vassals.

---

okay bestie that's part one and there is so much more coming. don't go anywhere. 🦋

• --emperor-pidfile — write the Emperor pid in the file you specify. Emperor pid goes here, bestie 📝
• --emperor-tyrant — put the Emperor in Tyrant mode. Tyrant mode, periodt 👑
• --emperor-tyrant-nofollow — in Tyrant mode, do not follow symlinks when checking for uid/gid. no symlink following, okay? 🔍
• --emperor-stats — run the Emperor stats server. 📊
• --emperor-stats-server — run the Emperor stats server. same stats server, different flag name 💅
• --early-emperor — spawn the emperor as soon as possible. early bird energy 🐦
• --emperor-broodlord — run the emperor in BroodLord mode. BroodLord mode activated 🦋
• --emperor-throttle — set throttling level (in milliseconds) for bad behaving vassals (default 1000). bad vassals get throttled ⏳
• --emperor-max-throttle — set max throttling level (in milliseconds) for bad behaving vassals (default 3 minutes). max throttle, bestie 🛑
• --emperor-magic-exec — prefix vassals config files with exec:// if they have the executable bit. magic exec, iykyk ✨
• --emperor-on-demand-extension — search for a text file (vassal name + extension) containing the on demand socket name. on demand vibes 🔌
• --emperor-on-demand-ext — search for a text file (vassal name + extension) containing the on demand socket name. same thing, shorter name 💅
• --emperor-on-demand-directory — enable on demand mode binding to the unix socket in the specified directory named like the vassal + .socket. unix socket time 🧦
• --emperor-on-demand-dir — enable on demand mode binding to the unix socket in the specified directory named like the vassal + .socket. directory edition 🗂️
• --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). exec says the socket name 📣
• --emperor-extra-extension — allows the specified extension in the Emperor (vassal will be called with --config). extra extension allowed ✅
• --emperor-extra-ext — allows the specified extension in the Emperor (vassal will be called with --config). same but short ✂️
• --emperor-no-blacklist — disable Emperor blacklisting subsystem. no blacklist, no problem 🚫
• --emperor-use-clone — use clone() instead of fork() passing the specified unshare() flags. clone() era 🧬
• --emperor-graceful-shutdown — use vassals graceful shutdown during ragnarok. ragnarok but make it graceful 🌪️
• --emperor-cap — set vassals capability. cap it off 🧢
• --vassals-cap — set vassals capability. same cap energy 🧢
• --vassal-cap — set vassals capability. one vassal, one cap 🧢
• --imperial-monitor-list — list enabled imperial monitors. show me the monitors 📋
• --imperial-monitors-list — list enabled imperial monitors. plural monitors, same list 📋
• --vassals-inherit — add config templates to vassals config (uses --inherit). inherit the config 🧬
• --vassals-include — include config templates to vassals config (uses --include instead of --inherit). include, not inherit 📎
• --vassals-inherit-before — add config templates to vassals config (uses --inherit, parses before the vassal file). inherit before, bestie ⏮️
• --vassals-include-before — include config templates to vassals config (uses --include instead of --inherit, parses before the vassal file). include before ⏮️
• --vassals-start-hook — run the specified command before each vassal starts. start hook, go off 🏁
• --vassals-stop-hook — run the specified command after vassal's death. stop hook after death ⚰️
• --vassal-sos — ask emperor for reinforcement when overloaded. SOS bestie 🆘
• --vassal-sos-backlog — ask emperor for sos if backlog queue has more items than the value specified. backlog SOS threshold 📈
• --vassals-set — automatically set the specified option (via --set) for every vassal. set it for all vassals 🛠️
• --vassal-set — automatically set the specified option (via --set) for every vassal. same set, singular flag 🛠️
• --heartbeat — announce healthiness to the emperor. heartbeat check 💓
• --reload-mercy — set the maximum time (in seconds) we wait for workers and other processes to die during reload/shutdown. mercy time ⏱️
• --worker-reload-mercy — set the maximum time (in seconds) a worker can take to reload/shutdown (default is 60). worker mercy: 60 seconds default 😇
• --mule-reload-mercy — set the maximum time (in seconds) a mule can take to reload/shutdown (default is 60). mule mercy: 60 seconds default 🐴
• --exit-on-reload — force exit even if a reload is requested. exit on reload, no takebacks 🚪
• --die-on-term — exit instead of brutal reload on SIGTERM. die on TERM 💀
• --force-gateway — force the spawn of the first registered gateway without a master. force gateway, no master needed 🚪
• -h|--help — show this help. help is here 🆘
• -h|--usage — show this help. usage is help 🆘
• --print-sym — print content of the specified binary symbol. print the symbol 🔣
• --print-symbol — print content of the specified binary symbol. same symbol, longer name 🔣
• -r|--reaper — call waitpid(-1,...) after each request to get rid of zombies. reap those zombies 🧟
• -R|--max-requests — reload workers after the specified amount of managed requests. max requests, then reload 🔄
• --max-requests-delta — add (worker_id * delta) to the max_requests value of each worker. delta math for max requests ➕
• --min-worker-lifetime — number of seconds worker must run before being reloaded (default is 10). min worker lifetime: 10s ⏳
• --max-worker-lifetime — reload workers after the specified amount of seconds (default is disabled). max worker lifetime, off by default ⏲️
• --max-worker-lifetime-delta — add (worker_id * delta) seconds to the max_worker_lifetime value of each worker. delta for max worker lifetime ➕
• -z|--socket-timeout — set internal sockets timeout. socket timeout vibes ⏰
• --no-fd-passing — disable file descriptor passing. no fd passing 🚫
• --locks — create the specified number of shared locks. locks, locks, locks 🔒
• --lock-engine — set the lock engine. choose your lock engine ⚙️
• --ftok — set the ipcsem key via ftok() for avoiding duplicates. ftok() for unique keys 🔑
• --persistent-ipcsem — do not remove ipcsem's on shutdown. keep ipcsem around 💾
• -A|--sharedarea — create a raw shared memory area of specified pages (note: it supports keyval too). sharedarea, keyval supported too 🧠
• --safe-fd — do not close the specified file descriptor. safe fd, don't close it 🛡️
• --fd-safe — do not close the specified file descriptor. same safe fd energy 🛡️
• --cache — create a shared cache containing given elements. cache time 🗃️
• --cache-blocksize — set cache blocksize. cache blocksize 📦
• --cache-store — enable persistent cache to disk. persistent cache to disk 💽
• --cache-store-sync — set frequency of sync for persistent cache. sync frequency for cache 🔄
• --cache-no-expire — disable auto sweep of expired items. no auto expire sweep 🚫
• --cache-expire-freq — set the frequency of cache sweeper scans (default 3 seconds). cache sweeper scans: 3s default 🧹
• --cache-report-freed-items — constantly report the cache item freed by the sweeper (use only for debug). debug only: report freed items 🐞
• --cache-udp-server — bind the cache udp server (used only for set/update/delete) to the specified socket. cache UDP server socket 📡
• --cache-udp-node — send cache update/deletion to the specified cache udp server. send updates to UDP node 📤
• --cache-sync — copy the whole content of another uWSGI cache server on server startup. sync whole cache on startup 🔄
• --cache-use-last-modified — update last_modified_at timestamp on every cache item modification (default is disabled). last_modified_at updates, off by default 🕒
• --add-cache-item — add an item in the cache. add cache item ➕
• --load-file-in-cache — load a static file in the cache. load file into cache 📄
• --load-file-in-cache-gzip — load a static file in the cache with gzip compression. load file into cache, gzipped 🗜️
• --cache2 — create a new generation shared cache (keyval syntax). cache2, keyval syntax ✨
• --queue — enable shared queue. shared queue on 🚶
• --queue-blocksize — set queue blocksize. queue blocksize 📦
• --queue-store — enable persistent queue to disk. persistent queue to disk 💽
• --queue-store-sync — set frequency of sync for persistent queue. queue sync frequency 🔄
• -Q|--spooler — run a spooler on the specified directory. spooler time 🧵
• --spooler-external — map spoolers requests to a spooler directory managed by an external instance. external spooler directory 🌐
• --spooler-ordered — try to order the execution of spooler tasks. ordered spooler tasks 📋
• --spooler-chdir — chdir() to specified directory before each spooler task. chdir before spooler task 📁
• --spooler-processes — set the number of processes for spoolers. spooler process count 👯
• --spooler-quiet — do not be verbose with spooler tasks. quiet spooler 🤫
• --spooler-max-tasks — set the maximum number of tasks to run before recycling a spooler. max tasks before spooler recycle 🔄
• --spooler-harakiri — set harakiri timeout for spooler tasks. harakiri timeout for spooler 🗡️
• --spooler-frequency — set spooler frequency. spooler frequency 📶
• --spooler-freq — set spooler frequency. same frequency, short name 📶
• --mule — add a mule. add a mule 🐴
• --mules — add the specified number of mules. add many mules 🐴🐴
• --farm — add a mule farm. mule farm time 🚜
• --mule-msg-size — set mule message buffer size. mule message buffer size 📨
• --signal — send a uwsgi signal to a server. send a signal 📶
• --signal-bufsize — set buffer size for signal queue. signal queue buffer size 📦
• --signals-bufsize — set buffer size for signal queue. same signal buffer size 📦
• --signal-timer — add a timer (syntax: <signal> <seconds>). signal timer syntax ⏲️
• --timer — add a timer (syntax: <signal> <seconds>). timer alias ⏲️
• --signal-rbtimer — add a redblack timer (syntax: <signal> <seconds>). redblack timer syntax 🌳
• --rbtimer — add a redblack timer (syntax: <signal> <seconds>). rbtimer alias 🌳
• --rpc-max — maximum number of rpc slots (default: 64). rpc max: 64 default 📞
• -L|--disable-logging — disable request logging. no request logging 🔇
• --flock — lock the specified file before starting, exit if locked. flock and exit if locked 🔒
• --flock-wait — lock the specified file before starting, wait if locked. flock and wait if locked ⏳
• --flock2 — lock the specified file after logging/daemon setup, exit if locked. flock2: after logging/daemon, exit if locked 🔒
• --flock-wait2 — lock the specified file after logging/daemon setup, wait if locked. flock-wait2: after logging/daemon, wait if locked ⏳
• --pidfile — create pidfile (before privileges drop). pidfile before privilege drop 📄
• --pidfile2 — create pidfile (after privileges drop). pidfile after privilege drop 📄
• --safe-pidfile — create safe pidfile (before privileges drop). safe pidfile before drop 🛡️
• --safe-pidfile2 — create safe pidfile (after privileges drop). safe pidfile after drop 🛡️
• --chroot — chroot() to the specified directory. chroot jail 🏰
• --pivot-root — pivot_root() to the specified directories (new_root and put_old must be separated with a space). pivot_root with new_root and put_old separated by space 🔄
• --pivot_root — pivot_root() to the specified directories (new_root and put_old must be separated with a space). same pivot_root, underscore spelling 🔄
• --uid — setuid to the specified user/uid. setuid to user/uid 👤
• --gid — setgid to the specified group/gid. setgid to group/gid 👥
• --add-gid — add the specified group id to the process credentials. add group id to credentials ➕
• --immediate-uid — setuid to the specified user/uid IMMEDIATELY. setuid IMMEDIATELY ⚡
• --immediate-gid — setgid to the specified group/gid IMMEDIATELY. setgid IMMEDIATELY ⚡
• --no-initgroups — disable additional groups set via initgroups(). no initgroups extra groups 🚫
• --cap — set process capability. set process capability 🧢
• --unshare — unshare() part of the processes and put it in a new namespace. unshare into new namespace 🪐
• --unshare2 — unshare() part of the processes and put it in a new namespace after rootfs change. unshare after rootfs change 🪐
• --setns-socket — expose a unix socket returning namespace fds from /proc/self/ns. setns socket exposing namespace fds 🔌
• --setns-socket-skip — skip the specified entry when sending setns file descriptors. skip entry for setns fds ⏭️
• --setns-skip — skip the specified entry when sending setns file descriptors. same skip, shorter name ⏭️
• --setns — join a namespace created by an external uWSGI instance. join external namespace 🚪
• --setns-preopen — open /proc/self/ns as soon as possible and cache fds. preopen /proc/self/ns and cache fds 📂
• --jailed — marks the instance as jailed (which forces the post_jail hooks to actually run). the vibes are incarcerated fr 💅
• --refork — does a fork() again after privileges drop. super useful for jailing systems 🦋
• --re-fork — same thing bestie: 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 — yep, the 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 — and its other spelling: fork() again after jailing. useful for jailing systems.

---

✨ the hook era ✨

ok so hooks are like little callbacks that fire at Very Specific Moments. there's a LOT of them. buckle up bestie 🫶

• --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 (once per-instance).
• --hook-accepting1-once — runs the specified hook after the first worker enters the accepting phase (once per instance).
• --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.

---

💅 the exec era 💅

• --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 / umount section, she's here 🦋

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

---

🌈 waiting era (she's patient, she's giving main character) 🌈

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

---

🧚 the call era 🧚

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

---

🎀 config loading + server 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.
• --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 + 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-reload era (she reacts to file changes, periodt) ⭐

• --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 — when that one file gets modified or touched, it sends a signal, bestie. syntax is file signal.
• --fs-reload — graceful reload when the specified filesystem object gets modified. so chill.
• --fs-brutal-reload — brutal reload when the specified filesystem object gets modified. no chill, just violence.
• --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 as --check-mountpoint: destroy the instance if a filesystem is no more reachable. useful for reliable Fuse management.
• --check-mount — also destroys the instance if a filesystem is no more reachable. useful for reliable Fuse management.
• --mount-check — another alias: 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. iykyk.
• --limit-post — limit the request body. periodt.
• --no-orphans — automatically kill workers if master dies. lowkey dangerous for availability, so be careful bestie.
• --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. let's get data.
• --metric — add a custom metric.
• --metric-threshold — add a metric threshold/alarm.
• --metric-alarm — add a metric threshold/alarm. same thing, different name.
• --alarm-metric — add a metric threshold/alarm. yup, another alias.
• --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. yes, same as --metrics-dir.
• --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. same vibes.
• --stats-http — prefix stats server json output with http headers.
• --stats-minified — minify statistics json output.
• --stats-min — minify statistics json output. alias alert.
• --stats-push — push the stats json to the specified destination.
• --stats-pusher-default-freq — set the default frequency of stats pushers.
• --stats-pushers-default-freq — set the default frequency of stats pushers. plural, same thing.
• --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 60 seconds).
• --legion-lord — action to call on Lord election.
• --legion-unlord — action to call on Lord dismiss.
• --legion-setup — action to call on legion setup.
• --legion-death — action to call on legion death (shutdown of the instance).
• --legion-join — action to call on legion join (first time quorum is reached).
• --legion-node-joined — action to call on 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. short and sweet.
• --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 specified 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, bestie, do not.
• --ssl-enable-sslv3 — enable SSLv3. also insecure.
• --ssl-enable-tlsv1 — enable TLSv1. insecure, avoid.
• --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. alias.
• --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. same.
• --logger — set/append a logger.
• --logger-list — list enabled loggers.
• --loggers-list — list enabled loggers. plural, same.
• --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 the main alarm thread instead of creating dedicated threads for curl-based alarms. no extra threads, we love to see it 💅
• --alarm-freq — tune the anti-loop alarm system (default 3 seconds). keep it from going feral ⏰
• --alarm-fd — raise the specified alarm when an fd is read for read (by default it reads 1 byte, set 8 for eventfd). eventfd besties rise 🫶
• --alarm-segfault — raise the specified alarm when the segmentation fault handler is executed. segfault moment 😭
• --segfault-alarm — raise the specified alarm when the segmentation fault handler is executed. same energy, just a different alias ✨
• --alarm-backlog — raise the specified alarm when the socket backlog queue is full. backlog? more like back-<em>log</em> amirite 🍑
• --backlog-alarm — raise the specified alarm when the socket backlog queue is full. identical twin fr fr 💖
• --lq-alarm — raise the specified alarm when the socket backlog queue is full. lq = listen queue, and yes it's the same alarm again 👑
• --alarm-lq — raise the specified alarm when the socket backlog queue is full. yet another alias, we stan consistency 💅
• --alarm-listen-queue — raise the specified alarm when the socket backlog queue is full. spelling it out for the girlies who need it 🌸
• --listen-queue-alarm — raise the specified alarm when the socket backlog queue is full. last one of the backlog bunch, promise 🎀
• --log-alarm — raise the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp>. regex goes brrr 🔥
• --alarm-log — raise the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp>. same thing, just flipped 🦋
• --not-log-alarm — skip the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp>. the "not" version, so you can be picky 💜
• --not-alarm-log — skip the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp>. yep, another alias, keep up bestie 😭
• --alarm-list — list enabled alarms. show me the receipts 📜
• --alarms-list — list enabled alarms. plural version, same tea ☕
• --alarm-msg-size — set the max size of an alarm message (default 8192). don't let your alarms be essay-length 📝
• --log-master — delegate logging to master process. let the master handle it, periodt 👑
• --log-master-bufsize — set the buffer size for the master logger. bigger log messages will be truncated. truncation is real, watch out ✂️
• --log-master-stream — create the master logpipe as SOCK_STREAM. streamy stream 🌊
• --log-master-req-stream — create the master requests logpipe as SOCK_STREAM. requests get the stream treatment too 📨
• --log-reopen — reopen log after reload. fresh start, reload edition 🔄
• --log-truncate — truncate log on startup. bye bye old logs 👋
• --log-maxsize — set maximum logfile size. cap it before it gets out of hand 📏
• --log-backupname — set logfile name after rotation. name your backup, glow up ✨
• --logdate — prefix logs with date or a strftime string. timestamps? iconic ⏳
• --log-date — prefix logs with date or a strftime string. hyphenated twin, same vibe 💅
• --log-prefix — prefix logs with a string. add your own flair to every line 🎀
• --log-zero — log responses without body. empty body? still log it 🫶
• --log-slow — log requests slower than the specified number of milliseconds. slow requests get called out 🐌
• --log-4xx — log requests with a 4xx response. client errors, we see you 👀
• --log-5xx — log requests with a 5xx response. server errors, big yikes 😬
• --log-big — log requests bigger than the specified size. thicc requests get logged 🍑
• --log-sendfile — log sendfile requests. sendfile? more like send-<em>logged</em> 📤
• --log-ioerror — log requests with io errors. io errors are not the vibe 😭
• --log-micros — report response time in microseconds instead of milliseconds. precision queen 🔬
• --log-x-forwarded-for — use the ip from X-Forwarded-For header instead of REMOTE_ADDR. real ip energy, no proxy erasure 🌈
• --master-as-root — leave master process running as root. danger? maybe. iconic? absolutely 👑
• --drop-after-init — run privileges drop after plugin initialization, superseded by drop-after-apps. old school, but drop-after-apps ate 💅
• --drop-after-apps — run privileges drop after apps loading, superseded by master-as-root. better, but master-as-root said "hold my crown" 👑
• --force-cwd — force the initial working directory to the specified value. no wandering off, stay put 📌
• --binsh — override /bin/sh (used by exec hooks, it always fallback to /bin/sh). custom shell, but fallback is always /bin/sh 🐚
• --chdir — chdir to specified directory before apps loading. move before you load 🚚
• --chdir2 — chdir to specified directory after apps loading. move after you load, fancy 🚚
• --lazy — set lazy mode (load apps in workers instead of master). lazy but make it efficient 😴
• --lazy-apps — load apps in each worker instead of the master. every worker gets its own copy, independent girlies 💅
• --cheap — set cheap mode (spawn workers only after the first request). no requests? no workers. frugal queen 💸
• --cheaper — set cheaper mode (adaptive process spawning). adaptive, so it scales when needed 📈
• --cheaper-initial — set the initial number of processes to spawn in cheaper mode. start small, bestie 🌱
• --cheaper-algo — choose to algorithm used for adaptive process spawning. pick your algorithm, main character energy 🧠
• --cheaper-step — number of additional processes to spawn at each overload. step it up when things get busy 🚀
• --cheaper-overload — increase workers after specified overload. overload? time to add more workers 🔥
• --cheaper-algo-list — list enabled cheapers algorithms. show me the algorithms 📋
• --cheaper-algos-list — list enabled cheapers algorithms. plural, same list 💅
• --cheaper-list — list enabled cheapers algorithms. short and sweet, still the list 🎀
• --cheaper-rss-limit-soft — don't spawn new workers if total resident memory usage of all workers is higher than this limit. soft limit, be gentle 🍑
• --cheaper-rss-limit-hard — if total workers resident memory usage is higher try to stop workers. hard limit, no mercy 💀
• --idle — set idle mode (put uWSGI in cheap mode after inactivity). chill mode activated after you stop working 😌
• --die-on-idle — shutdown uWSGI when idle. if you're not busy, you're done. dramatic exit 🚪
• --mount — load application under mountpoint. mount it like a pro 🏔️
• --worker-mount — load application under mountpoint in the specified worker or after workers spawn. worker-specific mount, fancy 💅
• --threads — run each worker in prethreaded mode with the specified number of threads. threads on threads on threads 🧵
• --thread-stacksize — set threads stacksize. stack size matters, bestie 📚
• --threads-stacksize — set threads stacksize. plural alias, same stack energy 🥞
• --thread-stack-size — set threads stacksize. hyphenated version, still the same 🎀
• --threads-stack-size — set threads stacksize. the final form of stacksize aliases 👑
• --vhost — enable virtualhosting mode (based on SERVER_NAME variable). virtual hosts, based on SERVER_NAME 🌐
• --vhost-host — enable virtualhosting mode (based on HTTP_HOST variable). same but HTTP_HOST, choose your fighter 🥊
• --route — add a route. route it, queen 🛣️
• --route-host — add a route based on Host header. host-based routing, we love to see it 🏠
• --route-uri — add a route based on REQUEST_URI. uri routing, classic 💅
• --route-qs — add a route based on QUERY_STRING. query string routing, get specific 🔍
• --route-remote-addr — add a route based on REMOTE_ADDR. ip-based routing, know your audience 🌍
• --route-user-agent — add a route based on HTTP_USER_AGENT. user agent routing, detect the vibes 🕵️
• --route-remote-user — add a route based on REMOTE_USER. remote user routing, personal touch 👤
• --route-referer — add a route based on HTTP_REFERER. referer routing, where did you come from? 🔗
• --route-label — add a routing label (for use with goto). label it for your goto jumps 🏷️
• --route-if — add a route based on condition. conditional routing, if this then that 🧠
• --route-if-not — add a route based on condition (negate version). the "not" version, spicy 🌶️
• --route-run — always run the specified route action. no conditions, just do it ✅
• --final-route — add a final route. the last word in routing 🏁
• --final-route-status — add a final route for the specified status. status-specific final route, bougie 💅
• --final-route-host — add a final route based on Host header. final + host, double threat 🏠
• --final-route-uri — add a final route based on REQUEST_URI. final + uri, precise 🎯
• --final-route-qs — add a final route based on QUERY_STRING. final + query string, detailed 🔍
• --final-route-remote-addr — add a final route based on REMOTE_ADDR. final + ip, knowing 🌍
• --final-route-user-agent — add a final route based on HTTP_USER_AGENT. final + user agent, vibes 🕵️
• --final-route-remote-user — add a final route based on REMOTE_USER. final + remote user, personal 👤
• --final-route-referer — add a final route based on HTTP_REFERER. final + referer, nostalgic 🔗
• --final-route-label — add a final routing label (for use with goto). final label for your goto 🏷️
• --final-route-if — add a final route based on condition. final conditional, if this then done 🧠
• --final-route-if-not — add a final route based on condition (negate version). final "not" condition, rebel 🌶️
• --final-route-run — always run the specified final route action. final run, no questions asked ✅
• --error-route — add an error route. error routing, handle it gracefully 😭
• --error-route-status — add an error route for the specified status. status-specific error route, bougie 💅
• --error-route-host — add an error route based on Host header. error + host, where did it go wrong? 🏠
• --error-route-uri — add an error route based on REQUEST_URI. error + uri, pinpoint the oops 🎯
• --error-route-qs — add an error route based on QUERY_STRING. error + query string, detective mode 🔍
• --error-route-remote-addr — add an error route based on REMOTE_ADDR. error + ip, who did this? 🌍
• --error-route-user-agent — add an error route based on HTTP_USER_AGENT. error + user agent, blame the browser 🕵️
• --error-route-remote-user — add an error route based on REMOTE_USER. error + remote user, personal oops 👤
• --error-route-referer — add an error route based on HTTP_REFERER. error + referer, how did you get here? 🔗
• --error-route-label — add an error routing label (for use with goto). error label for your goto 🏷️
• --error-route-if — add an error route based on condition. error conditional, if this then panic 🧠
• --error-route-if-not — add an error route based on condition (negate version). error "not" condition, plot twist 🌶️
• --error-route-run — always run the specified error route action. error run, always ready ✅
• --response-route — add a response route. response routing, after the fact 🎯
• --response-route-status — add a response route for the specified status. status-specific response route, bougie 💅
• --response-route-host — add a response route based on Host header. response + host, where it went 🏠
• --response-route-uri — add a response route based on REQUEST_URI. response + uri, precise 🎯
• --response-route-qs — add a response route based on QUERY_STRING. response + query string, detailed 🔍
• --response-route-remote-addr — add a response route based on REMOTE_ADDR. response + ip, knowing 🌍
• --response-route-user-agent — add a response route based on HTTP_USER_AGENT. response + user agent, vibes 🕵️
• --response-route-remote-user — add a response route based on REMOTE_USER. response + remote user, personal 👤
• --response-route-referer — add a response route based on HTTP_REFERER. response + referer, nostalgic 🔗
• --response-route-label — add a response routing label (for use with goto). response label for your goto 🏷️
• --response-route-if — add a response route based on condition. response conditional, if this then that 🧠
• --response-route-if-not — add a response route based on condition (negate version). response "not" condition, spicy 🌶️
• --response-route-run — always run the specified response route action. response run, always ✅
• --router-list — list enabled routers. show me the routers 📋
• --routers-list — list enabled routers. plural, same list 💅
• --error-page-403 — add an error page (html) for managed 403 response. 403 page, custom and cute 🚫
• --error-page-404 — add an error page (html) for managed 404 response. 404 page, iconic 🕳️
• --error-page-500 — add an error page (html) for managed 500 response. 500 page, dramatic 💥
• --websockets-ping-freq — set the frequency (in seconds) of websockets automatic ping packets. ping ping ping 🏓
• --websocket-ping-freq — set the frequency (in seconds) of websockets automatic ping packets. singular alias, same ping 🏓
• --websockets-pong-tolerance — set the tolerance (in seconds) of websockets ping/pong subsystem. pong tolerance, be patient 🏓
• --websocket-pong-tolerance — set the tolerance (in seconds) of websockets ping/pong subsystem. singular twin, same tolerance 🏓
• --websockets-max-size — set the max allowed size of websocket messages (in Kbytes, default 1024). size limit, keep it tight 📏
• --websocket-max-size — set the max allowed size of websocket messages (in Kbytes, default 1024). singular alias, same max 📏
• --chunked-input-limit — set the max size of a chunked input part (default 1MB, in bytes). chunked input limit, byte by byte 🧩
• --chunked-input-timeout — set default timeout for chunked input. timeout for chunked input, don't wait forever ⏰
• --clock — set a clock source. tick tock, pick your clock ⏰
• --clock-list — list enabled clocks. show me the clocks 📋
• --clocks-list — lists all the clocks you've got enabled ✨
• --add-header — auto-slaps HTTP headers onto the response for you 🎀
• --rem-header — auto-removes the HTTP header you name from the response 🧹
• --del-header — same vibe, auto-removes the specified HTTP header from the response
• --collect-header — stashes the response header you name into a request var (syntax: header var) 💌
• --response-header-collect — also stashes the specified response header into a request var (syntax: header var)
• --pull-header — stashes the specified response header into a request var and rips it out of the response (syntax: header var) 🫳
• --check-static — checks for static files in the directory you point it at
• --check-static-docroot — checks for static files in the requested DOCUMENT_ROOT
• --static-check — checks for static files in the specified directory (same energy, different name) 💫
• --static-map — maps a mountpoint to a static directory (or a file)
• --static-map2 — like --static-map but it completely appends the requested resource to the docroot
• --static-skip-ext — skips the extension you name when doing static file checks
• --static-index — searches for the file you specify 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), twin edition
• --static-expires-type — sets the Expires header based on content type
• --static-expires-type-mtime — sets the Expires header based on content type and file mtime
• --static-expires — sets the Expires header based on a filename regexp
• --static-expires-mtime — sets the Expires header based on a filename regexp and file mtime
• --static-expires-uri — sets the Expires header based on a REQUEST_URI regexp
• --static-expires-uri-mtime — sets the Expires header based on a REQUEST_URI regexp and file mtime
• --static-expires-path-info — sets the Expires header based on a PATH_INFO regexp
• --static-expires-path-info-mtime — sets the Expires header based on a PATH_INFO regexp and file mtime
• --static-gzip — if your regexp matches the static file translation, it goes looking for a gzip version 🗜️
• --static-gzip-all — checks for a gzip version of every single requested static file
• --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), singular bestie
• --file-serve-mode — sets the static file serving mode
• --fileserve-mode — sets the static file serving mode (yep, same thing)
• --disable-sendfile — disables sendfile() and relies on boring read()/write() instead 🙈
• --check-cache — checks for response data in the cache you specify (leave it empty for the default cache)
• --close-on-exec — sets close-on-exec on connection sockets (could be required for spawning processes in requests)
• --close-on-exec2 — sets close-on-exec on server sockets (could be required for spawning processes in requests)
• --mode — 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 specify to the file you specify (syntax: file=value) before privileges drop
• --cgroup — puts the processes in the cgroup you specify
• --cgroup-opt — sets a value in the cgroup option you specify
• --cgroup-dir-mode — sets permission for the cgroup directory (default is 700) 🔐
• --namespace — runs 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 specified rootfs (short king edition)
• --namespace-net — adds a network namespace 🌐
• --ns-net — adds a network namespace
• --enable-proxy-protocol — enables PROXY1 protocol support (only for http parsers) 🛰️
• --reuse-port — enables the REUSE_PORT flag on the socket (BSD only)
• --tcp-fast-open — enables the TCP_FASTOPEN flag on TCP sockets with the qlen value you give it 🚀
• --tcp-fastopen — enables the TCP_FASTOPEN flag on TCP sockets with the specified qlen value
• --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 max time (in seconds) we wait for a cron command to finish 🗡️
• --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 specified legion
• --unique-legion-cron — adds a unique cron task that only runs when the instance is a lord of the specified legion
• --unique-cron-legion — adds a unique cron task that only runs when the instance is a lord of the specified legion
• --loop — selects the uWSGI loop engine 🔁
• --loop-list — lists all the enabled loop engines
• --loops-list — lists the enabled loop engines (plural moment)
• --worker-exec — runs the command you specify as a worker
• --worker-exec2 — runs the command you specify as a worker (after the post_fork hook) 🪝
• --attach-daemon — attaches a command/daemon to the master process (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), and when the daemon dies, the master dies too 💀
• --smart-attach-daemon — attaches a command/daemon to the master process managed by a pidfile (the command has to daemonize)
• --smart-attach-daemon2 — attaches a command/daemon to the master process managed by a pidfile (the command has to NOT daemonize) 🙃
• --legion-attach-daemon — same as --attach-daemon but the daemon only runs on a legion lord node 👑
• --legion-smart-attach-daemon — same as --smart-attach-daemon but the daemon only runs on a legion lord node
• --legion-smart-attach-daemon2 — same as --smart-attach-daemon2 but the daemon only runs on a 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 (exit on error, singular bestie)
• --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 all the enabled plugins 📋
• --plugin-list — lists the enabled plugins
• --autoload — tries to automatically load plugins when unknown options are found ✨
• --dlopen — blindly loads a shared library 🙈
• --allowed-modifiers — comma separated list of 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 the whole option list bestie, you made it to the end 🎉 This one's from uwsgi_rados version 2.0.31-2, dated February 2026, and the page is UWSGI_RADOS(1) — go forth and configure, icon, you've got this 💖✨🦋