UWSGI_GEOIP(1)

📦

version 2.0.31 · 7 versions

, in ubuntu stonking

✨ UWSGI_GEOIP(1) ✨

User Commands 🫶

🌸 NAME 🌸

bestie, meet uwsgi_geoip — fast (pure C), self-healing, developer-friendly WSGI server 💅

📜 SYNOPSIS 📜

okay so the whole run is literally just this, no cap:

uwsgi-core [options...]

💖 DESCRIPTION 💖

okay so this is the big one, bestie. Every option, flag, alias, and little technical nugget is right here — no skipping, no summarising, periodt. 🎀✨

-s, --socket — bind to the specified UNIX/TCP socket using default protocol 💅
-s, --uwsgi-socket — bind to the specified UNIX/TCP socket using uwsgi protocol 💖
--suwsgi-socket — bind to the specified UNIX/TCP socket using uwsgi protocol over SSL 🔥
--ssl-socket — bind to the specified UNIX/TCP socket using uwsgi protocol over SSL 😭
--http-socket — bind to the specified UNIX/TCP socket using HTTP protocol 🌈
--http-socket-modifier1 — force the specified modifier1 when using HTTP protocol ✨
--http-socket-modifier2 — force the specified modifier2 when using HTTP protocol 💫
--http11-socket — bind to the specified UNIX/TCP socket using HTTP 1.1 (Keep-Alive) protocol 🦋
--https-socket — bind to the specified UNIX/TCP socket using HTTPS protocol 🔐
--https-socket-modifier1 — force the specified modifier1 when using HTTPS protocol 💅
--https-socket-modifier2 — force the specified modifier2 when using HTTPS protocol 🎀
--fastcgi-socket — bind to the specified UNIX/TCP socket using FastCGI protocol ⚡
--fastcgi-nph-socket — bind to the specified UNIX/TCP socket using FastCGI protocol (nph mode) 💥
--fastcgi-modifier1 — force the specified modifier1 when using FastCGI protocol 🌀
--fastcgi-modifier2 — force the specified modifier2 when using FastCGI protocol 🌸
--scgi-socket — bind to the specified UNIX/TCP socket using SCGI protocol 🧚
--scgi-nph-socket — bind to the specified UNIX/TCP socket using SCGI protocol (nph mode) 💜
--scgi-modifier1 — force the specified modifier1 when using SCGI protocol ⭐
--scgi-modifier2 — force the specified modifier2 when using SCGI protocol 🍓
--raw-socket — bind to the specified UNIX/TCP socket using RAW protocol 🪄
--raw-modifier1 — force the specified modifier1 when using RAW protocol 🧁
--raw-modifier2 — force the specified modifier2 when using RAW protocol 💎
--puwsgi-socket — bind to the specified UNIX/TCP socket using persistent uwsgi protocol (puwsgi) 🪩
--protocol — force the specified protocol for default sockets 🛠️
--socket-protocol — force the specified protocol for default sockets 🔧
--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 👑
--thunder-lock — serialize accept() usage (if possible) ⚡
-t, --harakiri — set harakiri timeout 🗡️
--harakiri-verbose — enable verbose mode for harakiri 📢
--harakiri-graceful-timeout — interval between 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 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 💀
--backtrace-depth — set backtrace depth 🔍
--mule-harakiri — set harakiri timeout for mule tasks 🐴
-x, --xmlconfig — load config from xml file 📄
-x, --xml — load config from xml file 📃
--config — load configuration using the pluggable system 🧩
--fallback-config — re-exec uwsgi with the specified config when exit code is 1 🔁
--strict — enable strict mode (placeholder cannot be used) ⚠️
--skip-zero — skip check of file descriptor 0 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 hostname against a regular expression 🧬
--if-not-hostname-match — (opt logic) try to match hostname against a regular expression 🚫🧬
--if-exists — (opt logic) check for file/directory existence 📁
--if-not-exists — (opt logic) check for file/directory existence 🚫📁
--ifexists — (opt logic) check for file/directory existence 🗂️
--if-plugin — (opt logic) check for plugin 🔌
--if-not-plugin — (opt logic) check for plugin 🚫🔌
--ifplugin — (opt logic) check for plugin 🧩
--if-file — (opt logic) check for file existence 📄
--if-not-file — (opt logic) check for file existence 🚫📄
--if-dir — (opt logic) check for directory existence 📂
--if-not-dir — (opt logic) check for directory existence 🚫📂
--ifdir — (opt logic) check for directory existence 🗃️
--if-directory — (opt logic) check for directory existence 📁✨
--endif — (opt logic) end if 🔚
--end-if — (opt logic) end if 🏁
--blacklist — set options blacklist context ⛔
--end-blacklist — clear options blacklist context 🧼
--whitelist — set options whitelist context ✅
--end-whitelist — clear options whitelist context 🧽
--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) 1️⃣
--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 😈
--emperor-pidfile — write the Emperor pid in the specified file. 👑💖
--emperor-tyrant — put the Emperor in Tyrant mode. 💅👑
--emperor-tyrant-nofollow — do not follow symlinks when checking for uid/gid in Tyrant mode. 🚫🔗
--emperor-stats — run the Emperor stats server. 📊👑
--emperor-stats-server — run the Emperor stats server. 📊👑
--early-emperor — spawn the emperor as soon as possible. ⏰👑
--emperor-broodlord — run the emperor in BroodLord mode. 🦋👑
--emperor-throttle — set throttling level (in milliseconds) for bad behaving vassals (default 1000). 😤⏱️
--emperor-max-throttle — set max throttling level (in milliseconds) for bad behaving vassals (default 3 minutes). 😤⏱️
--emperor-magic-exec — prefix vassals config files with exec:// if they have the executable bit. ✨📁
--emperor-on-demand-extension — search for text file (vassal name + extension) containing the on demand socket name. 🔍📄
--emperor-on-demand-ext — search for text file (vassal name + extension) containing the on demand socket name. 🔍📄
--emperor-on-demand-directory — enable on demand mode binding to the unix socket in the specified directory named like the vassal + .socket. 🔌📂
--emperor-on-demand-dir — enable on demand mode binding to the unix socket in the specified directory named like the vassal + .socket. 🔌📂
--emperor-on-demand-exec — use the output of the specified command as on demand socket name (the vassal name is passed as the only argument). 🏃‍♀️🔌
--emperor-extra-extension — allows the specified extension in the Emperor (vassal will be called with --config). 🎀📄
--emperor-extra-ext — allows the specified extension in the Emperor (vassal will be called with --config). 🎀📄
--emperor-no-blacklist — disable Emperor blacklisting subsystem. 🚫📝
--emperor-use-clone — use clone() instead of fork() passing the specified unshare() flags. 👯‍♀️🔧
--emperor-graceful-shutdown — use vassals graceful shutdown during ragnarok. 🌈💀
--emperor-cap — set vassals capability. 🧢
--vassals-cap — set vassals capability. 🧢
--vassal-cap — set vassals capability. 🧢
--imperial-monitor-list — list enabled imperial monitors. 👀📋
--imperial-monitors-list — list enabled imperial monitors. 👀📋
--vassals-inherit — add config templates to vassals config (uses --inherit). 🧬📄
--vassals-include — include config templates to vassals config (uses --include instead of --inherit). 📥📄
--vassals-inherit-before — add config templates to vassals config (uses --inherit, parses before the vassal file). 🧬⏮️
--vassals-include-before — include config templates to vassals config (uses --include instead of --inherit, parses before the vassal file). 📥⏮️
--vassals-start-hook — run the specified command before each vassal starts. 🏁🪝
--vassals-stop-hook — run the specified command after vassal's death. ⚰️🪝
--vassal-sos — ask emperor for reinforcement when overloaded. 🆘👑
--vassal-sos-backlog — ask emperor for sos if backlog queue has more items than the value specified. 🆘📦
--vassals-set — automatically set the specified option (via --set) for every vassal. ⚙️👯
--vassal-set — automatically set the specified option (via --set) 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 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. 🆘💖
--print-sym — print content of the specified binary symbol. 🔣🔍
--print-symbol — print content of the specified binary symbol. 🔣🔍
-r|--reaper — call waitpid(-1,...) after each request to get rid of zombies. 🧟‍♀️⚰️
-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 — number of seconds worker must run before being reloaded (default is 10). ⏱️👷
--max-worker-lifetime — reload workers after the specified amount 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 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() for avoiding duplicates. 🔑📡
--persistent-ipcsem — do not remove ipcsem's on shutdown. 🚫🧹
-A|--sharedarea — create a raw shared memory area of specified pages (note: it supports keyval too). 🧠📦
--safe-fd — do not close the specified file descriptor. 🚫🔒
--fd-safe — do not close the specified file descriptor. 🚫🔒
--cache — create a shared cache containing given elements. 🎀📦
--cache-blocksize — set cache blocksize. 🎀📏
--cache-store — enable persistent cache to disk. 🎀💾
--cache-store-sync — set frequency of sync for persistent cache. 🎀🔄
--cache-no-expire — disable auto sweep of expired items. 🎀🚫🧹
--cache-expire-freq — set the frequency of cache sweeper scans (default 3 seconds). 🎀🧹⏱️
--cache-report-freed-items — constantly report the cache item freed by the sweeper (use only for debug). 🎀🐛
--cache-udp-server — bind the cache udp server (used only for set/update/delete) to the specified socket. 🎀📡
--cache-udp-node — send cache update/deletion to the specified cache udp server. 🎀📤
--cache-sync — copy the whole content of another uWSGI cache server on server startup. 🎀📋
--cache-use-last-modified — update 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 frequency of sync for persistent queue. 📬🔄
-Q|--spooler — run a spooler on the specified directory. 🌸📂
--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 specified directory 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. 🌸⏱️
--mule — add a mule. 🫏
--mules — add the specified number of mules. 🫏🫏
--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. 🔥📦
--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: 64). 📞🔢
-L|--disable-logging — disable request logging. 🚫📝
--flock — lock the specified file before starting, exit if locked. 🔒📁
--flock-wait — lock the specified file before starting, wait if locked. 🔒⏳
--flock2 — lock the specified file after logging/daemon setup, exit if locked. 🔒📁
--flock-wait2 — lock the specified file after logging/daemon setup, wait if 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 specified directory. 🏠🔒
--pivot-root — pivot_root() to the specified directories (new_root and put_old must be separated with a space). 🔄📂
--pivot_root — pivot_root() to the specified directories (new_root and put_old must be separated with 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. 👤⚡
--immediate-gid — setgid to the specified group/gid IMMEDIATELY. 👥⚡
--no-initgroups — disable 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 rootfs change. 🪄🌳
--setns-socket — expose a unix socket returning 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. ⏭️📁
--setns — join a namespace created by an external uWSGI instance. 🚪🌌
--setns-preopen — open /proc/self/ns as soon as possible and cache fds. ⚡📂
--jailed — marks the instance as jailed (fr fr, it forces the execution of post_jail hooks) 💅
--refork — fork() again after privileges drop. Lowkey useful for jailing systems 🦋
--re-fork — same energy: fork() again after privileges drop. Useful for jailing systems ✨
--refork-as-root — fork() again before privileges drop. Useful for jailing systems 👑
--re-fork-as-root — yep, another spelling: fork() again before privileges drop. Useful for jailing systems 💖
--refork-post-jail — fork() again after jailing. Useful for jailing systems 🔥
--re-fork-post-jail — same but with the extra hyphen: 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 enters the accepting phase 👀
--hook-accepting1 — run the specified hook after the first worker enters the accepting phase 🥇
--hook-accepting-once — run the specified hook after each worker enters 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 sends a stop message 🛑
--hook-emperor-reload — run the specified hook when the Emperor sends 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 — same vibe: 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 — the moment that one file gets modified or touched, we fire off a signal. Syntax goes like: file signal 💅
--fs-reload — if the filesystem object you picked gets modified, we do a graceful reload. soft launch energy ✨
--fs-brutal-reload — same trigger, but the reload is brutal. no gentle vibes, just 🪓
--fs-signal — when that filesystem object gets modified, raise a uwsgi signal. Syntax: file signal 🌸
--check-mountpoint — if a filesystem stops being reachable, this destroys the instance. genuinely useful when you want reliable Fuse management 🫶
--mountpoint-check — bestie this is literally the same thing: instance gets destroyed when a filesystem is no more reachable, handy for reliable Fuse management 💖
--check-mount — yep, another twin. filesystem unreachable → instance destroyed. reliable Fuse management stays winning ✨
--mount-check — the fourth and final sibling 🎀 same deal: destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management)
--propagate-touch — described as an over-engineering option for systems with flaky signal management. not me adding features for unreliable boxes 💀
--limit-post — puts a limit on the request body 📏
--no-orphans — if the master dies, workers get automatically killed. but heads up, the manpage says this can be dangerous for availability 😭
--prio — set the priority of processes/threads 👑
--cpu-affinity — set cpu affinity 🧚
--post-buffering — set the size in bytes where we stop keeping things in memory and buffer to disk instead 🌈
--post-buffering-bufsize — sets the buffer size for read() while in post buffering mode ⭐
--body-read-warning — the amount of allowed memory allocation, in megabytes, for a request body before it starts printing a warning. the little "hey bestie…" of memory limits 😭
--upload-progress — turns on creation of .json files in the directory you specify while a file upload is happening 📁
--no-default-app — don't fallback to the default app, periodt 🙅
--manage-script-name — automatically rewrites SCRIPT_NAME and PATH_INFO ✨
--ignore-script-name — ignores SCRIPT_NAME entirely 🙈
--catch-exceptions — reports the exception as http output. discouraged, the manpage says use it only for testing 👀
--reload-on-exception — an exception pops off → the worker reloads 💥
--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) gets raised 🦋
--exception-handler — add an exception handler 🫶
--enable-metrics — turns on the metrics subsystem 📊
--metric — add a custom metric ✨
--metric-threshold — add a metric threshold/alarm 🚨
--metric-alarm — same thing, different name: add a metric threshold/alarm 🚨
--alarm-metric — and again, third alias: add a metric threshold/alarm 🚨

