UWSGI_EMPEROR_PG(1)

📦

version 2.0.31 · 7 versions

💖 UWSGI_EMPEROR_PG — the manual, but make it slay ✨

okay so bestie, welcome to the uwsgi_emperor_pg(1) manual page. this is a User Command, and honestly? it's giving legend behaviour. no cap. let me walk you through it like we're texting at 2am and i'm obsessed with this tool. 🫶

✨ NAME ✨

uwsgi_emperor_pg — a fast (pure C, she's native fr fr), self-healing, developer-friendly WSGI server. periodt. 💅

🌈 SYNOPSIS 🌈

uwsgi-core [options...]

that's it. that's the whole vibe. you run uwsgi-core and then sprinkle options on top like glitter. 🎀

💜 DESCRIPTION 💜

okay this part is LONG so grab a snack 🍓. it's basically a giant list of every option she accepts, and bestie, she accepts a lot. each one is a little gift. let's go.

-s, --socket — bind to the specified UNIX/TCP socket using the default protocol. lowkey the intro option, the main character energy of sockets. ✨
-s, --uwsgi-socket — bind to the specified UNIX/TCP socket, but this time using the uwsgi protocol. yes she shares the short flag, that's just how she is. 💅
--suwsgi-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol over SSL. secure AND slaying. 🔐
--ssl-socket — bind to the specified UNIX/TCP socket using the uwsgi protocol over SSL. same energy, different flag name, iconic.
--http-socket — bind to the specified UNIX/TCP socket using the HTTP protocol. the classic. the original. we love her. 🌐
--http-socket-modifier1 — force the specified modifier1 when using HTTP protocol. you decide the number, she obeys. no questions. 🎯
--http-socket-modifier2 — force the specified modifier2 when using HTTP protocol. twin of the above, equally valid. 💖
--http11-socket — bind to the specified UNIX/TCP socket using HTTP 1.1 (Keep-Alive) protocol. she stays connected, she's loyal fr fr.
--https-socket — bind to the specified UNIX/TCP socket using HTTPS protocol. locked down and gorgeous. 🔒
--https-socket-modifier1 — force the specified modifier1 when using HTTPS protocol. modifier magic ✨
--https-socket-modifier2 — force the specified modifier2 when using HTTPS protocol. the sequel. 🎬
--fastcgi-socket — bind to the specified UNIX/TCP socket using FastCGI protocol. fast AND CGI. she's efficient okay 😭
--fastcgi-nph-socket — bind to the specified UNIX/TCP socket using FastCGI protocol in nph mode. nph stands for non-parsed headers, and that's just facts, not me guessing. 🧚
--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. another protocol, another slay. 🌸
--scgi-nph-socket — bind to the specified UNIX/TCP socket using SCGI protocol in nph mode. same nph situation as above.
--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. unfiltered. honest. she's not like other sockets. 💀
--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 persists. obviously. 👑
--protocol — force the specified protocol for default sockets. you're in charge of the vibe check here.
--socket-protocol — force the specified protocol for default sockets. same energy, twin flag. 🫶
--shared-socket — create a shared socket for advanced jailing or ipc. for when things get ✨advanced✨.
--undeferred-shared-socket — create a shared socket for advanced jailing or ipc, but in undeferred mode. the non-deferred remix. 🎧
-p, --processes — spawn the specified number of workers/processes. how many besties you want on the job.
-p, --workers — spawn the specified number of workers/processes. yes, this shares the -p flag with --processes. they're twins. deal with it. 💅
--thunder-lock — serialize accept() usage (if possible). thunder. lock. dramatic AND functional. ⚡
-t, --harakiri — set the harakiri timeout. if a request is taking too long, she ends it. respectfully. 🗡️
--harakiri-verbose — enable verbose mode for harakiri. so when she takes the sword, she narrates it. 💀
--harakiri-graceful-timeout — the interval between a graceful harakiri attempt and a sigkill. so like, she asks nicely first, then it gets real.
--harakiri-graceful-signal — use this signal instead of sigterm for graceful harakiri attempts. you pick the signal, she uses it.
--harakiri-queue-threshold — only trigger harakiri if the queue is greater than this threshold. so she only gets dramatic when the queue is actually struggling. 💅
--harakiri-no-arh — do not enable harakiri during after-request-hook. give the hook some space bestie.
--no-harakiri-arh — do not enable harakiri during after-request-hook. same as above, different spelling, both valid. ✨
--no-harakiri-after-req-hook — do not enable harakiri during after-request-hook. trio of twin flags because she's extra like that. 😌
--backtrace-depth — set the backtrace depth. for when you need to see how deep the drama really goes. 🔍
--mule-harakiri — set the harakiri timeout for mule tasks. the mules get their own harakiri rules. iconic. 🐴
-x, --xmlconfig — load config from an xml file. old school but still cute. 📄
-x, --xml — load config from xml file. same thing, she has two names, she's mysterious. 🌈
--config — load configuration using the pluggable system. flexible queen. 🎀
--fallback-config — re-exec uwsgi with the specified config when exit code is 1. a backup plan, because she plans ahead. 💖
--strict — enable strict mode. important caveat: placeholder cannot be used in strict mode. so fr fr, no placeholders. 🚫
--skip-zero — skip the check of file descriptor 0. just skipping it. no thoughts. 🌸
--skip-atexit — skip atexit hooks (this is ignored by the master). the master is unbothered. 💅
--skip-atexit-teardown — skip atexit teardown (also ignored by the master). she's consistent about not listening to the master on this. 😌
-S, --set — set a placeholder or an option. versatile much? ✨
--set-placeholder — set a placeholder. specific mode unlocked. 🎯
--set-ph — set a placeholder. yes this is the same as above, she has nicknames, let her live. 🦋
--get — print the specified option value and exit. short and to the point, we love a clean exit. 🚪
--declare-option — declare a new uWSGI custom option. you can make your own options now. main character move tbh. 👑
--declare-option2 — declare a new uWSGI custom option, but non-immediate. the chill delayed version. 💤
--resolve — place the result of a dns query in the specified placeholder. syntax is: placeholder=name — and btw it's an immediate option. (the original manual typo'd it as "sytax", i'm just fixing the spelling for readability, the meaning is identical 🫶)
--for — (opt logic) for cycle. logic time bestie. 🔄
--for-glob — (opt logic) for cycle, but expand the glob. patterns get matched, magic happens. ✨
--for-times — (opt logic) for cycle, expanding the specified num to a list starting from 1. so if you say 5, you get 1 2 3 4 5. 💅
--for-readline — (opt logic) for cycle, expanding the specified file to a list of lines. 📄
--endfor — (opt logic) end for cycle. closing the loop, respectfully. 🎀
--end-for — (opt logic) end for cycle. same energy, different spelling. 🌈
--if-opt — (opt logic) check for option. conditional queen. 👀
--if-not-opt — (opt logic) check for option (the inverse vibe). 🙃
--if-env — (opt logic) check for an environment variable. 🌱
--if-not-env — (opt logic) check for environment variable (not-version). ✨
--ifenv — (opt logic) check for environment variable. third name for the same thing, she's just like that. 💅
--if-reload — (opt logic) check for reload. did she just reload? check it. 🔁
--if-not-reload — (opt logic) check for reload (the not-version). 🔄
--if-hostname — (opt logic) check for hostname. who are you, machine? 🏠
--if-not-hostname — (opt logic) check for hostname (not-version). 🚫
--if-hostname-match — (opt logic) try to match hostname against a regular expression. regex girlies rise up. 🧚
--if-not-hostname-match — (opt logic) try to match hostname against a regular expression (not-version). 🪞
--if-exists — (opt logic) check for file/directory existence. does it exist? check. 📂
--if-not-exists — (opt logic) check for file/directory existence (not-version). 👻
--ifexists — (opt logic) check for file/directory existence. yes, another nickname, keep up. 💖
--if-plugin — (opt logic) check for plugin. does the plugin exist? 🔌
--if-not-plugin — (opt logic) check for plugin (not-version). 🚫
--ifplugin — (opt logic) check for plugin. the third twin. 💅
--if-file — (opt logic) check for file existence specifically. 📄
--if-not-file — (opt logic) check for file existence (not-version). 🌸
--if-dir — (opt logic) check for directory existence specifically. 📁
--if-not-dir — (opt logic) check for directory existence (not-version). 🦋
--ifdir — (opt logic) check for directory existence. yes, again, a nickname. she has SO many. 😭
--if-directory — (opt logic) check for directory existence. fourth one for this exact check, bestie, i'm not joking. 💖
--endif — (opt logic) end if. close the conditional. 🔒
--end-if — (opt logic) end if. twin. ✨
--blacklist — set options blacklist context. spicy permissions move. 🖤
--end-blacklist — clear options blacklist context. undo. 🧹
--whitelist — set options whitelist context. the opposite vibe, but equally valid. 🤍
--end-whitelist — clear options whitelist context. undo again. 🧼
--ignore-sigpipe — do not report the (annoying) SIGPIPE. silence is golden fr fr. 🤫
--ignore-write-errors — do not report the (also annoying) write()/writev() errors. peace and quiet. 🕊️
--write-errors-tolerance — set the maximum number of allowed write errors. default is no tolerance. so by default, she does NOT play. important caveat!! ⚠️
--write-errors-exception-only — only raise an exception on write errors, giving control to the app itself. let the app handle its own drama. 🎭
--disable-write-exception — disable exception generation on write()/writev(). no exceptions, periodt. 🚫
--inherit — use the specified file as a config template. 💌
--include — include the specified file as immediate configuration. ⚡
--inject-before — inject a text file before the config file (advanced templating). 🎀
--inject-after — inject a text file after the config file (advanced templating). 🎀
-d, --daemonize — daemonize uWSGI. she becomes one with the background. 🌙
--daemonize2 — daemonize uWSGI after app loading. fashionably late to the background. ⏰
--stop — stop an instance. bye bestie 👋
--reload — reload an instance. refresh her. 🔄
--pause — pause an instance. hold that thought. ✋
--suspend — suspend an instance. deeper pause energy. 💤
--resume — resume an instance. she's back and better. 🌟
--connect-and-read — connect to a socket and wait for data from it. patient queen. ⏳
--extract — fetch/dump any supported address to stdout. dump it, bestie. 📤
-l, --listen — set the socket listen queue size. how many can wait in line. 🚦
-v, --max-vars — set the amount of internal iovec/vars structures. variable vibes only. 🎛️
--max-apps — set the maximum number of per-worker applications. how many apps per worker. 💅
-b, --buffer-size — set internal buffer size. size matters here. 📏
-m, --memory-report — enable memory report. receipts for your RAM. 🧾
--profiler — enable the specified profiler. performance girlies, get in. 📊
-c, --cgi-mode — force CGI-mode for plugins supporting it. retro but make it cute. 📼
-a, --abstract-socket — force UNIX socket in abstract mode (Linux only). linux besties only on this one. 🐧
-C, --chmod-socket — chmod-socket. set those perms. 🔑
-C, --chmod — chmod-socket. same thing, shorter name. 💅
--chown-socket — chown unix sockets. change the owner, change the vibe. 👤
--umask — set umask. classic unix move. 🎭
--freebind — put socket in freebind mode. she roams free. 🦋
--map-socket — map sockets to specific workers. assignments, bestie. 🗺️
-T, --enable-threads — enable threads. stub option btw: this is true by default. so it's already true, she's just giving you the option to say it out loud. 🧵
--no-threads-wait — do not wait for threads cancellation on quit/reload. she's not waiting. 🚪
--auto-procname — automatically set process names to something meaningful. she names herself. 👑
--procname-prefix — add a prefix to the process names. 📛
--procname-prefix-spaced — add a spaced prefix to the process names. the space is the moment. ✨
--procname-append — append a string to process names. 🎀
--procname — set process names. the whole thing. 💖
--procname-master — set master process name. master gets her own name. 👸
-i, --single-interpreter — do not use multiple interpreters (where available). one interpreter, one vibe. 🎯
--need-app — exit if no app can be loaded. she needs the app fr fr. no app, no service. 🚪
-M, --master — enable master process. the boss is here. 👑
--honour-stdin — do not remap stdin to /dev/null. respect the stdin. 🎤
--emperor — run the Emperor. yes, she's royalty. she runs everything. 👑✨
--emperor-proxy-socket — force the vassal to become an Emperor proxy. vassals with main character energy. 🎭
--emperor-wrapper — set a binary wrapper for vassals. wrapping them up nice. 🎁
--emperor-wrapper-override — set a binary wrapper for vassals to try before the default one. priority wrapper. 🥇
--emperor-wrapper-fallback — set a binary wrapper for vassals to try as a last resort. backup wrapper, just in case. 🛟
--emperor-nofollow — do not follow symlinks when checking for mtime. symlinks stay unbothered. 🔗
--emperor-procname — set the Emperor process name. name the royalty. 👑
--emperor-freq — set the Emperor scan frequency. default is 3 seconds. so she scans every 3 seconds, no cap. ⏱️
--emperor-required-heartbeat — set the Emperor tolerance about heartbeats. how forgiving she is about heartbeats. 💓
--emperor-curse-tolerance — set the Emperor tolerance about cursed vassals. how much cursed behaviour she tolerates. 🧙

okay that's the end of part 1 bestie, more is coming 🫶✨

--emperor-pidfile — drops the Emperor's pid into the file you name, so you can find your ruler later 💖
--emperor-tyrant — flips the Emperor into Tyrant mode 🫅 no cap, it does not play
--emperor-tyrant-nofollow — in Tyrant mode, don't follow symlinks when it's checking uid/gid. no sneaky shortcuts, bestie 🚫🔗
--emperor-stats — spins up the Emperor stats server ✨
--emperor-stats-server — same vibe, spins up the Emperor stats server ✨
--early-emperor — spawns the emperor ASAP, like, the second it can 😤
--emperor-broodlord — runs the emperor in BroodLord mode 👑
--emperor-throttle — sets the throttling level (in milliseconds) for vassals that are acting up (default 1000) 🫠
--emperor-max-throttle — sets the max throttling level (in milliseconds) for bad-behaving vassals (default 3 minutes) 😭
--emperor-magic-exec — prefixes vassals' config files with exec:// if they've got the executable bit set 🪄
--emperor-on-demand-extension — searches for a text file (vassal name + extension) that holds the on demand socket name 🔍
--emperor-on-demand-ext — literally the same thing, searches for that text file (vassal name + extension) with the on demand socket name 🔍
--emperor-on-demand-directory — turns on on demand mode, binding to the unix socket in the directory you give, named like the vassal + .socket 🔌
--emperor-on-demand-dir — same energy: on demand mode, unix socket in your directory, named like the vassal + .socket 🔌
--emperor-on-demand-exec — uses the output of the command you specify as the on demand socket name (the vassal name gets passed as the only argument) 🎯
--emperor-extra-extension — lets the Emperor accept that extension (the vassal gets called with --config) 🧚
--emperor-extra-ext — again, allows that extension in the Emperor (vassal called with --config) 🧚
--emperor-no-blacklist — disables 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, that's the word
--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 in vassals' config (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 in vassals' config (uses --include instead of --inherit, and parses before the vassal file) ⏮️
--vassals-start-hook — runs the command you give before each and every vassal starts 🏁
--vassals-stop-hook — runs the command you give after a vassal's death ⚰️
--vassal-sos — the vassal asks the emperor for reinforcement when it's overloaded 🆘
--vassal-sos-backlog — the vassal fires off an sos if the backlog queue has more items than the value you set 📈
--vassals-set — automatically sets the option you name (via --set) for every vassal ⚙️
--vassal-set — automatically sets that option (via --set) for every vassal ⚙️
--heartbeat — announces healthiness to the emperor 💓
--reload-mercy — sets the max time (in seconds) we wait for workers and other processes to die during reload/shutdown ⏳
--worker-reload-mercy — sets the max time (in seconds) a worker gets to reload/shutdown (default is 60) ⏳
--mule-reload-mercy — sets the max time (in seconds) a mule gets to reload/shutdown (default is 60) ⏳
--exit-on-reload — forces an exit even if a reload was requested 🚪
--die-on-term — exits instead of doing a brutal reload on SIGTERM 💀
--force-gateway — forces the spawn of the first registered gateway with no master 💥
-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 that binary symbol 🔎
-r|--reaper — calls waitpid(-1,...) after each request to get rid of zombies 🧟 no zombie apocalypse, not today
-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 has to 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 the internal sockets timeout 🌐
--no-fd-passing — disables file descriptor passing 🚫
--locks — creates the number of shared locks you specify 🔒
--lock-engine — sets the lock engine 🔧
--ftok — sets the ipcsem key via ftok() so you avoid duplicates 🗝️
--persistent-ipcsem — does not remove ipcsem's on shutdown 🫥 they stay
-A|--sharedarea — creates a raw shared memory area of the number of pages you give (heads up: it supports keyval too) 🧠
--safe-fd — does not close the file descriptor you specify 🛟
--fd-safe — does not close that file descriptor 🛟
--cache — creates a shared cache holding the given elements 🍰
--cache-blocksize — sets the cache blocksize 🧱
--cache-store — enables persistent cache to disk 💾
--cache-store-sync — sets the frequency of sync for the persistent cache 🔁
--cache-no-expire — disables the auto sweep of expired items 🧹🚫
--cache-expire-freq — sets 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, bestie) 🐛
--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 on server startup 📥
--cache-use-last-modified — updates the last_modified_at timestamp on every cache item modification (default is disabled) 🕰️
--add-cache-item — adds an item in the cache ➕
--load-file-in-cache — loads a static file 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 frequency of sync 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 — does a chdir() 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 a spooler gets recycled ♻️
--spooler-harakiri — sets the harakiri timeout for spooler tasks 🗡️
--spooler-frequency — sets the spooler frequency ⏲️
--spooler-freq — sets the spooler frequency ⏲️
--mule — adds a mule 🐴
--mules — adds the number of mules you specify 🐴🐴🐴
--farm — adds a mule farm 🚜
--mule-msg-size — sets the mule message buffer size 📦
--signal — sends a uwsgi signal to a server 📶
--signal-bufsize — sets the buffer size for the signal queue 📏
--signals-bufsize — sets the buffer size for the signal queue 📏
--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 specified file before starting, and exits if it's locked 🔐
--flock-wait — locks the specified file before starting, and waits if it's locked ⏸️
--flock2 — locks the specified file after logging/daemon setup, exits if it's locked 🔐
--flock-wait2 — locks the specified file after logging/daemon setup, waits if it's locked ⏸️
--pidfile — creates a pidfile (before privileges drop) 📝
--pidfile2 — creates a pidfile (after privileges drop) 📝
--safe-pidfile — creates a safe pidfile (before privileges drop) 🛟
--safe-pidfile2 — creates a safe pidfile (after privileges drop) 🛟
--chroot — does a chroot() to the directory you specify 📦
--pivot-root — does a pivot_root() to the directories you specify (new_root and put_old must be separated with a space) 🔄
--pivot_root — does a pivot_root() to those directories (new_root and put_old separated with a space) 🔄
--uid — does a setuid to the user/uid you specify 👤
--gid — does a 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, but IMMEDIATELY ⚡
--immediate-gid — setgid to the group/gid you specify, IMMEDIATELY ⚡
--no-initgroups — disables the additional groups that get set via initgroups() 🚫
--cap — sets the process capability 🎩
--unshare — unshare()s part of the processes and drops them in a new namespace 🪐
--unshare2 — same thing, unshare()s part of the processes into a new namespace — but after the rootfs change 🪐
--setns-socket — exposes a unix socket that returns namespace fds from /proc/self/ns 🔌
--setns-socket-skip — skips the entry you specify when sending setns file descriptors ⏭️
--setns-skip — skips that entry 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 ⚡
--jailed — marks this instance as jailed, which forces the post_jail hooks to actually run. it's giving "yes i am in the box, treat me like it" 💅
--refork — does a fork() again after the privileges drop. super handy for jailing systems ✨
--re-fork — literally the same thing as --refork, just spelled the other way. fork() again after privileges drop, jailing systems, you know the drill 🦋
--refork-as-root — fork() again, but before the privileges drop this time. again, for jailing systems 💖
--re-fork-as-root — the hyphenated twin of --refork-as-root. fork() again before privileges drop, useful for jailing systems 🌸
--refork-post-jail — fork() again after jailing. jailing systems again bestie, we love them 💅
--re-fork-post-jail — yep, same as --refork-post-jail, extra hyphen edition. 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 the privileges drop 👑
--hook-as-user — runs the specified hook after the 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 only once per-instance ✨
--hook-accepting1-once — runs the specified hook after the first worker enters the accepting phase, and only 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 is <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 (same energy fr fr)

