UWSGI_ROUTER_ACCESS(1)

📦

version 2.0.31 · 7 versions

🎀 NAME 🎀

okay so bestie, pull up a chair, because this is the manual page for uwsgi_router_access — and if you're squinting at the title and wondering why it says UWSGI_ROUTER_ACCESS(1) up there, that's just the manual-name-meets-the-program-name situation every man page does. Same girl, two name tags. 💅

uwsgi_router_access — fast (pure C), self-healing, developer-friendly WSGI server

pure C. self-healing. developer-friendly. she's literally serving WSGI and vibes at the same time. 🫶✨

heads up bestie, this page is LONG (like, six parts long), so pace yourself. hydrate. we're going through every single flag, no skips, no summarising, periodt. 🌸

🫶 SYNOPSIS 🫶

uwsgi-core [options...]

that's it. that's the whole thing. you run the thing, you give it options, she does stuff. main character energy fr fr. 👑

✨ DESCRIPTION ✨

so this whole section is basically a massive options menu — sockets first, then all the switches and knobs and levers. every single one of them is here, in order, no cap. 🔥

🌈 Sockets & protocols

-s, --socket — bind to the UNIX or TCP socket you specify, using the default protocol. 💖
-s, --uwsgi-socket — bind to the UNIX or TCP socket you specify, but this time using the uwsgi protocol. (yes, -s is on both of them, the letters get reused around here, it's a whole thing 🙈)
--suwsgi-socket — bind to the UNIX or TCP socket you specify, using uwsgi protocol over SSL. 🔒
--ssl-socket — bind to the UNIX or TCP socket you specify, using uwsgi protocol over SSL. (yes it's twins with the one above, the manpage said it twice so I'm saying it twice 💀)
--http-socket — bind to the UNIX or TCP socket you specify, using the HTTP protocol. ✨
--http-socket-modifier1 — force the modifier1 you specify when you're using HTTP protocol.
--http-socket-modifier2 — force the modifier2 you specify when you're using HTTP protocol.
--http11-socket — bind to the UNIX or TCP socket you specify, using HTTP 1.1 (Keep-Alive) protocol. staying connected, so iconic. 🦋
--https-socket — bind to the UNIX or TCP socket you specify, using HTTPS protocol. 🔐
--https-socket-modifier1 — force the modifier1 you specify when you're using HTTPS protocol.
--https-socket-modifier2 — force the modifier2 you specify when you're using HTTPS protocol.
--fastcgi-socket — bind to the UNIX or TCP socket you specify, using the FastCGI protocol. ⚡
--fastcgi-nph-socket — bind to the UNIX or TCP socket you specify, using the FastCGI protocol (nph mode).
--fastcgi-modifier1 — force the modifier1 you specify when you're using FastCGI protocol.
--fastcgi-modifier2 — force the modifier2 you specify when you're using FastCGI protocol.
--scgi-socket — bind to the UNIX or TCP socket you specify, using the SCGI protocol.
--scgi-nph-socket — bind to the UNIX or TCP socket you specify, using the SCGI protocol (nph mode).
--scgi-modifier1 — force the modifier1 you specify when you're using SCGI protocol.
--scgi-modifier2 — force the modifier2 you specify when you're using SCGI protocol.
--raw-socket — bind to the UNIX or TCP socket you specify, using the RAW protocol.
--raw-modifier1 — force the modifier1 you specify when you're using RAW protocol.
--raw-modifier2 — force the modifier2 you specify when you're using RAW protocol.
--puwsgi-socket — bind to the UNIX or TCP socket you specify, using persistent uwsgi protocol (puwsgi). she persists. 💜
--protocol — force the protocol you specify for default sockets.
--socket-protocol — force the protocol you specify for default sockets. (yep, same job as the one above, the manpage keeps both, so we keep both 🫶)
--shared-socket — create a shared socket for advanced jailing or ipc.
--undeferred-shared-socket — create a shared socket for advanced jailing or ipc, but in undeferred mode.

🧵 Workers, harakiri & the queue

-p, --processes — spawn the number of workers/processes you specify.
-p, --workers — spawn the number of workers/processes you specify. (same -p, same meaning, the page just names it twice and I respect that 💅)
--thunder-lock — serialize accept() usage, if possible. ⚡
-t, --harakiri — set the harakiri timeout. (dramatic name, very on brand 🗡️)
--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 ways to say the same thing, and honestly? slay, options are a love language 💖)
--backtrace-depth — set the backtrace depth.
--mule-harakiri — set the harakiri timeout for mule tasks.

📁 Config, placeholders & the option logic