--metrics-dir — exports metrics as text files into the directory you specify 📂
--metrics-dir-restore — restores the last value taken from the metrics dir ♻️
--metric-dir — alias moment: export metrics as text files to the specified directory 📂
--metric-dir-restore — alias moment again: restore last value taken from the metrics dir ♻️
--metrics-no-cores — disables generation of 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 — yes bestie, same: enable the stats server on the specified address 👑
--stats-http — prefixes the stats server json output with http headers 🧚
--stats-minified — minifies the statistics json output ✨
--stats-min — the short king version: minify statistics json output ✨
--stats-push — pushes the stats json to the destination you specify 🚀
--stats-pusher-default-freq — sets the default frequency of stats pushers ⏰
--stats-pushers-default-freq — the plural twin: set the default frequency of stats pushers ⏰
--stats-no-cores — disables generation of cores-related stats ✂️
--stats-no-metrics — do not include metrics in the stats output 🚫
--multicast — subscribes to the multicast group you specify 📻
--multicast-ttl — set the multicast ttl ⏳
--multicast-loop — set multicast loop, and the default is 1 🔁
--master-fifo — enables the master fifo 🎀
--notify-socket — enables the notification socket 🔔
--subscription-notify-socket — sets the notification socket for subscriptions 🔔

--legion — you become a member of a legion ⚔️
--legion-mcast — become a member of a legion, and this one is a 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, it declares itself a dead node for however many seconds you specified 💀
--legion-skew-tolerance — set the clock skew tolerance of the legion subsystem, default is 60 seconds ⏰
--legion-lord — the action to call on Lord election 👑
--legion-unlord — the action to call on Lord dismiss 👋
--legion-setup — the action to call on legion setup 🛠️
--legion-death — the action to call on legion death, which is the shutdown of the instance 💀
--legion-join — the action to call on legion join, meaning the first time quorum is reached 🎉
--legion-node-joined — the action to call when a new node joins the legion 🫂
--legion-node-left — the action to call when a node leaves the legion 👋
--legion-quorum — 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 the 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 — the lil abbreviation: subscribe to the specified subscription server 📬
--subscribe — yeah, same vibe: subscribe to the specified subscription server 📬
--subscribe2 — subscribes to the subscription server you specify, but using advanced keyval syntax ✨
--subscribe-freq — sends the subscription announce at the interval you specify ⏰
--subscription-tolerance — set tolerance for subscription servers 🫶
--unsubscribe-on-graceful-reload — forces the unsubscribe request even during a graceful reload ✂️
--start-unsubscribed — configures subscriptions but does not send them, which is useful with master fifo 🤐
--subscribe-with-modifier1 — forces the specified modifier1 when subscribing 🎯

