UWSGI_PHP(1)

📦

version 2.0.31+2+0.0.15build9 · 5 versions

2.0.31+2+0.0.15build9 · ubuntu resolute, ubuntu stonking (latest)
2.0.29+1build1+0.0.15build8 · ubuntu questing
2.0.23+1build2+0.0.15build4 · ubuntu noble
2.0.21+4+0.0.15 · debian bookworm
2.0.28+1+0.0.15+b6 · debian trixie

okay so bestie, you typed man uwsgi_php and the terminal handed you the UWSGI_PHP(1) page, filed under User Commands. it is six parts long. we are doing part one together, holding hands, nobody gets left behind. 🫶

✨ NAME ✨

uwsgi_php — a fast (pure C), self-healing, developer-friendly WSGI server. that's it. that's the whole name section. and honestly? iconic. 💅

✨ SYNOPSIS ✨

uwsgi-core [options...]

✨ DESCRIPTION ✨

so here's the tea: the DESCRIPTION on this page is literally just the options list. every single one of them. so we're going through all of them, in order, no skipping, because i love you and i want you to actually know your server. 💖

🎀 the options, all of them, in order 🎀

-s, --socket — bind to the specified UNIX/TCP socket using the default protocol ✨
-s, --uwsgi-socket — bind to the specified UNIX/TCP socket, but speaking the uwsgi protocol
--suwsgi-socket — bind to the specified UNIX/TCP socket, uwsgi protocol over SSL 🔒
--ssl-socket — bind to the specified UNIX/TCP socket, uwsgi protocol over SSL (yes, twin descriptions, they're twins)
--http-socket — bind to the specified UNIX/TCP socket using the HTTP protocol
--http-socket-modifier1 — force the modifier1 you give it when using the HTTP protocol
--http-socket-modifier2 — force the modifier2 you give it when using the HTTP protocol
--http11-socket — bind to the specified UNIX/TCP socket using the HTTP 1.1 (Keep-Alive) protocol
--https-socket — bind to the specified UNIX/TCP socket using the HTTPS protocol 🔐
--https-socket-modifier1 — force the specified modifier1 when using the HTTPS protocol
--https-socket-modifier2 — force the specified modifier2 when using the HTTPS protocol
--fastcgi-socket — bind to the specified UNIX/TCP socket using the FastCGI protocol
--fastcgi-nph-socket — bind to the specified UNIX/TCP socket using the FastCGI protocol (nph mode)
--fastcgi-modifier1 — force the specified modifier1 when using the FastCGI protocol
--fastcgi-modifier2 — force the specified modifier2 when using the FastCGI protocol
--scgi-socket — bind to the specified UNIX/TCP socket using the SCGI protocol
--scgi-nph-socket — bind to the specified UNIX/TCP socket using the SCGI protocol (nph mode)
--scgi-modifier1 — force the specified modifier1 when using the SCGI protocol
--scgi-modifier2 — force the specified modifier2 when using the SCGI protocol
--raw-socket — bind to the specified UNIX/TCP socket using the RAW protocol
--raw-modifier1 — force the specified modifier1 when using the RAW protocol
--raw-modifier2 — force the specified modifier2 when using the RAW protocol
--puwsgi-socket — bind to the specified UNIX/TCP socket using the persistent uwsgi protocol (puwsgi)
--protocol — force the specified protocol for default sockets
--socket-protocol — force the specified protocol for default sockets (twins again, we love consistency)
--shared-socket — create a shared socket for advanced jailing or ipc
--undeferred-shared-socket — create a shared socket for advanced jailing or ipc (undeferred mode)
-p, --processes — spawn the specified number of workers/processes
-p, --workers — spawn the specified number of workers/processes (same short flag, same job, same slay)
--thunder-lock — serialize accept() usage (if possible) ⚡
-t, --harakiri — set the harakiri timeout 🔪
--harakiri-verbose — enable verbose mode for harakiri
--harakiri-graceful-timeout — the interval between a graceful harakiri attempt and a sigkill
--harakiri-graceful-signal — use this signal instead of sigterm for graceful harakiri attempts
--harakiri-queue-threshold — only trigger harakiri if the queue is greater than this threshold
--harakiri-no-arh — do not enable harakiri during after-request-hook
--no-harakiri-arh — do not enable harakiri during after-request-hook
--no-harakiri-after-req-hook — do not enable harakiri during after-request-hook (three aliases, one vibe)
--backtrace-depth — set the backtrace depth
--mule-harakiri — set the harakiri timeout for mule tasks
-x, --xmlconfig — load config from an xml file
-x, --xml — load config from an xml file
--config — load configuration using the pluggable system
--fallback-config — re-exec uwsgi with the specified config when the exit code is 1
--strict — enable strict mode (placeholder cannot be used) ⚠️
--skip-zero — skip the check of file descriptor 0
--skip-atexit — skip atexit hooks (ignored by the master)
--skip-atexit-teardown — skip atexit teardown (ignored by the master)
-S, --set — set a placeholder or an option
--set-placeholder — set a placeholder
--set-ph — set a placeholder
--get — print the specified option value and exit
--declare-option — declare a new uWSGI custom option
--declare-option2 — declare a new uWSGI custom option (non-immediate)
--resolve — place the result of a dns query in the specified placeholder, sytax: placeholder=name (immediate option)
--for — (opt logic) for cycle
--for-glob — (opt logic) for cycle (expand glob)
--for-times — (opt logic) for cycle (expand the specified num to a list starting from 1)
--for-readline — (opt logic) for cycle (expand the specified file to a list of lines)
--endfor — (opt logic) end for cycle
--end-for — (opt logic) end for cycle
--if-opt — (opt logic) check for option
--if-not-opt — (opt logic) check for option
--if-env — (opt logic) check for environment variable
--if-not-env — (opt logic) check for environment variable
--ifenv — (opt logic) check for environment variable
--if-reload — (opt logic) check for reload
--if-not-reload — (opt logic) check for reload
--if-hostname — (opt logic) check for hostname
--if-not-hostname — (opt logic) check for hostname
--if-hostname-match — (opt logic) try to match the hostname against a regular expression
--if-not-hostname-match — (opt logic) try to match the 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
--ignore-sigpipe — do not report (annoying) SIGPIPE
--ignore-write-errors — do not report (annoying) write()/writev() errors
--write-errors-tolerance — set the maximum number of allowed write errors (default: no tolerance)
--write-errors-exception-only — only raise an exception on write errors, giving control to the app itself
--disable-write-exception — disable exception generation on write()/writev()
--inherit — use the specified file as 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
--daemonize2 — daemonize uWSGI after app loading
--stop — stop an instance
--reload — reload an instance
--pause — pause an instance
--suspend — suspend an instance
--resume — resume an instance
--connect-and-read — connect to a socket and wait for data from it
--extract — fetch/dump any supported address to stdout
-l, --listen — set the socket listen queue size
-v, --max-vars — set the amount of internal iovec/vars structures
--max-apps — set the maximum number of per-worker applications
-b, --buffer-size — set internal buffer size
-m, --memory-report — enable memory report
--profiler — enable the specified profiler
-c, --cgi-mode — force CGI-mode for plugins supporting it
-a, --abstract-socket — force UNIX socket in abstract mode (Linux only)
-C, --chmod-socket — chmod-socket
-C, --chmod — chmod-socket
--chown-socket — chown unix sockets
--umask — set umask
--freebind — put socket in freebind mode
--map-socket — map sockets to specific workers
-T, --enable-threads — enable threads (stub option this is true by default)
--no-threads-wait — do not wait for threads cancellation on quit/reload
--auto-procname — automatically set 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
-M, --master — enable master process
--honour-stdin — do not remap stdin to /dev/null
--emperor — run the Emperor 👑
--emperor-proxy-socket — force the vassal to became an Emperor proxy
--emperor-wrapper — set a binary wrapper for vassals
--emperor-wrapper-override — set a binary wrapper for vassals to try before the default one
--emperor-wrapper-fallback — set a binary wrapper for vassals to try as a last resort
--emperor-nofollow — do not follow symlinks when checking for mtime
--emperor-procname — set the Emperor process name
--emperor-freq — set the Emperor scan frequency (default 3 seconds)
--emperor-required-heartbeat — set the Emperor tolerance about heartbeats
--emperor-curse-tolerance — set the Emperor tolerance about cursed vassals

and that's... not even the whole page, bestie. we are SO not done. part 2 is coming, drink some water, stretch your wrists. 🫶💖

--emperor-pidfile — drops the Emperor's pid into the file you name. Emperor bookkeeping, but make it cute ✨
--emperor-tyrant — puts the Emperor into Tyrant mode. Yes bestie, it's literally called that. 👑
--emperor-tyrant-nofollow — in Tyrant mode, don't follow symlinks when it's checking for uid/gid. No sneaky link-following, periodt.
--emperor-stats — spin up the Emperor stats server 📊
--emperor-stats-server — also spins up the Emperor stats server. Same energy, different spelling. 💅
--early-emperor — spawn the emperor as soon as possible. No waiting around, she's got places to be.
--emperor-broodlord — run the emperor in BroodLord mode. The lore is real, iykyk.
--emperor-throttle — set the throttling level, in milliseconds, for vassals that are behaving badly. Default is 1000. Naughty vassals get timed out 🫶
--emperor-max-throttle — the max throttling level, in milliseconds, for bad-behaving vassals. Default is 3 minutes. Yes, three whole minutes of timeout. 😭
--emperor-magic-exec — prefixes vassals' config files with exec:// if they have the executable bit set. Magic ✨ literally in the name.
--emperor-on-demand-extension — search for a text file named vassal name + extension that contains the on-demand socket name.
--emperor-on-demand-ext — same thing, shorter name: search for a text file (vassal name + extension) containing the on-demand socket name.
--emperor-on-demand-directory — turns on on-demand mode, binding to the unix socket in the directory you specify, named like the vassal + .socket.
--emperor-on-demand-dir — the short version of the above: on-demand mode, unix socket in the specified directory, named vassal + .socket.
--emperor-on-demand-exec — use 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 the extension you specify (the vassal gets called with --config).
--emperor-extra-ext — same deal, abbreviated: allow the specified extension in the Emperor, and the vassal gets called with --config.
--emperor-no-blacklist — turns the Emperor blacklisting subsystem all the way off 🚫
--emperor-use-clone — use clone() instead of fork(), passing the unshare() flags you specify.
--emperor-graceful-shutdown — vassals get a graceful shutdown during ragnarok. Yes, ragnarok. We don't make the rules. 🔥
--emperor-cap — set vassals capability.
--vassals-cap — set vassals capability. (Same thing, another alias, bestie.)
--vassal-cap — set vassals capability. Third one. She's thorough.
--imperial-monitor-list — list the enabled imperial monitors 📋
--imperial-monitors-list — list the enabled imperial monitors (plural version, same list).
--vassals-inherit — add config templates to vassals' config (it uses --inherit).
--vassals-include — include config templates into vassals' config (it uses --include instead of --inherit).
--vassals-inherit-before — add config templates to vassals' config using --inherit, and it parses them before the vassal file.
--vassals-include-before — include config templates into vassals' config using --include instead of --inherit, and it parses them before the vassal file.
--vassals-start-hook — run the command you specify before each vassal starts 🏁
--vassals-stop-hook — run the specified command after a vassal's death. RIP little vassal 🕯️
--vassal-sos — the vassal asks the emperor for reinforcements when it's overloaded. SOS bestie!! 🆘
--vassal-sos-backlog — ask the emperor for an SOS if the backlog queue has more items than the value you specify.
--vassals-set — automatically set the option you specify (via --set) for every single vassal.
--vassal-set — same thing, singular spelling: automatically set the specified option via --set for every vassal.
--heartbeat — announce healthiness to the emperor. Just letting her know we're thriving 💖
--reload-mercy — the maximum time, in seconds, that we wait for workers and other processes to die during reload/shutdown.
--worker-reload-mercy — the maximum time, in seconds, a worker can take to reload/shutdown. Default is 60.
--mule-reload-mercy — the maximum time, in seconds, a mule can take to reload/shutdown. Default is 60.
--exit-on-reload — force exit even if a reload was requested.
--die-on-term — exit instead of doing a brutal reload on SIGTERM.
--force-gateway — force the spawn of the first registered gateway without a master.
-h|--help — show this help.
-h|--usage — show this help. (Yes, -h is listed twice. That's just how she is.)
--print-sym — print the content of the binary symbol you specify.
--print-symbol — print the content of the specified binary symbol.
-r|--reaper — call waitpid(-1,...) after each request to get rid of zombies 🧟 No zombie apocalypse on our watch.
-R|--max-requests — reload workers after the specified amount of managed requests.
--max-requests-delta — add (worker_id * delta) to the max_requests value of each worker.
--min-worker-lifetime — the number of seconds a worker has to run before it can be reloaded. Default is 10.
--max-worker-lifetime — reload workers after the specified number of seconds. Default is disabled.
--max-worker-lifetime-delta — add (worker_id * delta) seconds to the max_worker_lifetime value of each worker.
-z|--socket-timeout — set the internal sockets timeout.
--no-fd-passing — disable file descriptor passing.
--locks — create the specified number of shared locks 🔒
--lock-engine — set the lock engine.
--ftok — set the ipcsem key via ftok() so you avoid duplicates.
--persistent-ipcsem — don't remove ipcsem's on shutdown. They stay. Iconic clingy behaviour.
-A|--sharedarea — create a raw shared memory area of the specified number of pages. Note: it supports keyval too 💅
--safe-fd — do not close the file descriptor you specify.
--fd-safe — do not close the specified file descriptor. (Same thing, flipped name, we love consistency /j)
--cache — create a shared cache containing the given elements.
--cache-blocksize — set the cache blocksize.
--cache-store — enable persistent cache to disk 💾
--cache-store-sync — set the sync frequency for the persistent cache.
--cache-no-expire — disable the auto sweep of expired items.
--cache-expire-freq — set how often the cache sweeper scans. Default is 3 seconds.
--cache-report-freed-items — constantly report the cache items freed by the sweeper. > Use this only for debug, bestie, it's chatty.
--cache-udp-server — bind the cache UDP server (used only for set/update/delete) to the socket you specify.
--cache-udp-node — send cache update/deletion to the cache UDP server you specify.
--cache-sync — copy the entire content of another uWSGI cache server on server startup.
--cache-use-last-modified — update the last_modified_at timestamp on every cache item modification. Default is disabled.
--add-cache-item — add an item in the cache.
--load-file-in-cache — load a static file into the cache.
--load-file-in-cache-gzip — load a static file into the cache, with gzip compression.
--cache2 — create a new-generation shared cache (keyval syntax).
--queue — enable the shared queue.
--queue-blocksize — set the queue blocksize.
--queue-store — enable persistent queue to disk.
--queue-store-sync — set the sync frequency for the persistent queue.
-Q|--spooler — run a spooler on the directory you specify 📂
--spooler-external — map spooler requests to a spooler directory managed by an external instance.
--spooler-ordered — try to order the execution of spooler tasks.
--spooler-chdir — chdir() to the specified directory before each spooler task.
--spooler-processes — set the number of processes for spoolers.
--spooler-quiet — don't be verbose about spooler tasks 🤫
--spooler-max-tasks — the maximum number of tasks to run before recycling a spooler.
--spooler-harakiri — set the harakiri timeout for spooler tasks.
--spooler-frequency — set the spooler frequency.
--spooler-freq — set the spooler frequency. (Short version, same vibe.)
--mule — add a mule.
--mules — add the specified number of mules.
--farm — add a mule farm. Mules with friends 🐴
--mule-msg-size — set the mule message buffer size.
--signal — send a uWSGI signal to a server.
--signal-bufsize — set the buffer size for the signal queue.
--signals-bufsize — set the buffer size for the signal queue. (Plural edition.)
--signal-timer — add a timer. Syntax: <signal> <seconds>.
--timer — add a timer. Syntax: <signal> <seconds>. ⏰
--signal-rbtimer — add a redblack timer. Syntax: <signal> <seconds>.
--rbtimer — add a redblack timer. Syntax: <signal> <seconds>.
--rpc-max — maximum number of rpc slots. Default is 64.
-L|--disable-logging — disable request logging. Silence, but make it fashion.
--flock — lock the file you specify before starting, and exit if it's locked.
--flock-wait — lock the specified file before starting, and wait if it's locked.
--flock2 — lock the specified file after logging/daemon setup, and exit if it's locked.
--flock-wait2 — lock the specified file after logging/daemon setup, and wait if it's locked.
--pidfile — create a pidfile (before privileges drop).
--pidfile2 — create a pidfile (after privileges drop).
--safe-pidfile — create a safe pidfile (before privileges drop).
--safe-pidfile2 — create a safe pidfile (after privileges drop).
--chroot — chroot() to the directory you specify.
--pivot-root — pivot_root() to the directories you specify. new_root and put_old must be separated with a space.
--pivot_root — pivot_root() to the specified directories. Again: new_root and put_old must be separated by a space.
--uid — setuid to the specified user/uid.
--gid — setgid to the specified group/gid.
--add-gid — add the specified group id to the process credentials.
--immediate-uid — setuid to the specified user/uid IMMEDIATELY. No chill, right now 🏃‍♀️
--immediate-gid — setgid to the specified group/gid IMMEDIATELY.
--no-initgroups — disable the additional groups that get set via initgroups().
--cap — set process capability.
--unshare — unshare() part of the processes and put them in a new namespace.
--unshare2 — unshare() part of the processes and put them in a new namespace, but after the rootfs change.
--setns-socket — expose a unix socket that returns namespace fds from /proc/self/ns.
--setns-socket-skip — skip the specified entry when sending setns file descriptors.
--setns-skip — skip the specified entry when sending setns file descriptors. (Shorter spelling, same skip.)
--setns — join a namespace that was created by an external uWSGI instance.
--setns-preopen — open /proc/self/ns as soon as possible and cache the fds. Speedy ✨
--jailed — mark the instance as jailed (force the execution of post_jail hooks) 💅
--refork — fork() again after privileges drop. useful for jailing systems 🦋
--re-fork — fork() again after privileges drop. useful for jailing systems ✨
--refork-as-root — fork() again before privileges drop. useful for jailing systems 💖
--re-fork-as-root — fork() again before privileges drop. useful for jailing systems 🫶
--refork-post-jail — fork() again after jailing. useful for jailing systems 🌸
--re-fork-post-jail — fork() again after jailing. useful for jailing systems 🎀
--hook-asap — run the specified hook as soon as possible ⚡
--hook-pre-jail — run the specified hook before jailing 🔒
--hook-post-jail — run the specified hook after jailing 🔓
--hook-in-jail — run the specified hook in jail after initialization 🏠
--hook-as-root — run the specified hook before privileges drop 👑
--hook-as-user — run the specified hook after privileges drop 🙋
--hook-as-user-atexit — run the specified hook before app exit and reload 🚪
--hook-pre-app — run the specified hook before app loading 📦
--hook-post-app — run the specified hook after app loading 📬
--hook-post-fork — run the specified hook after each fork 🍴
--hook-accepting — run the specified hook after each worker enter the accepting phase 🎧
--hook-accepting1 — run the specified hook after the first worker enters the accepting phase 1️⃣
--hook-accepting-once — run the specified hook after each worker enter the accepting phase (once per-instance) 🔂
--hook-accepting1-once — run the specified hook after the first worker enters the accepting phase (once per instance) ☝️
--hook-master-start — run the specified hook when the Master starts 👑
--hook-touch — run the specified hook when the specified file is touched (syntax: <file> <action>) 👆
--hook-emperor-start — run the specified hook when the Emperor starts 🏁
--hook-emperor-stop — run the specified hook when the Emperor send a stop message 🛑
--hook-emperor-reload — run the specified hook when the Emperor send a reload message 🔄
--hook-emperor-lost — run the specified hook when the Emperor connection is lost 💔
--hook-as-vassal — run the specified hook before exec()ing the vassal 🧚
--hook-as-emperor — run the specified hook in the emperor after the vassal has been started 👑
--hook-as-mule — run the specified hook in each mule 🐴
--hook-as-gateway — run the specified hook in each gateway 🌐
--after-request-hook — run the specified function/symbol after each request 🪝
--after-request-call — run the specified function/symbol after each request 📞
--exec-asap — run the specified command as soon as possible ⚡
--exec-pre-jail — run the specified command before jailing 🔒
--exec-post-jail — run the specified command after jailing 🔓
--exec-in-jail — run the specified command in jail after initialization 🏠
--exec-as-root — run the specified command before privileges drop 👑
--exec-as-user — run the specified command after privileges drop 🙋
--exec-as-user-atexit — run the specified command before app exit and reload 🚪
--exec-pre-app — run the specified command before app loading 📦
--exec-post-app — run the specified command after app loading 📬
--exec-as-vassal — run the specified command before exec()ing the vassal 🧚
--exec-as-emperor — run the specified command in the emperor after the vassal has been started 👑
--mount-asap — mount filesystem as soon as possible ⚡
--mount-pre-jail — mount filesystem before jailing 🔒
--mount-post-jail — mount filesystem after jailing 🔓
--mount-in-jail — mount filesystem in jail after initialization 🏠
--mount-as-root — mount filesystem before privileges drop 👑
--mount-as-vassal — mount filesystem before exec()ing the vassal 🧚
--mount-as-emperor — mount filesystem in the emperor after the vassal has been started 👑
--umount-asap — unmount filesystem as soon as possible ⚡
--umount-pre-jail — unmount filesystem before jailing 🔒
--umount-post-jail — unmount filesystem after jailing 🔓
--umount-in-jail — unmount filesystem in jail after initialization 🏠
--umount-as-root — unmount filesystem before privileges drop 👑
--umount-as-vassal — unmount filesystem before exec()ing the vassal 🧚
--umount-as-emperor — unmount filesystem in the emperor after the vassal has been started 👑
--wait-for-interface — wait for the specified network interface to come up before running root hooks 📡
--wait-for-interface-timeout — set the timeout for wait-for-interface ⏳
--wait-interface — wait for the specified network interface to come up before running root hooks 📶
--wait-interface-timeout — set the timeout for wait-for-interface ⏳
--wait-for-iface — wait for the specified network interface to come up before running root hooks 🌐
--wait-for-iface-timeout — set the timeout for wait-for-interface ⏳
--wait-iface — wait for the specified network interface to come up before running root hooks 📶
--wait-iface-timeout — set the timeout for wait-for-interface ⏳
--wait-for-fs — wait for the specified filesystem item to appear before running root hooks 📁
--wait-for-file — wait for the specified file to appear before running root hooks 📄
--wait-for-dir — wait for the specified directory to appear before running root hooks 📂
--wait-for-mountpoint — wait for the specified mountpoint to appear before running root hooks 🗂️
--wait-for-fs-timeout — set the timeout for wait-for-fs/file/dir ⏳
--wait-for-socket — wait for the specified socket to be ready before loading apps 🔌
--wait-for-socket-timeout — set the timeout for wait-for-socket ⏳
--call-asap — call the specified function as soon as possible ⚡
--call-pre-jail — call the specified function before jailing 🔒
--call-post-jail — call the specified function after jailing 🔓
--call-in-jail — call the specified function in jail after initialization 🏠
--call-as-root — call the specified function before privileges drop 👑
--call-as-user — call the specified function after privileges drop 🙋
--call-as-user-atexit — call the specified function before app exit and reload 🚪
--call-pre-app — call the specified function before app loading 📦
--call-post-app — call the specified function after app loading 📬
--call-as-vassal — call the specified function() before exec()ing the vassal 🧚
--call-as-vassal1 — call the specified function(char *) before exec()ing the vassal 🧚
--call-as-vassal3 — call the specified function(char *, uid_t, gid_t) before exec()ing the vassal 🧚
--call-as-emperor — call the specified function() in the emperor after the vassal has been started 👑
--call-as-emperor1 — call the specified function(char *) in the emperor after the vassal has been started 👑
--call-as-emperor2 — call the specified function(char *, pid_t) in the emperor after the vassal has been started 👑
--call-as-emperor4 — call the specified function(char *, pid_t, uid_t, gid_t) in the emperor after the vassal has been started 👑
--ini — load config from ini file 📄
-y, --yaml — load config from yaml file 📄
-y, --yml — load config from yaml file 📄
-j, --json — load config from json file 📄
-j, --js — load config from json file 📄
--weight — weight of the instance (used by clustering/lb/subscriptions) ⚖️
--auto-weight — set weight of the instance (used by clustering/lb/subscriptions) automatically 🤖
--no-server — force no-server mode 🚫
--command-mode — force command mode 💻
--no-defer-accept — <orange>disable deferred-accept on sockets</orange> 🚫
--tcp-nodelay — enable TCP NODELAY on each request 🚀
--so-keepalive — enable TCP KEEPALIVEs 💓
--so-send-timeout — set SO_SNDTIMEO ⏳
--socket-send-timeout — set SO_SNDTIMEO ⏳
--so-write-timeout — set SO_SNDTIMEO ⏳
--socket-write-timeout — set SO_SNDTIMEO ⏳
--socket-sndbuf — set SO_SNDBUF 📤
--socket-rcvbuf — set SO_RCVBUF 📥
--shutdown-sockets — force calling shutdown() in addition to close() when sockets are destroyed 🔌
--limit-as — limit processes address space/vsz 📏
--limit-nproc — limit the number of spawnable processes 🔢
--reload-on-as — reload if address space is higher than specified megabytes 🔁
--reload-on-rss — reload if rss memory is higher than specified megabytes 🔁
--evil-reload-on-as — force the master to reload a worker if its address space is higher than specified megabytes 😈
--evil-reload-on-rss — force the master to reload a worker if its rss memory is higher than specified megabytes 😈
--mem-collector-freq — set the memory collector frequency when evil reloads are in place 🧹
--reload-on-fd — reload if the specified file descriptor is ready 🔁
--brutal-reload-on-fd — brutal reload if the specified file descriptor is ready 💥
--ksm — enable Linux KSM 🐧
--pcre-jit — enable pcre jit (if available) ⚡
--never-swap — lock all memory pages avoiding swapping 🔒
--touch-reload — reload uWSGI if the specified file is modified/touched 👆
--touch-workers-reload — trigger reload of (only) workers if the specified file is modified/touched 👆
--touch-mules-reload — reload mules if the specified file is modified/touched 👆
--touch-spoolers-reload — reload spoolers if the specified file is modified/touched 👆
--touch-chain-reload — trigger chain reload if the specified file is modified/touched 👆
--touch-logrotate — trigger logrotation if the specified file is modified/touched 👆
--touch-logreopen — trigger log reopen if the specified file is modified/touched 👆
--touch-exec — run command when the specified file is modified/touched (syntax: file command) 👆
--touch-signal — ping a signal the moment the file you named gets modified/touched. syntax: file signal ✨
--fs-reload — when the filesystem object you point at changes, do a graceful reload 🦋
--fs-brutal-reload — same vibe, but make it brutal 💀 reload when that filesystem object changes
--fs-signal — raise a uwsgi signal when the specified filesystem object gets modified. syntax: file signal
--check-mountpoint — if a filesystem stops being reachable, the instance just destroys itself. Lowkey iconic for reliable Fuse management 🧚
--mountpoint-check — literally the same thing bestie: filesystem unreachable → instance destroyed. (reliable Fuse management energy)
--check-mount — yep, same again. filesystem gone = instance gone. Fuse management stay winning ✨
--mount-check — the fourth twin 👯 destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management)
--propagate-touch — the most over-engineering option ever for systems with flaky signal management 😭 no cap, that's what it says
--limit-post — cap the request body, periodt.
--no-orphans — workers get killed automatically if the master dies.

careful bestie — this one can be dangerous for availability 💀

--prio — set the priority of processes/threads 🎀
--cpu-affinity — set the cpu affinity (pin those babies down)
--post-buffering — set the size in bytes after which the body buffers to disk instead of memory
--post-buffering-bufsize — set the buffer size used for read() when you're in post buffering mode 📦
--body-read-warning — set how much memory allocation (in megabytes) is allowed for a request body before it starts printing a warning at you 🙈
--upload-progress — turn on creation of .json files in the directory you specify, while a file upload is happening ⭐
--no-default-app — do not fallback to the default app. no safety net, we're free 💅
--manage-script-name — automatically rewrites SCRIPT_NAME and PATH_INFO for you ✨
--ignore-script-name — ignore SCRIPT_NAME entirely 🙈
--catch-exceptions — report the exception as http output.

discouraged!! use only for testing, fr fr 🧪

--reload-on-exception — a worker raises an exception → that worker gets reloaded 🔄
--reload-on-exception-type — reload a worker when a specific exception type gets raised 🎯
--reload-on-exception-value — reload a worker when a specific exception value gets raised
--reload-on-exception-repr — reload a worker when a specific exception type+value (language-specific, iykyk) gets raised
--exception-handler — add an exception handler 🫶
--enable-metrics — turn on the metrics subsystem 📊
--metric — add a custom metric, make it yours 💖
--metric-threshold — add a metric threshold/alarm 🚨
--metric-alarm — add a metric threshold/alarm (same energy, different name)
--alarm-metric — add a metric threshold/alarm 🚨 (third twin, we love a trio)
--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 (yes, singular spelling, still the same deal)
--metric-dir-restore — restore last value taken from the metrics dir ✨
--metrics-no-cores — stop generating cores-related metrics 🚫
--udp — run the udp server on the address you give it 🌈
--stats — enable the stats server on the specified address 📈
--stats-server — enable the stats server on the specified address (identical twin moment)
--stats-http — prefix the stats server json output with http headers 🌐
--stats-minified — minify that statistics json output ✂️
--stats-min — minify statistics json output (same thing, shorter name, main character energy)
--stats-push — push the stats json to whatever 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 (plural, same vibe)
--stats-no-cores — disable generation of cores-related stats
--stats-no-metrics — do not include metrics in the stats output 🙅
--multicast — subscribe to the multicast group you name 📡
--multicast-ttl — set the multicast ttl
--multicast-loop — set multicast loop (default 1)
--master-fifo — enable the master fifo 🎀
--notify-socket — enable the notification socket 🔔
--subscription-notify-socket — set the notification socket for subscriptions
--legion — 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 — if one of the lord hooks fails, declare itself as a dead node for the number of seconds you specify 💀
--legion-skew-tolerance — set the clock skew tolerance of the legion subsystem (default 60 seconds) ⏱️
--legion-lord — action to call on Lord election 👑
--legion-unlord — action to call on Lord dismiss 👋
--legion-setup — action to call on legion setup 🛠️
--legion-death — action to call on legion death (shutdown of the instance) 💀
--legion-join — action to call on legion join (first time quorum is reached) 🎉
--legion-node-joined — action to call on a new node joining the legion 🫶
--legion-node-left — action to call when a node leaves the legion 🚪
--legion-quorum — set the quorum of a legion 🗳️
--legion-scroll — set the scroll of a legion 📜
--legion-scroll-max-size — set the max size of the legion scroll buffer
--legion-scroll-list-max-size — set the max size of the legion scroll list buffer
--subscriptions-sign-check — set the digest algorithm and certificate directory for the secured subscription system 🔐
--subscriptions-sign-check-tolerance — set the maximum tolerance (in seconds) of clock skew for the secured subscription system ⏳
--subscriptions-sign-skip-uid — skip the signature check for the 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 subscription server you specify 📬
--st — subscribe to the specified subscription server (the short one, so cute)
--subscribe — subscribe to the specified subscription server
--subscribe2 — subscribe to the specified subscription server using advanced keyval syntax ✨
--subscribe-freq — send the subscription announce at the interval you set ⏰
--subscription-tolerance — set 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 (handy 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 the maximum certificate verification depth 🔍
--sni — add an SNI-governed SSL context 🎀
--sni-dir — check for cert/key/client_ca file in the directory you specify, and create a sni/ssl context on demand ✨
--sni-dir-ciphers — set ssl ciphers for the sni-dir option 🔐
--ssl-enable3 — enable SSLv3

insecure!! we said what we said 💀

--ssl-enable-sslv3 — enable SSLv3

insecure again, bestie, be so serious 🙈

--ssl-enable-tlsv1 — enable TLSv1

insecure 🚨

--ssl-option — set a raw ssl option (numeric value, no quotes about it)
--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 name 🗂️
--check-interval — set the interval (in seconds) of master checks ⏱️
--forkbomb-delay — when a forkbomb is detected, sleep for the number of seconds you specify 😴
--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) 👑
--logto — set 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 (same, shorter, iconic)
--logformat-strftime — apply strftime to the 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 socket you specify 🔌
--req-logger — set/append a request logger 📋
--logger-req — set/append a request logger (same thing, different order, we love her)
--logger — set/append a logger 🪵
--logger-list — list the enabled loggers 📜
--loggers-list — list enabled loggers (plural, still slaying)
--threaded-logger — offload the 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 (aka do not show) log lines matching the regexp you give 🕳️
--log-filter — show only the 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 specified named logger if the regexp applied on the 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 — bestie, this makes curl-based alarms use the main alarm thread instead of spawning a whole dedicated thread per alarm. less thread drama, more chill 💅
--alarm-freq — tunes the anti-loop alarm system. the default is 3 seconds, so like… don't go feral with it 🫶
--alarm-fd — raise the alarm you name when an fd is read for read. by default it reads 1 byte, so if you're on eventfd, set it to 8. iykyk ✨
--alarm-segfault — raise the specified alarm whenever the segmentation fault handler runs. yes, the 💀 handler. at least you'll get notified.
--segfault-alarm — literally the same thing as --alarm-segfault: raise the specified alarm when the segmentation fault handler is executed. two names, one vibe.
--alarm-backlog — raise the specified alarm when the socket backlog queue is full. the queue said "no more" and the alarm said "heard" 🔔
--backlog-alarm — same energy, same option: raise the specified alarm when the socket backlog queue is full.
--lq-alarm — yep, another alias: raise the specified alarm when the socket backlog queue is full.
--alarm-lq — and another one, bestie: raise the specified alarm when the socket backlog queue is full.
--alarm-listen-queue — the backlog queue is full → raise the specified alarm. (this family is huge, it's giving family reunion 🌈)
--listen-queue-alarm — once again for the people in the back: raise the specified alarm when the socket backlog queue is full.
--log-alarm — raise the specified alarm when a log line matches the specified regexp. syntax is <alarm>[,alarm...] <regexp> — note the comma-separated alarm list, slay 👑
--alarm-log — the alias twin 💖 raise the specified alarm when a log line matches the specified regexp. syntax: <alarm>[,alarm...] <regexp>
--not-log-alarm — the opposite girly: skip the specified alarm when a log line matches the specified regexp. syntax: <alarm>[,alarm...] <regexp>
--not-alarm-log — same as above, different spelling ✨ skip the specified alarm when a log line matches the specified regexp, syntax <alarm>[,alarm...] <regexp>
--alarm-list — just lists all the enabled alarms. a little roster reveal 🎀
--alarms-list — the plural-flavoured twin: list enabled alarms.
--alarm-msg-size — sets the max size of an alarm message. default is 8192. keep your alarm messages from becoming whole novels 📚
--log-master — delegate the logging to the master process. let the master handle it, periodt.
--log-master-bufsize — sets the buffer size for the master logger. bigger log messages will be truncated, so… choose wisely bestie 😭
--log-master-stream — creates the master logpipe as SOCK_STREAM. sockets but streamy 💅
--log-master-req-stream — creates the master requests logpipe as SOCK_STREAM. same but for the requests one ✨
--log-reopen — reopen the log after a reload. fresh log, fresh me 🌸
--log-truncate — truncate the log on startup. blank slate energy, no cap.
--log-maxsize — set the maximum logfile size. that's your cap, fr fr.
--log-backupname — set the logfile name used after rotation. rotated logs deserve a name too 🫶
--logdate — prefix logs with a date or a strftime string. timestamps, iconic.
--log-date — the alias: prefix logs with a date or a strftime string.
--log-prefix — prefix logs with a string of your choosing. custom flair for every line ✨
--log-zero — log responses that have no body. empty but documented 💀
--log-slow — log requests slower than the specified number of milliseconds. slow and steady gets logged 🐢
--log-4xx — log requests with a 4xx response. client said something goofy, we're noting it 🙈
--log-5xx — log requests with a 5xx response. server had a moment, we're noting that too 😭
--log-big — log requests bigger than the specified size. big requests, big receipts 🔥
--log-sendfile — log sendfile requests. yes, all of them.
--log-ioerror — log requests with io errors. the messy ones get logged too 💅
--log-micros — report response time in microseconds instead of milliseconds. precision era ⭐
--log-x-forwarded-for — use the ip from the X-Forwarded-For header instead of REMOTE_ADDR. proxy girlies, this one's for you 💜
--master-as-root — leave the master process running as root. big power, big responsibility 👑
--drop-after-init — run the privileges drop after plugin initialization. note: it's superseded by drop-after-apps. so like, know that.
--drop-after-apps — run the privileges drop after apps loading. this one is superseded by master-as-root. chain of command, bestie 🫡
--force-cwd — force the initial working directory to the specified value. your cwd, your rules ✨
--binsh — override /bin/sh. it's used by exec hooks, and it always fallback to /bin/sh — so no matter what you do, that's the safety net 🫶
--chdir — chdir to the specified directory before apps loading.
--chdir2 — chdir to the specified directory after apps loading. same thing, different timing ⏰
--lazy — set lazy mode (load apps in workers instead of master). delegation, but make it processes 💅
--lazy-apps — load apps in each worker instead of the master. every worker gets its own copy, main character energy 👑
--cheap — set cheap mode (spawn workers only after the first request). why work before anyone asks? 😴
--cheaper — set cheaper mode (adaptive process spawning). workers appear when needed, it's giving ✨adaptive✨
--cheaper-initial — set the initial number of processes to spawn in cheaper mode. your starting lineup 🎀
--cheaper-algo — choose the algorithm used for adaptive process spawning. pick your fighter 🔥
--cheaper-step — number of additional processes to spawn at each overload. overloaded? here's more hands 🤝
--cheaper-overload — increase workers after the specified overload. the threshold where we start hiring 📈
--cheaper-algo-list — list enabled cheapers algorithms. little directory of options 🦋
--cheaper-algos-list — same thing, plural-coded: list enabled cheapers algorithms.
--cheaper-list — also lists enabled cheapers algorithms. three names, one job 💖
--cheaper-rss-limit-soft — don't spawn new workers if the total resident memory usage of all workers is higher than this limit. a gentle nudge, not a hard stop 🌸
--cheaper-rss-limit-hard — if total workers resident memory usage is higher, try to stop workers. this one means business 😤
--idle — set idle mode (put uWSGI in cheap mode after inactivity). nap time for your processes 😴
--die-on-idle — shutdown uWSGI when idle. not a nap, a full goodbye 💀
--mount — load application under mountpoint. plop that app right where you want it 🫶
--worker-mount — load application under mountpoint in the specified worker or after workers spawn. same, but worker-scoped ✨
--threads — run each worker in prethreaded mode with the specified number of threads. thread army, assemble 🧵
--thread-stacksize — set threads stacksize.
--threads-stacksize — set threads stacksize. (alias behavior, same deal 💅)
--thread-stack-size — set threads stacksize. the hyphenated remix ✨
--threads-stack-size — set threads stacksize. four names for one setting, that's so uWSGI of it 🌈
--vhost — enable virtualhosting mode (based on the SERVER_NAME variable). many hosts, one process 👑
--vhost-host — enable virtualhosting mode (based on the HTTP_HOST variable). same vibe, different variable 💜
--route — add a route. welcome to routing era 🛣️
--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). yes bestie, there's a goto 👀
--route-if — add a route based on condition.
--route-if-not — add a route based on condition (negate version). the "if not" twin 💅
--route-run — always run the specified route action. no conditions, just vibes ✨
--final-route — add a final route. the last word 🎤
--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 condition.
--final-route-if-not — add a final route based on condition (negate version).
--final-route-run — always run the specified final route action.
--error-route — add an error route. for when things go sideways 😭
--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 condition.
--error-route-if-not — add an error route based on condition (negate version).
--error-route-run — always run the specified error route action.
--response-route — add a response route. routing but for the reply 💌
--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 condition.
--response-route-if-not — add a response route based on condition (negate version).
--response-route-run — always run the specified response route action.
--router-list — list enabled routers. the router census 🦋
--routers-list — same but plural: list enabled routers.
--error-page-403 — add an error page (html) for the managed 403 response. pretty page for the forbidden moment ✨
--error-page-404 — add an error page (html) for the managed 404 response. your custom "not found" serve 💅
--error-page-500 — add an error page (html) for the managed 500 response. soft landing for the server's bad day 😭
--websockets-ping-freq — set the frequency (in seconds) of websockets automatic ping packets. ping ping ping 🏓
--websocket-ping-freq — same setting, singular-named twin: set the frequency (in seconds) of websockets automatic ping packets.
--websockets-pong-tolerance — set the tolerance (in seconds) of the websockets ping/pong subsystem. how long you'll wait for the pong 🫶
--websocket-pong-tolerance — the alias: 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). cap those messages bestie 📏
--websocket-max-size — same numbers, singular spelling: 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). chunk responsibly 🧩
--chunked-input-timeout — set default timeout for chunked input. no waiting around forever ⏳
--clock — set a clock source. timekeeping, but make it configurable ⏰
--clock-list — list enabled clocks. see all your time sources lined up 🌸
--clocks-list — lists every clock that's currently enabled. a lil inventory moment ✨
--add-header — automatically adds HTTP headers to the response. you don't lift a finger, they just appear 💅
--rem-header — automatically removes the HTTP header you specify from the response.
--del-header — same job, same energy: automatically removes the specified HTTP header from the response. (two names, one destiny 🫶)
--collect-header — stores the response header you name into a request var. syntax: header var
--response-header-collect — also stores the specified response header in a request var. syntax: header var
--pull-header — stores the specified response header in a request var and yanks it out of the response entirely. syntax: header var it's giving "you can look but you can't keep it" 😭