-x, --xmlconfig — load config from an xml file.
-x, --xml — load config from an xml file. (yes, -x twice. iconic behaviour. 🙈)
--config — load configuration using the pluggable system.
--fallback-config — re-exec uwsgi with the config you specify 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 placeholder you specify, syntax: 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 number you specify into a list starting from 1.
--for-readline — (opt logic) for cycle, expand the file you specify into a list of lines.
--endfor — (opt logic) end for cycle.
--end-for — (opt logic) end for cycle.
--if-opt — (opt logic) check for option.
--if-not-opt — (opt logic) check for option.
--if-env — (opt logic) check for environment variable.
--if-not-env — (opt logic) check for environment variable.
--ifenv — (opt logic) check for environment variable.
--if-reload — (opt logic) check for reload.
--if-not-reload — (opt logic) check for reload.
--if-hostname — (opt logic) check for hostname.
--if-not-hostname — (opt logic) check for hostname.
--if-hostname-match — (opt logic) try to match hostname against a regular expression.
--if-not-hostname-match — (opt logic) try to match hostname against a regular expression.
--if-exists — (opt logic) check for file/directory existence.
--if-not-exists — (opt logic) check for file/directory existence.
--ifexists — (opt logic) check for file/directory existence.
--if-plugin — (opt logic) check for plugin.
--if-not-plugin — (opt logic) check for plugin.
--ifplugin — (opt logic) check for plugin.
--if-file — (opt logic) check for file existence.
--if-not-file — (opt logic) check for file existence.
--if-dir — (opt logic) check for directory existence.
--if-not-dir — (opt logic) check for directory existence.
--ifdir — (opt logic) check for directory existence.
--if-directory — (opt logic) check for directory existence.
--endif — (opt logic) end if.
--end-if — (opt logic) end if.
--blacklist — set the options blacklist context.
--end-blacklist — clear the options blacklist context.
--whitelist — set the options whitelist context.
--end-whitelist — clear the options whitelist context.

🩹 Write errors & warnings

--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().

🗂️ Templating & config files

--inherit — use the file you specify as a config template.
--include — include the file you specify 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).

🎛️ Instance control

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

🧮 Buffers, listen queue & memory

-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 the internal buffer size.
-m, --memory-report — enable the memory report. 📊
--profiler — enable the profiler you specify.
-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. (-C on both, we love a shared letter 💅)
--chown-socket — chown unix sockets.
--umask — set the umask.
--freebind — put the socket in freebind mode.
--map-socket — map sockets to specific workers.

🧚 Threads & process names

-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 process names 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 the master process name.

👑 Apps, master & the Emperor

-i, --single-interpreter — do not use multiple interpreters (where available).
--need-app — exit if no app can be loaded. 😭
-M, --master — enable the 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 is NOT the end bestie, don't you dare close the tab — this page comes in 6 parts and we're only on part 1. so much more to go. stay hydrated, keep scrolling. 🦋✨