--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 the privileges drop 👑
--exec-as-user — runs the specified command after the 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 the 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 the 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 (same thing, shorter name)
--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 the privileges drop 👑
--call-as-user — calls the specified function after the 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 — load config from an ini file 📜
-y, --yaml — load config from a yaml file 🌸
-y, --yml — load config from a yaml file (same short flag, same vibe)
-j, --json — load config from a json file 🧾
-j, --js — load config from a json file (again, -j does both)

--weight — the weight of the instance. it's used by clustering/lb/subscriptions ⚖️
--auto-weight — sets the weight of the instance automatically, also used by clustering/lb/subscriptions ✨
--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 (yes, same one)
--so-write-timeout — sets SO_SNDTIMEO (yep, still SO_SNDTIMEO)
--socket-write-timeout — sets SO_SNDTIMEO (they're all the same bestie, pick your fav name)
--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 the processes' address space/vsz 🧱
--limit-nproc — limits the number of spawnable processes 🚧
--reload-on-as — reloads if address space goes higher than the specified megabytes 🔄
--reload-on-rss — reloads if rss memory goes higher than the specified megabytes 🔄
--evil-reload-on-as — forces the master to reload a worker if its address space is higher than the specified megabytes 😈
--evil-reload-on-rss — forces the master to reload a worker if its rss memory is higher than the 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 a 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 a 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 a command when the specified file is modified/touched. syntax is file command 💻

okay bestie, this next chunk is LONG but it's lowkey the fun stuff ✨ filesystem watchers, metrics, stats, legions, subscriptions, ssl, loggers… we got it ALL. hydrate, stretch, let's GO 💅

🦋 bestie, let's watch some files (and mountpoints, and touches)

--touch-signal — pings a signal when the file you point at gets modified/touched. Syntax is literally: file signal
--fs-reload — graceful reload the moment the filesystem object you named gets modified 🎀
--fs-brutal-reload — same vibe but BRUTAL. no gentle goodbye, just reload when the filesystem object changes 💀
--fs-signal — raise a uwsgi signal when the filesystem object you specified gets modified. Syntax: file signal
--check-mountpoint — nukes the instance if a filesystem stops being reachable (super useful for reliable Fuse management, iykyk)
--mountpoint-check — destroys the instance if a filesystem is no longer reachable (yes bestie, same thing, reliable Fuse management ✨)
--check-mount — destroys the instance if a filesystem is no more reachable (reliable Fuse management energy)
--mount-check — destroys the instance if a filesystem is no more reachable (reliable Fuse management, again 🫶)
--propagate-touch — an over-engineering option for systems with flaky signal management. yes that's literally what it says 🙈

🍓 request bodies, orphans & process vibes

--limit-post — caps the request body. limit her, periodt.
--no-orphans — automatically kills workers if the master dies. can be dangerous for availability, so be careful bestie ⚠️
--prio — set processes/threads priority
--cpu-affinity — set cpu affinity (pin those threads where you want 'em 💅)
--post-buffering — set the size in bytes after which it buffers to disk instead of memory
--post-buffering-bufsize — set the buffer size for read() when you're in post buffering mode
--body-read-warning — sets how many megabytes of memory allocation are allowed for a request body before it starts printing a warning. a lil heads up before things get spicy 🔥
--upload-progress — enables creation of .json files in the directory you specify, while a file upload is happening 📂

🌸 app mounting & script name shenanigans

--no-default-app — do not fallback to the default app
--manage-script-name — automatically rewrites SCRIPT_NAME and PATH_INFO
--ignore-script-name — ignore SCRIPT_NAME entirely, no thoughts head empty 💭
--catch-exceptions — reports the exception as http output. discouraged!! use only for testing 🙈
--reload-on-exception — reloads a worker whenever an exception is raised
--reload-on-exception-type — reloads a worker when a specific exception type is raised
--reload-on-exception-value — reloads a worker when a specific exception value is raised
--reload-on-exception-repr — reloads a worker when a specific exception type+value (language-specific, okurr) is raised
--exception-handler — add an exception handler

👑 metrics, stats & alarms (the monitoring girlies)

--enable-metrics — turn the whole metrics subsystem ON
--metric — add a custom metric
--metric-threshold — add a metric threshold/alarm
--metric-alarm — add a metric threshold/alarm
--alarm-metric — add a metric threshold/alarm
--metrics-dir — export metrics as text files into the directory you name
--metrics-dir-restore — restore the last value taken from the metrics dir
--metric-dir — export metrics as text files to the specified directory
--metric-dir-restore — restore last value taken from the metrics dir
--metrics-no-cores — disable generation of cores-related metrics
--udp — run the udp server on the address you specify 📡
--stats — enable the stats server on the specified address
--stats-server — enable the stats server on the specified address (same queen, different name 👑)
--stats-http — prefix stats server json output with http headers
--stats-minified — minify the statistics json output
--stats-min — minify statistics json output
--stats-push — push the stats json to the destination you specify
--stats-pusher-default-freq — set the default frequency of stats pushers
--stats-pushers-default-freq — set the default frequency of stats pushers
--stats-no-cores — disable generation of cores-related stats
--stats-no-metrics — do not include metrics in the stats output
--multicast — subscribe to the 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

🧚 the legion section (yes it's really called a legion, iconic)

--legion — become a member of a legion
--legion-mcast — become 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 the legion subsystem
--legion-death-on-lord-error — declares itself as a dead node for the number of seconds you specify if one of the lord hooks fails 💀
--legion-skew-tolerance — set the clock skew tolerance of the legion subsystem (default 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 (shutdown of the instance)
--legion-join — the action to call on legion join (first time quorum is reached)
--legion-node-joined — the action to call on a new node joining the legion
--legion-node-left — the action to call on a node leaving the legion
--legion-quorum — set the quorum of a legion
--legion-scroll — set the scroll of a legion
--legion-scroll-max-size — set the max size of the legion scroll buffer
--legion-scroll-list-max-size — set the max size of the legion scroll list buffer

💜 subscriptions, security & signing

--subscriptions-sign-check — set the digest algorithm and certificate directory for the secured subscription system
--subscriptions-sign-check-tolerance — set the maximum tolerance (in seconds) of clock skew for the secured subscription system
--subscriptions-sign-skip-uid — skip the signature check for the uid you specify, when using unix sockets credentials
--subscriptions-credentials-check — add a directory to search for subscriptions key credentials
--subscriptions-use-credentials — enable management of SCM_CREDENTIALS in subscriptions UNIX sockets
--subscription-algo — set the load balancing algorithm for the subscription system
--subscription-dotsplit — try to fallback to the next part (dot based) in the subscription key
--subscribe-to — subscribe to the specified subscription server
--st — subscribe to the specified subscription server
--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 interval you set
--subscription-tolerance — set the tolerance for subscription servers
--unsubscribe-on-graceful-reload — force the unsubscribe request even during a 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 & ssl (handle with care bestie)

--snmp — enable the embedded snmp server
--snmp-community — set the snmp community string
--ssl-verbose — be verbose about SSL errors
--ssl-verify-depth — set the maximum certificate verification depth
--sni — add an SNI-governed SSL context
--sni-dir — check for cert/key/client_ca files in the directory you specify and create an sni/ssl context on demand
--sni-dir-ciphers — set the ssl ciphers for the sni-dir option
--ssl-enable3 — enable SSLv3 (insecure 🚨)
--ssl-enable-sslv3 — enable SSLv3 (insecure 🚨)
--ssl-enable-tlsv1 — enable TLSv1 (insecure 🚨)
--ssl-option — set a raw ssl option (numeric value)
--sni-regexp — add an SNI-governed SSL context (the key is a regexp)
--ssl-tmp-dir — store ssl-related temp files in the directory you specify

⭐ master checks, binaries & async

--check-interval — set the interval (in seconds) of master checks
--forkbomb-delay — sleep for the number of seconds you specify when a forkbomb is detected 💣
--binary-path — force the binary path
--privileged-binary-patch — patch the uwsgi binary with a new command (before privileges drop)
--unprivileged-binary-patch — patch the uwsgi binary with a new command (after privileges drop)
--privileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments (before privileges drop)
--unprivileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments (after privileges drop)
--async — enable async mode with the number of cores you specify
--max-fd — set the maximum number of file descriptors (requires root privileges)

🎀 logging (she's a talker and we love her)

--logto — set the logfile/udp address
--logto2 — log to the specified file or udp address after privileges drop
--log-format — set an advanced format for request logging
--logformat — set advanced format for request logging
--logformat-strftime — apply strftime to logformat output
--log-format-strftime — apply strftime to logformat output
--logfile-chown — chown logfiles
--logfile-chmod — chmod logfiles
--log-syslog — log to syslog
--log-socket — send logs to the specified socket
--req-logger — set/append a request logger
--logger-req — set/append a request logger
--logger — set/append a logger
--logger-list — list enabled loggers
--loggers-list — list enabled loggers
--threaded-logger — offload log writing to a thread 🧵
--log-encoder — add an item in the log encoder chain
--log-req-encoder — add an item in the log req encoder chain
--log-drain — drain (a.k.a. do not show) log lines matching the regexp you give
--log-filter — show ONLY log lines matching the specified regexp
--log-route — log to the named logger you specify if the regexp applied on the logline matches
--log-req-route — log requests to the named logger you specify if the regexp applied on the logline matches

💅 last lil bits of this part

--use-abort — call abort() on segfault/fpe, could be useful for generating a core dump
--alarm — create a new alarm, syntax: <alarm> <plugin:args>

okay that was a LOT but you ate that, bestie 💖 more coming, don't go anywhere 🫶

okay bestie we're deep in the option swamp now and it is ✨giving✨ — alarms, logging, routes, the whole little ecosystem. buckle up 🎀

<h2>🚨 the alarm era 🚨</h2>

--alarm-cheap — don't spin up a whole dedicated thread squad for your curl-based alarms, just reuse the main alarm thread. lowkey efficient 💅
--alarm-freq — tunes the anti-loop alarm system. default is 3 seconds.
--alarm-fd — fires off the alarm you name whenever an fd gets read. by default it reads 1 byte, but set it to 8 if you're dealing with eventfd.
--alarm-segfault — raise the specified alarm when the segmentation fault handler runs. 😭 (yes, that handler)
--segfault-alarm — same exact vibe as --alarm-segfault: raise the specified alarm when the segmentation fault handler is executed.
--alarm-backlog — raise the specified alarm when the socket backlog queue is full. she's at capacity bestie 🫣
--backlog-alarm — raise the specified alarm when the socket backlog queue is full.
--lq-alarm — raise the specified alarm when the socket backlog queue is full.
--alarm-lq — raise the specified alarm when the socket backlog queue is full.
--alarm-listen-queue — raise the specified alarm when the socket backlog queue is full.
--listen-queue-alarm — raise the specified alarm when the socket backlog queue is full. (six names for one behaviour? iconic, honestly 👑)
--log-alarm — raise the specified alarm when a log line matches the given regexp. syntax: <alarm>[,alarm...] <regexp>
--alarm-log — raise the specified alarm when a log line matches the given regexp. syntax: <alarm>[,alarm...] <regexp>
--not-log-alarm — the opposite energy: skip the specified alarm when a log line matches the given regexp. syntax: <alarm>[,alarm...] <regexp>
--not-alarm-log — skip the specified alarm when a log line matches the given regexp. syntax: <alarm>[,alarm...] <regexp>
--alarm-list — list every enabled alarm. window shopping ✨
--alarms-list — list enabled alarms.
--alarm-msg-size — caps how big an alarm message can get. default is 8192.

<h2>📝 logging, my beloved 📝</h2>

--log-master — hand the whole logging job over to the master process.
--log-master-bufsize — set the buffer size for the master logger. heads up: chonkier log messages than that will get truncated 💀
--log-master-stream — make the master logpipe a SOCK_STREAM.
--log-master-req-stream — make the master requests logpipe a SOCK_STREAM.
--log-reopen — reopen the log after a reload. fresh start energy 🌸
--log-truncate — truncate the log on startup.
--log-maxsize — set the maximum logfile size.
--log-backupname — set what the logfile gets named after rotation.
--logdate — prefix logs with a date, or with a strftime string.
--log-date — prefix logs with a date, or with a strftime string.
--log-prefix — prefix logs with a string.
--log-zero — log responses that have no body.
--log-slow — log any request slower than the number of milliseconds you give it. 🐌 noticed
--log-4xx — log requests that came back 4xx.
--log-5xx — log requests that came back 5xx.
--log-big — log requests bigger than the specified size.
--log-sendfile — log sendfile requests.
--log-ioerror — log requests that hit io errors.
--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.

<h2>🔐 privileges, cwd & shells 🔐</h2>

--master-as-root — leave the master process running as root. (yes it does what it says, be careful bestie)
--drop-after-init — run the privileges drop after plugin initialization. superseded by drop-after-apps.
--drop-after-apps — run the privileges drop after apps loading. superseded by master-as-root.
--force-cwd — force the initial working directory to the value you give it.
--binsh — override /bin/sh (this is what exec hooks use; it always falls back to /bin/sh).
--chdir — chdir to the specified directory before apps loading.
--chdir2 — chdir to the specified directory after apps loading.

<h2>😴 lazy, cheap & cheaper modes 😴</h2>

--lazy — set lazy mode (load apps in workers instead of master).
--lazy-apps — load apps in each worker instead of the master.
--cheap — set cheap mode (spawn workers only after the first request).
--cheaper — set cheaper mode (adaptive process spawning).
--cheaper-initial — set the initial number of processes to spawn in cheaper mode.
--cheaper-algo — choose which algorithm gets used for adaptive process spawning.
--cheaper-step — how many additional processes to spawn at each overload.
--cheaper-overload — increase workers after the specified overload.
--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. 🫶 boundaries
--cheaper-rss-limit-hard — if total workers resident memory usage is higher, try to stop workers.
--idle — set idle mode (put uWSGI in cheap mode after inactivity).
--die-on-idle — shut uWSGI down when it's idle. dramatic exit, love that for her 💅

<h2>🧵 mounting & threads 🧵</h2>

--mount — load an application under a mountpoint.
--worker-mount — load an application under a mountpoint in the specified worker, or after workers spawn.
--threads — run each worker in prethreaded mode with the specified number of threads.
--thread-stacksize — set threads stacksize.
--threads-stacksize — set threads stacksize.
--thread-stack-size — set threads stacksize.
--threads-stack-size — set threads stacksize. (four spellings, one destiny ✨)

<h2>🏠 virtualhosting 🏠</h2>

--vhost — enable virtualhosting mode (based on the SERVER_NAME variable).
--vhost-host — enable virtualhosting mode (based on the HTTP_HOST variable).

<h2>🛣️ routing era, part one: the regular routes 🛣️</h2>

--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).
--route-if — add a route based on a condition.
--route-if-not — add a route based on a condition (the negate version). 🙃
--route-run — always run the specified route action.

<h2>🏁 final routes 🏁</h2>

--final-route — add a final route.
--final-route-status — add a final route for the specified status.
--final-route-host — add a final route based on 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 specified final route action.

<h2>💥 error routes 💥</h2>

--error-route — add an error route.
--error-route-status — add an error route for the specified status.
--error-route-host — add an error route based on 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 specified error route action.

<h2>📬 response routes 📬</h2>

--response-route — add a response route.
--response-route-status — add a response route for the specified status.
--response-route-host — add a response route based on 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 specified response route action.

<h2>🧭 routers & error pages 🧭</h2>

--router-list — list enabled routers.
--routers-list — list 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.

<h2>🦋 websockets & chunked input 🦋</h2>

--websockets-ping-freq — set the frequency (in seconds) of the websockets automatic ping packets.
--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.
--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).
--chunked-input-limit — set the max size of a chunked input part (default 1MB, in bytes).
--chunked-input-timeout — set the default timeout for chunked input.

<h2>⏰ clocks ⏰</h2>

--clock — set a clock source.
--clock-list — list enabled clocks.

okay bestie, deep breath, we're in the final stretch of the option list and it is long, but you've got this and I've got you 💖 buckle up:

--clocks-list — lists all the enabled clocks ⏰ like a little roll call for time itself
--add-header — auto-slaps HTTP headers onto the response, no manual labor required 💅
--rem-header — auto-yeets the HTTP header you specify right out of the response
--del-header — same energy, auto-removes the HTTP header you name from the response 🫶
--collect-header — stashes the response header you name into a request var (syntax: header var)
--response-header-collect — literally the same thing: stash the named response header in a request var (syntax: header var)
--pull-header — stashes the named response header in a request var and rips it out of the response (syntax: header var) 🙈
--check-static — looks for static files in the directory you point at
--check-static-docroot — looks for static files in the requested DOCUMENT_ROOT
--static-check — yep, looks for static files in the directory you gave it
--static-map — maps a mountpoint to a static directory (or a single file)
--static-map2 — like static-map but it fully appends the requested resource onto the docroot
--static-skip-ext — skips that specific extension when it's doing static file checks
--static-index — if someone requests a directory, it goes hunting for the file you specified
--static-safe — skips the security checks when the file lives under the path you named
--static-cache-paths — drops resolved paths into the uWSGI cache for however many seconds you say
--static-cache-paths-name — uses the cache you picked 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 it's the twin ✨
--static-expires-type — sets the Expires header based on content type
--static-expires-type-mtime — sets the Expires header based on content type and file mtime
--static-expires — sets the Expires header based on filename regexp
--static-expires-mtime — sets the Expires header based on filename regexp and file mtime
--static-expires-uri — sets the Expires header based on REQUEST_URI regexp
--static-expires-uri-mtime — sets the Expires header based on REQUEST_URI regexp and file mtime
--static-expires-path-info — sets the Expires header based on PATH_INFO regexp
--static-expires-path-info-mtime — sets the Expires header based on PATH_INFO regexp and file mtime
--static-gzip — if your regexp matches the static file translation, it'll go look for a gzip version 🗜️
--static-gzip-all — checks for a gzip version of every requested static file, no exceptions
--static-gzip-dir — checks for a gzip version of all requested static files in the dir/prefix you gave
--static-gzip-prefix — also checks for a gzip version of all requested static files in the specified dir/prefix
--static-gzip-ext — checks for a gzip version of all requested static files with the ext/suffix you set
--static-gzip-suffix — again: checks for a gzip version of all requested static files with the specified ext/suffix
--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) 🧵
--file-serve-mode — sets the static file serving mode
--fileserve-mode — sets the static file serving mode (same fit, different spelling)
--disable-sendfile — kills sendfile() and makes it rely on the extremely boring 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)

static files? handled. headers? handled. we're so back 🦋

--mode — sets a uWSGI custom mode
--env — sets an environment variable
--envdir — loads a daemontools compatible envdir
--early-envdir — loads a daemontools compatible envdir ASAP ⚡
--unenv — unsets an environment variable (the breakup option)
--vacuum — tries to remove all of the generated file/sockets, Marie Kondo style 🧹
--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 named
--cgroup-opt — sets a value in the cgroup option you named
--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 named inside your namespace
--ns — runs in a new namespace under the specified rootfs (short king 👑)
--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 a socket (BSD only 🌊)
--tcp-fast-open — enables the TCP_FASTOPEN flag on TCP sockets with the qlen value you give
--tcp-fastopen — enables the TCP_FASTOPEN flag on TCP sockets with the 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 (no shame in a plan B)
--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 named
--cron-legion — adds a cron task runnable only when the instance is a lord of the specified legion
--unique-legion-cron — adds a unique cron task runnable only when the instance is a lord of the specified legion
--unique-cron-legion — adds a unique cron task runnable only when the instance is a lord of the specified legion
--loop — selects the uWSGI loop engine 🔁
--loop-list — lists the enabled loop engines
--loops-list — lists the enabled loop engines (plural girlies, same answer)

daemons, plugins, and the grand finale, let's gooo 💅

--worker-exec — runs the command you specify as a worker
--worker-exec2 — runs the specified command as a worker (after the post_fork hook)
--attach-daemon — attaches a command/daemon to the master process ⚠️ the command has to not go in background
--attach-control-daemon — attaches a command/daemon to the master process (again, the command has to not go in background), and when the daemon dies, the master dies too 😭 ride or die fr
--smart-attach-daemon — attaches a command/daemon to the master process managed by a pidfile (this time the command has to daemonize)
--smart-attach-daemon2 — attaches a command/daemon to the master process managed by a pidfile (and here the command has to NOT daemonize — opposite day)
--legion-attach-daemon — same as --attach-daemon but the daemon runs only on a legion lord node
--legion-smart-attach-daemon — same as --smart-attach-daemon but it runs only on a legion lord node
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2 but it runs only on a legion lord node
--daemons-honour-stdin — does not change the stdin of external daemons to /dev/null (respecting their little stdin, cute)
--attach-daemon2 — the attach-daemon keyval variant (supports smart modes too)
--plugins — loads uWSGI plugins 🧩
--plugin — loads uWSGI plugins
--need-plugins — loads uWSGI plugins (and exits on error, no half measures)
--need-plugin — loads uWSGI plugins (exit on error)
--plugins-dir — adds a directory to the uWSGI plugin search path
--plugin-dir — adds a directory to the uWSGI plugin search path
--plugins-list — lists the enabled plugins
--plugin-list — lists the enabled plugins
--autoload — tries to automatically load plugins when it bumps into unknown options
--dlopen — blindly loads a shared library 🙈 (it does not ask questions)
--allowed-modifiers — a comma separated list of allowed modifiers
--remap-modifier — remaps a request modifier from one id to another
--dump-options — dumps the full list of every available option (yes, all of them, all 40-million 🫠)
--show-config — shows the current config reformatted as ini
--binary-append-data — returns the content of a resource to stdout for appending to a uwsgi binary (for data:// usage)
--print — a simple print
--iprint — a simple print, but the immediate version ⚡
--exit — forces exit() of the instance, dramatic exit, door slam, periodt
--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 list bestie, we ATE 🍓 every single flag survived the vibe check, nothing dropped, nothing merged, no cap.

this page is uwsgi_emperor_pg, version 2.0.31-debian, dated July 2026, living in section UWSGI_EMPEROR_PG(1) — and with that, the manual is officially over. go forth and serve some static files, you absolute icon 💖✨🎀

📦 where this page comes from

ubuntu stonking: uwsgi-plugin-emperor-pg 2.0.31-6build1 · GPL-2.0-only
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-11-02: a language model's rewrite of the original, under its terms