--check-static — checks for static files in the directory you name. 📁
--check-static-docroot — checks for static files in the requested DOCUMENT_ROOT.
--static-check — checks for static files in the specified directory. (yes bestie, this is the same thing wearing a different outfit ✨)
--static-map — maps a mountpoint to a static directory (or a file).
--static-map2 — like --static-map, except it completely appends the requested resource to the docroot.
--static-skip-ext — skips the specified extension when doing staticfile 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 specified path. handle with care, bestie — this one's the "trust me bro" of paths 🚨
--static-cache-paths — puts resolved paths into the uWSGI cache for the number of seconds you specify. speedrun energy 🔥
--static-cache-paths-name — uses the cache you specify for those 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 (twins 🎀)
--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. the mtime variants are just the glow-up versions fr fr ✨

--static-gzip — if the regexp you supply matches the static file translation, it'll go looking for a gzip version. zip zip hooray 🦋
--static-gzip-all — checks for a gzip version of all requested static files.
--static-gzip-dir — checks for a gzip version of all requested static files inside the dir/prefix you specify.
--static-gzip-prefix — checks for a gzip version of all requested static files inside the specified dir/prefix.
--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 specified ext/suffix. (dir/prefix and ext/suffix are each just two names for one vibe 💜)
--honour-range — enables support for the HTTP Range header. resumable downloads said hello 👑
--offload-threads — sets how many offload threads to spawn. per-worker, default 0
--offload-thread — sets how many offload threads to spawn. per-worker, default 0 same same 🫶
--file-serve-mode — sets the static file serving mode.
--fileserve-mode — sets the static file serving mode. (told you, same same 😌)
--disable-sendfile — disables sendfile() and relies on the boring old read()/write(). not everything needs to be fast, sometimes it needs to be boring 💀
--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. this could be required if you're spawning processes inside requests.
--close-on-exec2 — sets close-on-exec on server sockets. also could be required for spawning processes in requests.
--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. like, immediately immediately 💅
--unenv — unsets an environment variable.
--vacuum — tries to remove all of the generated file/sockets. leave no trace, main character behaviour 🌸
--file-write — writes the specified content to the specified file before privileges drop. syntax: file=value
--cgroup — puts the processes into the cgroup you specify.
--cgroup-opt — sets a value in the specified cgroup option.
--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 inside your namespace.
--ns — runs in a new namespace under the specified rootfs. (yes, it's --namespace again, they're matching 🎀)
--namespace-net — adds a network namespace.
--ns-net — adds a network namespace. iconic duo behaviour ✨