--emperor-pidfile — drop the Emperor's pid into the file you name. king energy only ✨
--emperor-tyrant — flip the Emperor into Tyrant mode 👑
--emperor-tyrant-nofollow — in Tyrant mode, when it's checking uid/gid, don't follow symlinks. no cap.
--emperor-stats — run the Emperor stats server 📊
--emperor-stats-server — also runs the Emperor stats server (same vibe, different spelling bestie)
--early-emperor — spawn the emperor as soon as possible. literally the moment it can. ⚡
--emperor-broodlord — run the emperor in BroodLord mode 🦋
--emperor-throttle — set the throttling level (in milliseconds) for vassals that are acting up. default is 1000.
--emperor-max-throttle — set the max throttling level (in milliseconds) for bad-behaving vassals. default is 3 minutes. they get the timeout corner fr 💀
--emperor-magic-exec — prefix vassals' config files with exec:// if they have the executable bit set 🪄
--emperor-on-demand-extension — search for a text file (vassal name + extension) that holds the on demand socket name
--emperor-on-demand-ext — same thing, shorter name, we love a shortcut 💅
--emperor-on-demand-directory — turn on on demand mode by binding to the unix socket in the directory you specify, named like the vassal + .socket
--emperor-on-demand-dir — the abbreviated twin of the above 🎀
--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 — allows the extension you specify in the Emperor (and the vassal gets called with --config)
--emperor-extra-ext — yep, the short version of that one too ✨
--emperor-no-blacklist — disable the Emperor blacklisting subsystem. everyone gets a second chance ig 🫶
--emperor-use-clone — use clone() instead of fork(), passing the unshare() flags you specify
--emperor-graceful-shutdown — use vassals' graceful shutdown during ragnarok 🌈
--emperor-cap — set vassals capability
--vassals-cap — set vassals capability (same deal)
--vassal-cap — set vassals capability (also same deal, three aliases, iconic)
--imperial-monitor-list — list the enabled imperial monitors 👀
--imperial-monitors-list — list the enabled imperial monitors (the plural version, equally valid)
--vassals-inherit — add config templates to vassals' config (it uses --inherit)
--vassals-include — include config templates in vassals' config (uses --include instead of --inherit)
--vassals-inherit-before — add config templates to vassals' config (uses --inherit, and parses before the vassal file)
--vassals-include-before — include config templates in vassals' config (uses --include instead of --inherit, and parses before the vassal file)
--vassals-start-hook — run the command you specify before each vassal starts 🏁
--vassals-stop-hook — run the command you specify after a vassal's death 🪦
--vassal-sos — ask the emperor for reinforcement when you're overloaded. help bestie I'm drowning 😭
--vassal-sos-backlog — ask the emperor for 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, still sets it for every vassal 💫
--heartbeat — announce healthiness to the emperor 💓
--reload-mercy — set the maximum time (in seconds) we wait for workers and other processes to die during reload/shutdown
--worker-reload-mercy — set the maximum time (in seconds) a worker can take to reload/shutdown. default is 60.
--mule-reload-mercy — set the maximum time (in seconds) a mule can take to reload/shutdown. default is 60.
--exit-on-reload — force exit even if a reload is requested
--die-on-term — exit instead of 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 (again, same flag, we keep it real)
--print-sym — print the content of the binary symbol you specify
--print-symbol — print the content of the binary symbol you specify (full-name edition)
-r|--reaper — call waitpid(-1,...) after each request to get rid of zombies 🧟‍♀️ no zombies allowed in this house
-R|--max-requests — reload workers after the amount of managed requests you specify
--max-requests-delta — add (worker_id * delta) to the max_requests value of each worker
--min-worker-lifetime — number of seconds a worker must run before being reloaded. default is 10.
--max-worker-lifetime — reload workers after the amount of seconds you specify. 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 number of shared locks you specify
--lock-engine — set the lock engine
--ftok — set the ipcsem key via ftok() for avoiding duplicates
--persistent-ipcsem — do not remove ipcsem's on shutdown
-A|--sharedarea — create a raw shared memory area of the specified pages (heads up: it supports keyval too)
--safe-fd — do not close the file descriptor you specify
--fd-safe — do not close the file descriptor you specify (same energy, reversed words)

--cache — create a shared cache containing the given elements
--cache-blocksize — set cache blocksize
--cache-store — enable persistent cache to disk
--cache-store-sync — set the frequency of sync for the persistent cache
--cache-no-expire — disable the auto sweep of expired items
--cache-expire-freq — set the frequency of cache sweeper scans. default is 3 seconds.
--cache-report-freed-items — constantly report the cache item freed by the sweeper. ⚠️ use only for debug, bestie, this is a loud one
--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 whole 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 in the cache
--load-file-in-cache-gzip — load a static file in the cache with gzip compression 🗜️
--cache2 — create a new generation shared cache (keyval syntax)
--queue — enable shared queue
--queue-blocksize — set queue blocksize
--queue-store — enable persistent queue to disk
--queue-store-sync — set the frequency of sync for the persistent queue

-Q|--spooler — run a spooler on the directory you specify 🌀
--spooler-external — map spoolers' requests to a spooler directory managed by an external instance
--spooler-ordered — try to order the execution of spooler tasks
--spooler-chdir — chdir() to the directory you specify before each spooler task
--spooler-processes — set the number of processes for spoolers
--spooler-quiet — do not be verbose with spooler tasks 🤫
--spooler-max-tasks — set the maximum number of tasks to run before recycling a spooler
--spooler-harakiri — set harakiri timeout for spooler tasks
--spooler-frequency — set spooler frequency
--spooler-freq — set spooler frequency (short edition, same vibe)
--mule — add a mule 🐴
--mules — add the number of mules you specify
--farm — add a mule farm 🐴🐴🐴
--mule-msg-size — set mule message buffer size
--signal — send a uwsgi signal to a server
--signal-bufsize — set buffer size for signal queue
--signals-bufsize — set buffer size for signal queue (plural spelling, same thing)
--signal-timer — add a timer. syntax: <signal> <seconds> ⏰
--timer — add a timer. syntax: <signal> <seconds> (faster to type, same deal)
--signal-rbtimer — add a redblack timer. syntax: <signal> <seconds>
--rbtimer — add a redblack timer. syntax: <signal> <seconds> (short king)
--rpc-max — maximum number of rpc slots. default: 64.
-L|--disable-logging — disable request logging 🔇