--snmp — enables 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 — checks for cert/key/client_ca files in the directory you specify and creates a sni/ssl context on demand 🪄
--sni-dir-ciphers — set the ssl ciphers for the sni-dir option 🔐
--ssl-enable3 — enables SSLv3, and bestie it is flagged (insecure) 😭
--ssl-enable-sslv3 — also enables SSLv3, also (insecure) 😭
--ssl-enable-tlsv1 — enables TLSv1, and yes, also flagged (insecure) 😭
--ssl-option — set a raw ssl option, value must be numeric 🔢
--sni-regexp — add an SNI-governed SSL context, except the key is a regexp 🧠
--ssl-tmp-dir — store ssl-related temp files in the directory you specify 🗂️
--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, and this happens before privileges drop 🩹
--unprivileged-binary-patch — patch the uwsgi binary with a new command, this time 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, and heads up, this requires root privileges 👑

--logto — set the logfile or udp address 📝
--logto2 — log to the file or udp address you specify, but after privileges drop 📝
--log-format — set an advanced format for request logging ✨
--logformat — the shorter name, same energy: set advanced format for request logging ✨
--logformat-strftime — applies strftime to the logformat output 🕰️
--log-format-strftime — the dashed twin: apply strftime to logformat output 🕰️
--logfile-chown — chown the logfiles 🧑‍⚖️
--logfile-chmod — chmod the logfiles 🔐
--log-syslog — log to syslog 📮
--log-socket — send logs to the socket you specify 🔌
--req-logger — set or append a request logger 🪵
--logger-req — flipped name, same job: set/append a request logger 🪵
--logger — set or append a logger 🪵
--logger-list — list the enabled loggers 📋
--loggers-list — plural version, same thing: list enabled loggers 📋
--threaded-logger — offloads 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 — drains, meaning it does not show, log lines matching the regexp you specify 🚰
--log-filter — shows only the log lines matching the regexp you specify 🔎
--log-route — logs to the named logger you specify if the regexp applied on the logline matches 🎯
--log-req-route — logs requests to the named logger you specify if the regexp applied on the logline matches 🎯
--use-abort — calls abort() on segfault/fpe, which the manpage says could be useful for generating a core dump 💥
--alarm — create a new alarm. Syntax: <alarm> <plugin:args> 🚨
--alarm-cheap — bestie, use the main alarm thread instead of spinning up dedicated threads for curl-based alarms ✨
--alarm-freq — tune the anti-loop alarm system (the default is 3 seconds, periodt)
--alarm-fd — raise the specified alarm when an fd is read for read. by default it reads 1 byte, so 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 (same energy, different name, slay)
--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 (the twin fr fr)
--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 (another alias, obsessed)
--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 (yes, that's six names for the same vibe, iykyk)
--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> 🙈
--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)
--log-master — delegate logging to the master process 💖
--log-master-bufsize — set the buffer size for the master logger. heads up: bigger log messages will be truncated ✂️
--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
--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
--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)
--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
--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-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
--clocks-list — shows you all the clocks that are enabled, bestie 💅
--add-header — auto-adds HTTP headers onto the response for you, no manual labour ✨
--rem-header — auto-removes whatever HTTP header you point at from the response
--del-header — also auto-removes the HTTP header you specify from the response (yeah, it's the same job as --rem-header, they're twins 🫶)
--collect-header — stashes that response header into a request var (syntax: header var)
--response-header-collect — same energy, sorry, same job: stash the response header into a request var (syntax: header var)
--pull-header — stashes the response header into a request var and yanks it out of the response entirely (syntax: header var)
--check-static — looks for static files in the directory you gave it
--check-static-docroot — looks for static files in the requested DOCUMENT_ROOT
--static-check — literally just --check-static's twin: looks for static files in the specified directory
--static-map — maps a mountpoint to a static directory (or a file, we're flexible 💁)
--static-map2 — like --static-map but it fully appends the requested resource onto the docroot
--static-skip-ext — skips that one extension when doing static file checks
--static-index — if someone requests a directory, it goes hunting for the file you named
--static-safe — skips the security checks when the file lives under the path you specified
--static-cache-paths — drops resolved paths into the uWSGI cache for however many seconds you want
--static-cache-paths-name — uses the cache you named for those static paths
--mimefile — sets the mime types file path (default /etc/mime.types)
--mime-file — yep, same thing: 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 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 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 PATH_INFO regexp and file mtime
--static-gzip — if your regexp matches the static file translation, it'll go look for a gzip version 🎀
--static-gzip-all — checks for a gzip version of every requested static file
--static-gzip-dir — checks for a gzip version of all requested static files in that dir/prefix
--static-gzip-prefix — same deal, checks for a gzip version of all requested static files in the specified dir/prefix
--static-gzip-ext — checks for a gzip version of all requested static files with the ext/suffix you gave
--static-gzip-suffix — and again: checks for a gzip version of all requested static files with the specified ext/suffix
--honour-range — turns on support for the HTTP Range header 🔥
--offload-threads — sets how many offload threads to spawn (per-worker, default 0)
--offload-thread — the singular twin: sets how many offload threads to spawn (per-worker, default 0)
--file-serve-mode — sets the static file serving mode
--fileserve-mode — and its twin sets the static file serving mode too
--disable-sendfile — kills sendfile() and makes it rely on the boring old read()/write() 😴
--check-cache — checks for response data in the cache you named (leave it empty for the default cache)
--close-on-exec — sets close-on-exec on connection sockets (could be required if you're spawning processes inside requests 👀)
--close-on-exec2 — sets close-on-exec on server sockets (also possibly 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 it's running late fr fr
--unenv — unsets an environment variable
--vacuum — tries to remove every generated file/socket so nothing's left lying around 🧹✨
--file-write — writes the content you give to the file you give (syntax: file=value) before privileges get dropped
--cgroup — shoves the processes into the cgroup you specified
--cgroup-opt — sets a value in the specified cgroup option
--cgroup-dir-mode — sets the permission for the cgroup directory (default is 700)
--namespace — runs in a new namespace under the specified rootfs
--namespace-keep-mount — keeps that mountpoint around inside your namespace
--ns — same vibe: runs in a new namespace under the specified rootfs
--namespace-net — adds a network namespace
--ns-net — also adds a network namespace
--enable-proxy-protocol — enables PROXY1 protocol support (only for http parsers, heads up 💀)
--reuse-port — enables the REUSE_PORT flag on the socket (BSD only!)
--tcp-fast-open — enables the TCP_FASTOPEN flag on TCP sockets with the qlen value you give
--tcp-fastopen — same one, enables the TCP_FASTOPEN flag on TCP sockets with the specified qlen value
--tcp-fast-open-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if that's supported
--tcp-fastopen-client — also uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported
--zerg — attaches to a zerg server
--zerg-fallback — falls back to normal sockets if the zerg server isn't there
--zerg-server — enables the zerg server on the UNIX socket you specified
--cron — adds a cron task
--cron2 — adds a cron task with the key=val syntax
--unique-cron — adds a unique cron task ✨
--cron-harakiri — sets the max time (in seconds) we wait for a cron command to finish
--legion-cron — adds a cron task that only runs when this instance is a lord of the specified legion 👑
--cron-legion — same one, 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 — and this one adds a unique cron task runnable only when the instance is a lord of the specified legion
--loop — selects the uWSGI loop engine
--loop-list — lists enabled loop engines
--loops-list — also lists enabled loop engines, plural bestie
--worker-exec — runs the command you give as a worker
--worker-exec2 — runs the specified command as worker (but after the post_fork hook, fancy)
--attach-daemon — attaches a command/daemon to the master process (and the command must NOT go into background, ok?)
--attach-control-daemon — attaches a command/daemon to the master process (again, command must not background it), and when the daemon dies the master dies too 🫠
--smart-attach-daemon — attaches a command/daemon to the master managed by a pidfile (this time the command HAS to daemonize)
--smart-attach-daemon2 — attaches a command/daemon to the master managed by a pidfile (and here the command has to NOT daemonize)
--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 runs only on the legion lord node
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2 but the daemon runs only on the legion lord node
--daemons-honour-stdin — does not change the stdin of external daemons over to /dev/null
--attach-daemon2 — the attach-daemon keyval variant (it supports smart modes too, slay)
--plugins — loads uWSGI plugins
--plugin — loads uWSGI plugins (yes, the singular one)
--need-plugins — loads uWSGI plugins and exits on error, no silent fails here
--need-plugin — loads uWSGI plugins (exit on error), 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 thing
--plugins-list — lists enabled plugins
--plugin-list — lists enabled plugins, plural/singular chaos 🌈
--autoload — tries to automatically load plugins whenever unknown options show up
--dlopen — blindly loads a shared library 🙈
--allowed-modifiers — a comma separated list of allowed modifiers
--remap-modifier — remaps a request modifier from one id to another
--dump-options — dumps the full list of available options
--show-config — shows the current config, reformatted as ini
--binary-append-data — returns the content of a resource to stdout so it can be appended to a uwsgi binary (for data:// usage)
--print — simple print
--iprint — simple print, but the immediate version
--exit — forces exit() on the instance, bye bestie 👋
--cflags — reports uWSGI CFLAGS (so useful when you're building external plugins 💅)
--dot-h — dumps the uwsgi.h used for building the core (also useful for building external plugins)
--config-py — dumps the uwsgiconfig.py used for building the core (useful for building external plugins too)
--build-plugin — builds a uWSGI plugin for the current binary
--version — prints the uWSGI version
--response-headers-limit — sets the response header maximum size (default: 64k)

and that's the whole list, bestie, we made it 🎀 periodt 💖 no cap, this page is from uwsgi_geoip version 2.0.31-debian, dated July 2026, and it's the UWSGI_GEOIP(1) manual — go forth and configure responsibly, you absolute icon 👑✨

📦 where this page comes from

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