--enable-proxy-protocol — enables PROXY1 protocol support. only for http parsers.
--reuse-port — enables the REUSE_PORT flag on the socket. BSD only, bestie 🚨
--tcp-fast-open — enables the TCP_FASTOPEN flag on TCP sockets with the qlen value you specify.
--tcp-fastopen — enables the TCP_FASTOPEN flag on TCP sockets with the specified qlen value. twinning 💫
--tcp-fast-open-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if it's supported.
--tcp-fastopen-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported. same, obviously 🫶
--zerg — attaches to a zerg server. 🐛
--zerg-fallback — falls back to normal sockets if the zerg server isn't available. safety net activated 🕸️
--zerg-server — enables the zerg server on the UNIX socket you specify.
--cron — adds a cron task.
--cron2 — adds a cron task using 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. yes bestie, harakiri means it gets killed 💀
--legion-cron — adds a cron task that's runnable only when the instance is a lord of the legion you specify. 👑
--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. four names, one very lordly vibe 👑
--loop — selects the uWSGI loop engine.
--loop-list — lists every enabled loop engine.
--loops-list — lists every enabled loop engine. (plural, same list 🌈)
--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, literally 🚨
--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. opposite day 💅
--legion-attach-daemon — same as --attach-daemon, but the daemon only runs on the legion lord node. 👑
--legion-smart-attach-daemon — same as --smart-attach-daemon, but the daemon only runs on the legion lord node. 👑
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2, but the daemon only runs on the legion lord node. 👑
--daemons-honour-stdin — does not change the stdin of external daemons to /dev/null. let them have stdin, as a treat 🍓
--attach-daemon2 — the attach-daemon keyval variant. it supports smart modes too. ✨