--flock — lock the file you specify before starting, and exit if it's locked
--flock-wait — lock the file you specify before starting, and wait if it's locked 🕰️
--flock2 — lock the file you specify after logging/daemon setup, exit if it's locked
--flock-wait2 — lock the file you specify after logging/daemon setup, wait if it's locked
--pidfile — create pidfile (before privileges drop)
--pidfile2 — create pidfile (after privileges drop)
--safe-pidfile — create safe pidfile (before privileges drop)
--safe-pidfile2 — create safe pidfile (after privileges drop)
--chroot — chroot() to the 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 directories you specify (new_root and put_old must be separated with a space — yes, underscore spelling, it's a whole thing)
--uid — setuid to the user/uid you specify
--gid — setgid to the group/gid you specify
--add-gid — add the group id you specify to the process credentials
--immediate-uid — setuid to the user/uid you specify IMMEDIATELY. no waiting around 💅
--immediate-gid — setgid to the group/gid you specify IMMEDIATELY
--no-initgroups — disable the additional groups set via initgroups()
--cap — set process capability
--unshare — unshare() part of the processes and put it in a new namespace
--unshare2 — unshare() part of the processes and put it in a new namespace after the rootfs change
--setns-socket — expose a unix socket returning namespace fds from /proc/self/ns 🪐
--setns-socket-skip — skip the entry you specify when sending setns file descriptors
--setns-skip — skip the entry you specify when sending setns file descriptors (short version, same skip)
--setns — join a namespace created by an external uWSGI instance
--setns-preopen — open /proc/self/ns as soon as possible and cache the fds
--jailed — marks the instance as jailed, which forces the execution of post_jail hooks. periodt. 🫶
--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. it's giving instant. ⚡
--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 — disable deferred-accept on sockets. 🚫
--tcp-nodelay — enable TCP NODELAY on each request. 🚀
--so-keepalive — enable TCP KEEPALIVEs. 🔁
--so-send-timeout — set SO_SNDTIMEO. ⏰
--socket-send-timeout — set SO_SNDTIMEO. ⏰
--so-write-timeout — set SO_SNDTIMEO. ⏰
--socket-write-timeout — set SO_SNDTIMEO. ⏰
--socket-sndbuf — set SO_SNDBUF. 📦
--socket-rcvbuf — set SO_RCVBUF. 📦
--shutdown-sockets — force calling shutdown() in addition to close() when sockets are destroyed. 🔌
--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 — pings a signal when the file you picked gets modified/touched, bestie. syntax is file signal 🫶
--fs-reload — graceful reload when the specified filesystem object gets modified ✨
--fs-brutal-reload — brutal reload when the specified filesystem object gets modified 💀 no chill, no waiting
--fs-signal — raise a uwsgi signal when the specified filesystem object gets modified, syntax: file signal 💅
--check-mountpoint — straight up destroys the instance if a filesystem is no more reachable. like, it's giving reliability for Fuse management 🙈
--mountpoint-check — same energy, bb: destroys the instance if a filesystem is no more reachable (useful for reliable Fuse management) 🌸
--check-mount — yep, again: destroys the instance if a filesystem is no more reachable (useful for reliable Fuse management) 💖
--mount-check — the fourth twin 👑 destroys the instance if a filesystem is no more reachable (useful for reliable Fuse management)
--propagate-touch — the over-engineering option for systems with flaky signal management, no cap 🎀
--limit-post — limit request body, periodt ✋
--no-orphans — automatically kill workers if master dies. can be dangerous for availability though, so be careful bestie 😭
--prio — set processes/threads priority ⭐
--cpu-affinity — set cpu affinity 💅
--post-buffering — set size in bytes after which it'll buffer to disk instead of memory 🌈
--post-buffering-bufsize — set buffer size for read() in post buffering mode 📖
--body-read-warning — set the amount of allowed memory allocation (in megabytes) for request body before it starts printing a warning 👀
--upload-progress — enable creation of .json files in the specified directory during a file upload 🍓
--no-default-app — do not fallback to default app 🚫
--manage-script-name — automatically rewrite SCRIPT_NAME and PATH_INFO ✨
--ignore-script-name — ignore SCRIPT_NAME 🙈
--catch-exceptions — report exception as http output. discouraged, use only for testing, fr fr 🧪
--reload-on-exception — reload a worker when an exception is raised 🔄
--reload-on-exception-type — reload a worker when a specific exception type is raised 🔥
--reload-on-exception-value — reload a worker when a specific exception value is raised 💜
--reload-on-exception-repr — reload a worker when a specific exception type+value (language-specific) is raised 👑
--exception-handler — add an exception handler 🫶
--enable-metrics — enable metrics subsystem 📊
--metric — add a custom metric ✨
--metric-threshold — add a metric threshold/alarm 🚨
--metric-alarm — add a metric threshold/alarm (same thing, different name, iykyk) 🚨
--alarm-metric — add a metric threshold/alarm — yeah, three of them 💀
--metrics-dir — export metrics as text files to the specified directory 📁
--metrics-dir-restore — restore last value taken from the metrics dir ♻️
--metric-dir — export metrics as text files to the specified directory (singular edition) 📂
--metric-dir-restore — restore last value taken from the metrics dir ♻️
--metrics-no-cores — disable generation of cores-related metrics 🚫
--udp — run the udp server on the specified address 📡
--stats — enable the stats server on the specified address 📈
--stats-server — enable the stats server on the specified address 📈
--stats-http — prefix stats server json output with http headers 🌐
--stats-minified — minify statistics json output 🗜️
--stats-min — minify statistics json output 🗜️
--stats-push — push the stats json to the specified destination 🚀
--stats-pusher-default-freq — set the default frequency of stats pushers ⏱️
--stats-pushers-default-freq — set the default frequency of stats pushers ⏱️
--stats-no-cores — disable generation of cores-related stats 🚫
--stats-no-metrics — do not include metrics in stats output 🙅
--multicast — subscribe to specified multicast group 📻
--multicast-ttl — set multicast ttl ⏳
--multicast-loop — set multicast loop (default 1) 🔁
--master-fifo — enable the master fifo 🎀
--notify-socket — enable the notification socket 🔔
--subscription-notify-socket — set the notification socket for subscriptions 🔔
--legion — became a member of a legion ⚔️
--legion-mcast — became a member of a legion (shortcut for multicast) 📻
--legion-node — add a node to a legion 🫂
--legion-freq — set the frequency of legion packets ⏱️
--legion-tolerance — set the tolerance of legion subsystem 🧘
--legion-death-on-lord-error — declare itself as a dead node for the specified amount of seconds if one of the lord hooks fails 💀
--legion-skew-tolerance — set the clock skew tolerance of legion subsystem (default 60 seconds) ⏰
--legion-lord — action to call on Lord election 👑
--legion-unlord — action to call on Lord dismiss 🫡
--legion-setup — action to call on legion setup 🛠️
--legion-death — action to call on legion death (shutdown of the instance) 💀
--legion-join — action to call on legion join (first time quorum is reached) 🎉
--legion-node-joined — action to call on new node joining legion 🫶
--legion-node-left — action to call node leaving legion 👋
--legion-quorum — set the quorum of a legion 🗳️
--legion-scroll — set the scroll of a legion 📜
--legion-scroll-max-size — set max size of legion scroll buffer 📜
--legion-scroll-list-max-size — set max size of legion scroll list buffer 📜
--subscriptions-sign-check — set digest algorithm and certificate directory for secured subscription system 🔐
--subscriptions-sign-check-tolerance — set the maximum tolerance (in seconds) of clock skew for secured subscription system ⏰
--subscriptions-sign-skip-uid — skip signature check for the specified uid when using unix sockets credentials 🪪
--subscriptions-credentials-check — add a directory to search for subscriptions key credentials 🔑
--subscriptions-use-credentials — enable management of SCM_CREDENTIALS in subscriptions UNIX sockets 🎫
--subscription-algo — set load balancing algorithm for the subscription system ⚖️
--subscription-dotsplit — try to fallback to the next part (dot based) in subscription key 🎯
--subscribe-to — subscribe to the specified subscription server 📨
--st — subscribe to the specified subscription server (yes, the short one) 📨
--subscribe — subscribe to the specified subscription server 📨
--subscribe2 — subscribe to the specified subscription server using advanced keyval syntax ✨
--subscribe-freq — send subscription announce at the specified interval ⏱️
--subscription-tolerance — set tolerance for subscription servers 🧘
--unsubscribe-on-graceful-reload — force unsubscribe request even during graceful reload 🚪
--start-unsubscribed — configure subscriptions but do not send them (useful with master fifo) 🤫
--subscribe-with-modifier1 — force the specififed modifier1 when subscribing (typo is theirs, not mine, 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 maximum certificate verification depth 🕳️
--sni — add an SNI-governed SSL context 🔐
--sni-dir — check for cert/key/client_ca file in the specified directory and create a sni/ssl context on demand 📁
--sni-dir-ciphers — set ssl ciphers for sni-dir option 🔡
--ssl-enable3 — enable SSLv3 (insecure) 💀
--ssl-enable-sslv3 — enable SSLv3 (insecure) 💀
--ssl-enable-tlsv1 — enable TLSv1 (insecure) 💀
--ssl-option — set a raw ssl option (numeric value) 🔢
--sni-regexp — add an SNI-governed SSL context (the key is a regexp) 🧩
--ssl-tmp-dir — store ssl-related temp files in the specified directory 🗂️
--check-interval — set the interval (in seconds) of master checks ⏱️
--forkbomb-delay — sleep for the specified number of seconds when a forkbomb is detected 😴
--binary-path — force binary path 📌
--privileged-binary-patch — patch the uwsgi binary with a new command (before privileges drop) 🔧
--unprivileged-binary-patch — patch the uwsgi binary with a new command (after privileges drop) 🔧
--privileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments (before privileges drop) 🔧
--unprivileged-binary-patch-arg — patch the uwsgi binary with a new command and arguments (after privileges drop) 🔧
--async — enable async mode with specified cores ⚡
--max-fd — set maximum number of file descriptors (requires root privileges) 👑
--logto — set logfile/udp address 🪵
--logto2 — log to specified file or udp address after privileges drop 🪵
--log-format — set advanced format for request logging 🖋️
--logformat — set advanced format for request logging 🖋️
--logformat-strftime — apply strftime to logformat output 🕰️
--log-format-strftime — apply strftime to logformat output 🕰️
--logfile-chown — chown logfiles 🔑
--logfile-chmod — chmod logfiles 🔒
--log-syslog — log to syslog 📮
--log-socket — send logs to the specified socket 🔌
--req-logger — set/append a request logger 🪵
--logger-req — set/append a request logger 🪵
--logger — set/append a logger 🪵
--logger-list — list enabled loggers 📋
--loggers-list — list enabled loggers 📋
--threaded-logger — offload log writing to a thread 🧵
--log-encoder — add an item in the log encoder chain ⛓️
--log-req-encoder — add an item in the log req encoder chain ⛓️
--log-drain — drain (do not show) log lines matching the specified regexp 🕳️
--log-filter — show only log lines matching the specified regexp 🔍
--log-route — log to the specified named logger if regexp applied on logline matches 🚏
--log-req-route — log requests to the specified named logger if regexp applied on logline matches 🚏
--use-abort — call abort() on segfault/fpe, could be useful for generating a core dump 💥
--alarm — create a new alarm, syntax: <alarm> <plugin:args> 🚨

Okay bestie the alarm options are giving ✨security system✨ and honestly? obsessed.

--alarm-cheap — use the main alarm thread instead of spinning up dedicated threads for curl-based alarms
--alarm-freq — tune the anti-loop alarm system (default 3 seconds)
--alarm-fd — raise the specified alarm when an fd is read for read (by default it reads 1 byte, set 8 for eventfd) 🫶
--alarm-segfault — raise the specified alarm when the segmentation fault handler is executed 💀
--segfault-alarm — raise the specified alarm when the segmentation fault handler is executed (yes bestie, same thing, different name, iconic twin energy)
--alarm-backlog — raise the specified alarm when the socket backlog queue is full
--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

the backlog alarm has six whole aliases and honestly? she's serving versatility. pick whichever one your heart says 🎀

--log-alarm — raise the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp>
--alarm-log — raise the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp>
--not-log-alarm — skip the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp> (the "nah, not today" version)
--not-alarm-log — skip the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp>
--alarm-list — list enabled alarms 📋
--alarms-list — list enabled alarms 📋
--alarm-msg-size — set the max size of an alarm message (default 8192)

Now we're deep in logging territory and it's lowkey the most underrated glow-up in the whole config. ✨

--log-master — delegate logging to master process 👑
--log-master-bufsize — set the buffer size for the master logger. bigger log messages will be truncated (not it, keep your lines short bestie)
--log-master-stream — create the master logpipe as SOCK_STREAM
--log-master-req-stream — create the master requests logpipe as SOCK_STREAM
--log-reopen — reopen log after reload
--log-truncate — truncate log on startup
--log-maxsize — set maximum logfile size
--log-backupname — set logfile name after rotation
--logdate — prefix logs with date or a strftime string
--log-date — prefix logs with date or a strftime string
--log-prefix — prefix logs with a string
--log-zero — log responses without body
--log-slow — log requests slower than the specified number of milliseconds 🐌
--log-4xx — log requests with a 4xx response
--log-5xx — log requests with a 5xx response
--log-big — log requests bigger than the specified size
--log-sendfile — log sendfile requests
--log-ioerror — log requests with io errors
--log-micros — report response time in microseconds instead of milliseconds
--log-x-forwarded-for — use the ip from X-Forwarded-For header instead of REMOTE_ADDR

--master-as-root — leave master process running as root
--drop-after-init — run privileges drop after plugin initialization, superseded by drop-after-apps
--drop-after-apps — run privileges drop after apps loading, superseded by master-as-root

heads up bestie — those last two are literally marked superseded, so they're the vintage pieces in your closet, not the fit you reach for 💅

--force-cwd — force the initial working directory to the specified value
--binsh — override /bin/sh (used by exec hooks, it always fallback to /bin/sh)
--chdir — chdir to specified directory before apps loading
--chdir2 — chdir to specified directory after apps loading

Okay the lazy / cheap / cheaper family is my roman empire actually. 🌸

--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 to algorithm used for adaptive process spawning
--cheaper-step — number of additional processes to spawn at each overload
--cheaper-overload — increase workers after specified overload
--cheaper-algo-list — list enabled cheapers algorithms
--cheaper-algos-list — list enabled cheapers algorithms
--cheaper-list — list enabled cheapers algorithms
--cheaper-rss-limit-soft — don't spawn new workers if total resident memory usage of all workers is higher than this limit
--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 — shutdown uWSGI when idle 💀

--mount — load application under mountpoint
--worker-mount — load application under 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
--vhost — enable virtualhosting mode (based on SERVER_NAME variable)
--vhost-host — enable virtualhosting mode (based on HTTP_HOST variable)

And now… the routing section. It's long. It's ornate. It's the main character. Let's go. 👑

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

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

four whole route families — plain, final, error, response — and every single one has the same glorious list of triggers. symmetry, she is beauty 🦋

--router-list — list enabled routers
--routers-list — list enabled routers
--error-page-403 — add an error page (html) for managed 403 response
--error-page-404 — add an error page (html) for managed 404 response
--error-page-500 — add an error page (html) for managed 500 response

Websockets bestie rise up 🌈 (and yes, every one of these has a twin name, that's just how this house runs):

--websockets-ping-freq — set the frequency (in seconds) of websockets automatic ping packets
--websocket-ping-freq — set the frequency (in seconds) of websockets automatic ping packets
--websockets-pong-tolerance — set the tolerance (in seconds) of websockets ping/pong subsystem
--websocket-pong-tolerance — set the tolerance (in seconds) of 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 default timeout for chunked input
--clock — set a clock source ⏰
--clock-list — list enabled clocks

and that's a wrap on part 5, but bestie we are NOT done — there's more coming 🫶

--clocks-list — lists every clock that's enabled rn 🕰️
--add-header — automatically slaps HTTP headers onto the response for u 💅
--rem-header — automatically yeets the specified HTTP header out of the response
--del-header — automatically yeets the specified HTTP header out of the response
--collect-header — stashes the specified response header into a request var (syntax: header var) 📥
--response-header-collect — stashes the specified response header into a request var (syntax: header var)
--pull-header — stashes the specified response header into a request var AND removes it from the response (syntax: header var)

--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 directory you name
--static-map — maps a mountpoint to a static directory (or a file) 🗺️
--static-map2 — like static-map but it completely appends the requested resource to the docroot
--static-skip-ext — skips the specified extension when doing static-file checks
--static-index — searches for the specified file when a directory gets requested
--static-safe — skips security checks if the file lives under the specified path 🔐
--static-cache-paths — pops resolved paths into the uWSGI cache for the number of seconds you give
--static-cache-paths-name — use the specified cache 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)
--static-expires-type — sets the Expires header based on content type ✨
--static-expires-type-mtime — sets the Expires header based on content type and file mtime
--static-expires — sets the Expires header based on a filename regexp
--static-expires-mtime — sets the Expires header based on a filename regexp and file mtime
--static-expires-uri — sets the Expires header based on a REQUEST_URI regexp
--static-expires-uri-mtime — sets the Expires header based on a REQUEST_URI regexp and file mtime
--static-expires-path-info — sets the Expires header based on a PATH_INFO regexp
--static-expires-path-info-mtime — sets the Expires header based on a PATH_INFO regexp and file mtime
--static-gzip — if the regexp you supplied matches the static file translation, it'll go hunting for a gzip version 🗜️
--static-gzip-all — checks for a gzip version of every single requested static file
--static-gzip-dir — checks for a gzip version of all requested static files in the specified dir/prefix
--static-gzip-prefix — 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 specified ext/suffix
--static-gzip-suffix — 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
--disable-sendfile — disables sendfile() and makes it rely on boring old read()/write() 😴
--check-cache — checks for response data in the specified cache (leave it empty for the default cache)
--close-on-exec — sets close-on-exec on connection sockets (could be required for spawning processes in requests)
--close-on-exec2 — sets close-on-exec on server sockets (could be required for spawning processes in requests)
--mode — set uWSGI custom mode
--env — set environment variable
--envdir — loads a daemontools compatible envdir
--early-envdir — loads a daemontools compatible envdir ASAP 🏃‍♀️
--unenv — unsets an environment variable
--vacuum — tries to remove all of the generated file/sockets 🧹
--file-write — writes the specified content to the specified file (syntax: file=value) before privileges drop
--cgroup — puts the processes in the specified cgroup
--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 specified rootfs
--namespace-keep-mount — keeps the specified mountpoint in your namespace
--ns — runs in a new namespace under the specified rootfs
--namespace-net — adds a network namespace
--ns-net — adds a network namespace
--enable-proxy-protocol — enables PROXY1 protocol support (only for http parsers)
--reuse-port — enables the REUSE_PORT flag on the socket (BSD only) 🐡
--tcp-fast-open — enables the TCP_FASTOPEN flag on TCP sockets with the qlen value you specify
--tcp-fastopen — enables the TCP_FASTOPEN flag on TCP sockets with the qlen value you specify
--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 it's supported
--zerg — attaches to a zerg server 👾
--zerg-fallback — falls back to normal sockets if the zerg server isn't available
--zerg-server — enables the zerg server on the specified UNIX socket

--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 the cron command to complete
--legion-cron — adds a cron task that's only runnable when the instance is a lord of the specified legion 👑
--cron-legion — adds a cron task that's only runnable when the instance is a lord of the specified legion
--unique-legion-cron — adds a unique cron task that's only runnable when the instance is a lord of the specified legion
--unique-cron-legion — adds a unique cron task that's only runnable when the instance is a lord of the specified legion
--loop — select the uWSGI loop engine 🔁
--loop-list — lists the enabled loop engines
--loops-list — lists the enabled loop engines
--worker-exec — runs the specified command 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 (the command has to not go in background); when the daemon dies, the master dies too 💀
--smart-attach-daemon — attaches a command/daemon to the master process managed by a pidfile (the command has to daemonize)
--smart-attach-daemon2 — attaches a command/daemon to the master process managed by a pidfile (the command has to NOT daemonize)
--legion-attach-daemon — same as --attach-daemon but the daemon runs only on the legion lord node
--legion-smart-attach-daemon — same as --smart-attach-daemon but the daemon runs only on the legion lord node
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2 but the daemon runs only on the legion lord node
--daemons-honour-stdin — don't change the stdin of external daemons to /dev/null
--attach-daemon2 — the attach-daemon keyval variant (supports smart modes too)

--plugins — loads uWSGI plugins 🧩
--plugin — loads uWSGI plugins
--need-plugins — loads uWSGI plugins (and exits on error)
--need-plugin — loads uWSGI plugins (and exits on error)
--plugins-dir — adds a directory to the uWSGI plugin search path
--plugin-dir — adds a directory to the uWSGI plugin search path
--plugins-list — lists the enabled plugins
--plugin-list — lists the enabled plugins
--autoload — tries to automatically load plugins when unknown options show up
--dlopen — blindly loads a shared library 🙈
--allowed-modifiers — comma separated list of allowed modifiers
--remap-modifier — remaps a request modifier from one id to another
--dump-options — dumps the full list of available options
--show-config — shows the current config reformatted as ini
--binary-append-data — returns the content of a resource to stdout for appending to a uwsgi binary (for data:// usage)
--print — simple print 🖨️
--iprint — simple print (immediate version)
--exit — force exit() of the instance
--cflags — reports uWSGI CFLAGS (useful for building external plugins)
--dot-h — dumps the uwsgi.h used for building the core (useful for building external plugins)
--config-py — dumps the uwsgiconfig.py used for building the core (useful for building external plugins)
--build-plugin — builds a uWSGI plugin for the current binary
--version — prints the uWSGI version
--response-headers-limit — sets the response header maximum size (default: 64k)

and that's a wrap bestie, the whole options list ate and left no crumbs 💅✨

tiny lil' footnote so u know where this came from: this is uwsgi_router_access from the 2.0.31-debian era, dated July 2026, section UWSGI_ROUTER_ACCESS(1) of the manual. stay iconic, go read your man pages, mwah 🎀🦋💖

📦 where this page comes from

ubuntu stonking: uwsgi-plugin-router-access 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