--plugins — loads uWSGI plugins.
--plugin — loads uWSGI plugins. same thing, one less letter 🎀
--need-plugins — loads uWSGI plugins, but exits on error. no plugin, no party 😭
--need-plugin — loads uWSGI plugins and exits on error. yep, the singular twin 🫶
--plugins-dir — adds a directory to the uWSGI plugin search path.
--plugin-dir — adds a directory to the uWSGI plugin search path. same same 🌸
--plugins-list — lists every enabled plugin.
--plugin-list — lists every enabled plugin. (plural, same list, we been knew 💅)
--autoload — tries to automatically load plugins whenever unknown options show up. ✨ mind reading mode ✨
--dlopen — blindly loads a shared library. blindly!! no cap, that's the actual word 🔥
--allowed-modifiers — a comma separated list of allowed modifiers.
--remap-modifier — remaps a request modifier from one id to another.
--dump-options — dumps the full list of available options. every single one bestie, buckle up 🫶
--show-config — shows the current config, reformatted as ini.
--binary-append-data — returns the content of a resource to stdout so you can append it to a uwsgi binary. for data:// usage.
--print — simple print.
--iprint — simple print, but the immediate version. ⚡
--exit — forces exit() of the instance. the dramatic exit 💀👋
--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. the classic 👑
--response-headers-limit — sets the response header maximum size. default: 64k

and that's the whole list bestie, you ate that 🍽️✨ this page was uwsgi_php version 2.0.31-2, dated January 2026 — go forth and configure, you absolute icon 💅🦋

📦 where this page comes from

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