UWSGI_LDAP(1)

📦

version 2.0.31 · 7 versions

💖 UWSGI_LDAP(1) 💖

okay so this page is UWSGI_LDAP(1), and it lives in the User Commands manual. Buckle up bestie, we're about to go through every single option and it's a lot, but it's all here, no cap. ✨

✨ NAME ✨

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

🦋 SYNOPSIS 🦋

uwsgi-core [options...]

💅 DESCRIPTION 💅

okay so literally every flag and option is about to be listed, and yes, we're keeping all of them. every single one. periodt. 🫶

-s, --socket — binds to the specified UNIX/TCP socket using default protocol. 💖
-s, --uwsgi-socket — binds to the specified UNIX/TCP socket using uwsgi protocol.
--suwsgi-socket — binds to the specified UNIX/TCP socket using uwsgi protocol over SSL. 🔒
--ssl-socket — binds to the specified UNIX/TCP socket using uwsgi protocol over SSL. same energy.
--http-socket — binds to the specified UNIX/TCP socket using HTTP protocol. 🌐
--http-socket-modifier1 — forces the specified modifier1 when using HTTP protocol.
--http-socket-modifier2 — forces the specified modifier2 when using HTTP protocol.
--http11-socket — binds to the specified UNIX/TCP socket using HTTP 1.1 (Keep-Alive) protocol.
--https-socket — binds to the specified UNIX/TCP socket using HTTPS protocol. 🔐
--https-socket-modifier1 — forces the specified modifier1 when using HTTPS protocol.
--https-socket-modifier2 — forces the specified modifier2 when using HTTPS protocol.
--fastcgi-socket — binds to the specified UNIX/TCP socket using FastCGI protocol.
--fastcgi-nph-socket — binds to the specified UNIX/TCP socket using FastCGI protocol (nph mode). 😎
--fastcgi-modifier1 — forces the specified modifier1 when using FastCGI protocol.
--fastcgi-modifier2 — forces the specified modifier2 when using FastCGI protocol.
--scgi-socket — binds to the specified UNIX/TCP socket using SCGI protocol.
--scgi-nph-socket — binds to the specified UNIX/TCP socket using SCGI protocol (nph mode).
--scgi-modifier1 — forces the specified modifier1 when using SCGI protocol.
--scgi-modifier2 — forces the specified modifier2 when using SCGI protocol.
--raw-socket — binds to the specified UNIX/TCP socket using RAW protocol.
--raw-modifier1 — forces the specified modifier1 when using RAW protocol.
--raw-modifier2 — forces the specified modifier2 when using RAW protocol.
--puwsgi-socket — binds to the specified UNIX/TCP socket using persistent uwsgi protocol (puwsgi).
--protocol — forces the specified protocol for default sockets.
--socket-protocol — forces the specified protocol for default sockets. twin behavior fr fr.
--shared-socket — creates a shared socket for advanced jailing or ipc.
--undeferred-shared-socket — creates a shared socket for advanced jailing or ipc (undeferred mode).
-p, --processes — spawns the specified number of workers/processes.
-p, --workers — spawns the specified number of workers/processes. yes same -p, iconic.
--thunder-lock — serializes accept() usage (if possible).
-t, --harakiri — sets harakiri timeout. ⏳
--harakiri-verbose — enables verbose mode for harakiri.
--harakiri-graceful-timeout — interval between graceful harakiri attempt and a sigkill.
--harakiri-graceful-signal — uses this signal instead of sigterm for graceful harakiri attempts.
--harakiri-queue-threshold — only triggers harakiri if queue is greater than this threshold.
--harakiri-no-arh — does not enable harakiri during after-request-hook.
--no-harakiri-arh — does not enable harakiri during after-request-hook.
--no-harakiri-after-req-hook — does not enable harakiri during after-request-hook.
--backtrace-depth — sets backtrace depth.
--mule-harakiri — sets harakiri timeout for mule tasks.
-x, --xmlconfig — loads config from xml file.
-x, --xml — loads config from xml file.
--config — loads configuration using the pluggable system.
--fallback-config — re-execs uwsgi with the specified config when exit code is 1.
--strict — enables strict mode (placeholder cannot be used).
--skip-zero — skips check of file descriptor 0.
--skip-atexit — skips atexit hooks (ignored by the master).
--skip-atexit-teardown — skips atexit teardown (ignored by the master).
-S, --set — sets a placeholder or an option.
--set-placeholder — sets a placeholder.
--set-ph — sets a placeholder.
--get — prints the specified option value and exits.
--declare-option — declares a new uWSGI custom option.
--declare-option2 — declares a new uWSGI custom option (non-immediate).
--resolve — places 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 — sets options blacklist context.
--end-blacklist — clears options blacklist context.
--whitelist — sets options whitelist context.
--end-whitelist — clears options whitelist context.
--ignore-sigpipe — does not report (annoying) SIGPIPE.
--ignore-write-errors — does not report (annoying) write()/writev() errors.
--write-errors-tolerance — sets the maximum number of allowed write errors (default: no tolerance).
--write-errors-exception-only — only raises an exception on write errors giving control to the app itself.
--disable-write-exception — disables exception generation on write()/writev().
--inherit — uses the specified file as config template.
--include — includes the specified file as immediate configuration.
--inject-before — injects a text file before the config file (advanced templating).
--inject-after — injects a text file after the config file (advanced templating).
-d, --daemonize — daemonizes uWSGI. 👻
--daemonize2 — daemonizes uWSGI after app loading.
--stop — stops an instance. 🛑
--reload — reloads an instance.
--pause — pauses an instance.
--suspend — suspends an instance.
--resume — resumes an instance.
--connect-and-read — connects to a socket and waits for data from it.
--extract — fetches/dumps any supported address to stdout.
-l, --listen — sets the socket listen queue size.
-v, --max-vars — sets the amount of internal iovec/vars structures.
--max-apps — sets the maximum number of per-worker applications.
-b, --buffer-size — sets internal buffer size.
-m, --memory-report — enables memory report.
--profiler — enables the specified profiler.
-c, --cgi-mode — forces CGI-mode for plugins supporting it.
-a, --abstract-socket — forces UNIX socket in abstract mode (Linux only). 🐧
-C, --chmod-socket — chmod-socket.
-C, --chmod — chmod-socket.
--chown-socket — chown unix sockets.
--umask — sets umask.
--freebind — puts socket in freebind mode.
--map-socket — maps sockets to specific workers.
-T, --enable-threads — enables threads (stub option this is true by default).
--no-threads-wait — does not wait for threads cancellation on quit/reload.
--auto-procname — automatically sets processes name to something meaningful.
--procname-prefix — adds a prefix to the process names.
--procname-prefix-spaced — adds a spaced prefix to the process names.
--procname-append — appends a string to process names.
--procname — sets process names.
--procname-master — sets master process name.
-i, --single-interpreter — does not use multiple interpreters (where available).
--need-app — exits if no app can be loaded.
-M, --master — enables master process. 👑
--honour-stdin — does not remap stdin to /dev/null.
--emperor — runs the Emperor.
--emperor-proxy-socket — forces the vassal to became an Emperor proxy.
--emperor-wrapper — sets a binary wrapper for vassals.
--emperor-wrapper-override — sets a binary wrapper for vassals to try before the default one.
--emperor-wrapper-fallback — sets a binary wrapper for vassals to try as a last resort.
--emperor-nofollow — does not follow symlinks when checking for mtime.
--emperor-procname — sets the Emperor process name.
--emperor-freq — sets the Emperor scan frequency (default 3 seconds).
--emperor-required-heartbeat — sets the Emperor tolerance about heartbeats.
--emperor-curse-tolerance — sets the Emperor tolerance about cursed vassals. 💀
--emperor-pidfile — writes the Emperor's pid into the file you point at 💖 classic move, keeps that imperial ID on paper.
--emperor-tyrant — puts the Emperor into Tyrant mode 👑 dramatic name, dramatic behavior.
--emperor-tyrant-nofollow — in Tyrant mode, when it's checking for uid/gid, it will not follow symlinks. no shortcuts, bestie 🙈
--emperor-stats — runs the Emperor stats server ✨ numbers, but for royalty.
--emperor-stats-server — also runs the Emperor stats server. same energy, different spelling of the flag 🫶
--early-emperor — spawns the emperor as soon as possible ⚡ no waiting around, she's eager.
--emperor-broodlord — runs the emperor in BroodLord mode. that's the name. yes really. iconic 💅
--emperor-throttle — sets the throttling level, in milliseconds, for badly behaved vassals. default is 1000 🕐 misbehave and you get slowed down, fr fr.
--emperor-max-throttle — sets the max throttling level, in milliseconds, for badly behaved vassals. default is 3 minutes 😭 the ceiling of the timeout zone.
--emperor-magic-exec — prefixes vassals' config files with exec:// if they have the executable bit ✨ magic indeed.
--emperor-on-demand-extension — searches for a text file named vassal name + extension that contains the on demand socket name 🔍
--emperor-on-demand-ext — same thing, shorter flag: searches for a text file (vassal name + extension) holding the on demand socket name 🎀
--emperor-on-demand-directory — turns on on demand mode, binding to the unix socket in the specified directory, named like the vassal + .socket 🦋
--emperor-on-demand-dir — yep, the short version of that: on demand mode, unix socket in the given directory, named like the vassal + .socket 💜
--emperor-on-demand-exec — uses the output of the specified command as the on demand socket name; the vassal name gets passed as the only argument 🫡
--emperor-extra-extension — allows the specified extension in the Emperor; the vassal gets called with --config 🌸
--emperor-extra-ext — the abbreviated twin: allows the specified extension in the Emperor, vassal called with --config ⭐
--emperor-no-blacklist — disables the Emperor blacklisting subsystem 🚫
--emperor-use-clone — uses clone() instead of fork(), passing the specified unshare() flags 🧬
--emperor-graceful-shutdown — makes it use vassals graceful shutdown during ragnarok 💀 yes, ragnarok is the actual word. end times, but politely.
--emperor-cap — sets vassals capability ✨
--vassals-cap — sets vassals capability (same thing, plural-flavored) 💖
--vassal-cap — sets vassals capability (same thing, singular-flavored) 🎀

--imperial-monitor-list — lists the enabled imperial monitors 👑
--imperial-monitors-list — also lists the enabled imperial monitors. one letter of difference, same list 🌈
--vassals-inherit — adds config templates to vassals' config, using --inherit 🧚
--vassals-include — includes config templates into vassals' config, using --include instead of --inherit 💜
--vassals-inherit-before — adds config templates to vassals' config using --inherit, but parses them before the vassal file ⏮️
--vassals-include-before — includes config templates into vassals' config using --include instead of --inherit, parsed before the vassal file ⏪
--vassals-start-hook — runs the specified command before each vassal starts 🏁
--vassals-stop-hook — runs the specified command after a vassal's death 🪦
--vassal-sos — asks the emperor for reinforcement when overloaded 🆘
--vassal-sos-backlog — asks the emperor for an SOS if the backlog queue has more items than the value specified 😰
--vassals-set — automatically sets the specified option (via --set) for every vassal 🎁
--vassal-set — same deal, singular flag: automatically sets the specified option (via --set) for every vassal 💖
--heartbeat — announces healthiness to the emperor 💓
--reload-mercy — sets the max time in seconds we wait for workers and other processes to die during reload/shutdown 🕰️
--worker-reload-mercy — sets the max time in seconds a worker can take to reload/shutdown. default is 60 😌
--mule-reload-mercy — sets the max time in seconds a mule can take to reload/shutdown. default is 60 🐴
--exit-on-reload — forces exit even if a reload was requested 🚪
--die-on-term — exit instead of doing a brutal reload on SIGTERM ⚰️
--force-gateway — forces the spawn of the first registered gateway without a master 🚀
-h|--help — shows this help 🫶
-h|--usage — shows this help (yes, same -h, different long name) ✨

--print-sym — prints the content of the specified binary symbol 🔍
--print-symbol — prints the content of the specified binary symbol (longer flag, same output) 💅
-r|--reaper — calls waitpid(-1,...) after each request to get rid of zombies 🧟 no cap, it's a zombie cleanup service.
-R|--max-requests — reloads workers after the specified amount of managed requests 🔄
--max-requests-delta — adds (worker_id * delta) to the max_requests value of each worker 🧮
--min-worker-lifetime — number of seconds a worker must run before being reloaded. default is 10 ⏳
--max-worker-lifetime — reloads workers after the specified amount of seconds. default is disabled 🚫
--max-worker-lifetime-delta — adds (worker_id * delta) seconds to the max_worker_lifetime value of each worker 🧮
-z|--socket-timeout — sets the internal sockets timeout ⏱️
--no-fd-passing — disables file descriptor passing 🚫
--locks — creates the specified number of shared locks 🔐
--lock-engine — sets the lock engine ⚙️
--ftok — sets the ipcsem key via ftok() for avoiding duplicates 🔑
--persistent-ipcsem — does not remove ipcsem's on shutdown 🫶 they stay.
-A|--sharedarea — creates a raw shared memory area of the 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 (same safety, flags swapped around) 💖

--cache — creates a shared cache containing the given elements 🗃️
--cache-blocksize — sets the cache blocksize 📦
--cache-store — enables a persistent cache to disk 💾
--cache-store-sync — sets the frequency of sync for the persistent cache 🔁
--cache-no-expire — disables the auto sweep of expired items 🧹❌
--cache-expire-freq — sets the frequency of cache sweeper scans. default is 3 seconds ⏲️
--cache-report-freed-items — constantly reports the cache item freed by the sweeper. use only for debug 🐛
--cache-udp-server — binds the cache udp server (used only for set/update/delete) to the specified socket 📡
--cache-udp-node — sends cache update/deletion to the specified cache udp server 📤
--cache-sync — copies the whole content of another uWSGI cache server on server startup 📋
--cache-use-last-modified — updates the last_modified_at timestamp on every cache item modification. default is disabled 🕐
--add-cache-item — adds an item in the cache ➕
--load-file-in-cache — loads a static file in the cache 📄
--load-file-in-cache-gzip — loads a static file in the cache with gzip compression 🗜️
--cache2 — creates a new generation shared cache (keyval syntax) 🌱
--queue — enables the shared queue 📬
--queue-blocksize — sets the queue blocksize 📐
--queue-store — enables a persistent queue to disk 💾
--queue-store-sync — sets the frequency of sync for the persistent queue 🔁

-Q|--spooler — runs a spooler on the specified directory 🌀
--spooler-external — maps spoolers' requests to a spooler directory managed by an external instance 🌐
--spooler-ordered — tries to order the execution of spooler tasks 📋
--spooler-chdir — chdir()s to the specified directory before each spooler task 📂
--spooler-processes — sets the number of processes for spoolers 👯
--spooler-quiet — do not be verbose with spooler tasks 🤫
--spooler-max-tasks — sets the maximum number of tasks to run before recycling a spooler 🔄
--spooler-harakiri — sets the harakiri timeout for spooler tasks 🗡️
--spooler-frequency — sets the spooler frequency 🎵
--spooler-freq — sets the spooler frequency (short flag, same beat) 🎶
--mule — adds a mule 🐴
--mules — adds the specified number of mules 🐴🐴🐴
--farm — adds a mule farm 🚜
--mule-msg-size — sets the mule message buffer size 📨
--signal — sends a uwsgi signal to a server 📶
--signal-bufsize — sets the buffer size for the signal queue 📥
--signals-bufsize — sets the buffer size for the signal queue (same, plural flag representation) 📤
--signal-timer — adds a timer. syntax: <signal> <seconds> ⏰
--timer — adds a timer. syntax: <signal> <seconds> ⏰ (same timer, less typing)
--signal-rbtimer — adds a redblack timer. syntax: <signal> <seconds> 🌳
--rbtimer — adds a redblack timer. syntax: <signal> <seconds> 🌳 (short flag energy)
--rpc-max — maximum number of rpc slots. default: 64 🎰
-L|--disable-logging — disables request logging 🔇

--flock — locks the specified file before starting, and exits if it's locked 🔒
--flock-wait — locks the specified file before starting, and waits if it's locked ⏳
--flock2 — locks the specified file after logging/daemon setup, exits if locked 🔐
--flock-wait2 — locks the specified file after logging/daemon setup, waits if locked ⌛
--pidfile — creates a pidfile, before the privileges drop 📝
--pidfile2 — creates a pidfile, after the privileges drop 📝
--safe-pidfile — creates a safe pidfile, before the privileges drop 🛟
--safe-pidfile2 — creates a safe pidfile, after the privileges drop 🛟
--chroot — chroot()s to the specified directory 📁
--pivot-root — pivot_root()s to the specified directories. new_root and put_old must be separated with a space 🌳
--pivot_root — pivot_root()s to the specified directories. new_root and put_old must be separated with a space (underscore edition 🫶)
--uid — setuid to the specified user/uid 👤
--gid — setgid to the specified group/gid 👥
--add-gid — adds 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 — disables additional groups set via initgroups() 🚫
--cap — sets process capability ✨
--unshare — unshare()s part of the processes and puts it in a new namespace 🧬
--unshare2 — unshare()s part of the processes and puts it in a new namespace, but after the rootfs change 🔄
--setns-socket — exposes a unix socket returning namespace fds from /proc/self/ns 🔌
--setns-socket-skip — skips the specified entry when sending setns file descriptors ⏭️
--setns-skip — skips the specified entry when sending setns file descriptors (short flag, same skip) 💫
--setns — joins a namespace created by an external uWSGI instance 🤝
--setns-preopen — opens /proc/self/ns as soon as possible and caches fds 🗂️

✨ OPTIONS ✨

--jailed — marks the instance as jailed, which forces the execution of post_jail hooks. so if you want those hooks to actually do their thing, this is the vibe. no cap. 💅
--refork — runs fork() again after privileges drop. useful for jailing systems. 🦋
--re-fork — bestie, this is literally the same as --refork: fork() again after privileges drop, useful for jailing systems. two names, one slay. ✨
--refork-as-root — runs fork() again before privileges drop. useful for jailing systems. 👑
--re-fork-as-root — again, same as above: fork() again before privileges drop. useful for jailing systems. 💖
--refork-post-jail — runs fork() again after jailing. useful for jailing systems. 🎀
--re-fork-post-jail — yep, same energy: fork() again after jailing. useful for jailing systems. 🌀

--hook-asap — run the specified hook as soon as possible. ASAP, literally. ⚡
--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). note the hyphen in per-instance. 💅
--hook-accepting1-once — run the specified hook after the first worker enters the accepting phase (once per instance). no hyphen here, bestie. 💖
--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 — run the specified function/symbol after each request. same thing, different name, still iconic. ✨
--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 — keeps an eye on a file for you, and when it gets modified/touched it fires off a signal. Bestie, the syntax is literally: file signal 💅
--fs-reload — when the filesystem object you named gets modified, it does a graceful reload. chill little refresh, no drama ✨
--fs-brutal-reload — same energy but it's giving main character rage: when the filesystem object is modified, it does a brutal reload. no soft launch here 😭
--fs-signal — when the specified filesystem object gets modified, it raises a uwsgi signal. syntax again bestie: file signal 🌸
--check-mountpoint — if a filesystem is no longer reachable, it straight up destroys the instance. lowkey savage but it's genuinely useful for reliable Fuse management 🫶
--mountpoint-check — exact same vibe: if a filesystem is no longer reachable, the instance gets destroyed. again, useful for reliable Fuse management ✨
--check-mount — yep, same thing: instance gets destroyed if a filesystem is no more reachable, and it's useful for reliable Fuse management 💖
--mount-check — the fourth sibling of this mount-check family: destroys the instance when a filesystem is no more reachable. useful for reliable Fuse management, as always 💅
--propagate-touch — the "over-engineering option" for systems with flaky signal management. iykyk 😭
--limit-post — limits the request body. that's it, that's the option 💀
--no-orphans — automatically kills workers if the master dies. but fr fr, this can be dangerous for availability, so think before you slay 👑
--prio — sets the priority of processes/threads 🌈
--cpu-affinity — sets the cpu affinity, so your processes know exactly which core is their home 🎀
--post-buffering — sets the size in bytes after which it'll buffer to disk instead of memory 💾
--post-buffering-bufsize — sets the buffer size for read() in post buffering mode ⭐
--body-read-warning — sets how much memory allocation (in megabytes) for the request body is allowed before it starts printing a warning 🦋
--upload-progress — turns on creation of .json files in the directory you specify, while a file upload is happening 📁✨
--no-default-app — nope, we're not falling back to the default app 🙈
--manage-script-name — automatically rewrites SCRIPT_NAME and PATH_INFO for you. it just handles it 💅
--ignore-script-name — ignores SCRIPT_NAME entirely, no thoughts head empty 🫶
--catch-exceptions — reports exceptions as http output. discouraged though, bestie — use only for testing 🧪
--reload-on-exception — reloads a worker when an exception gets raised 🔄
--reload-on-exception-type — reloads a worker when a specific exception type is raised 🔥
--reload-on-exception-value — reloads a worker when a specific exception value is raised 💖
--reload-on-exception-repr — reloads a worker when a specific exception type+value (language-specific) is raised 🌸
--exception-handler — adds an exception handler 🎀
--enable-metrics — turns on the metrics subsystem 📊✨
--metric — adds a custom metric 💜
--metric-threshold — adds a metric threshold/alarm 🚨
--metric-alarm — adds a metric threshold/alarm (same thing, different name bestie) 🚨
--alarm-metric — yep, adds a metric threshold/alarm again 💀
--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 — exports metrics as text files to the specified directory (singular twin of the above) 📁
--metric-dir-restore — restores the last value taken from the metrics dir 💫
--metrics-no-cores — disables generation of cores-related metrics 🚫
--udp — runs the udp server on the address you specify 📡
--stats — enables the stats server on the specified address 📈
--stats-server — enables the stats server on the specified address (same energy, another name) ✨
--stats-http — prefixes the stats server json output with http headers 🌐
--stats-minified — minifies the statistics json output. small and cute 🎀
--stats-min — minifies statistics json output (yeah, the short name) 💅
--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 — sets the default frequency of stats pushers (plural version, same deal) 🕰️
--stats-no-cores — disables generation of cores-related stats 🚫
--stats-no-metrics — does not include metrics in the stats output 🙅
--multicast — subscribes to the multicast group you specify 📻
--multicast-ttl — sets the multicast ttl ⏳
--multicast-loop — sets the 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 used for subscriptions 📬
--legion — you become a member of a legion ⚔️👑
--legion-mcast — become a member of a legion (it's a shortcut for multicast) 🌈
--legion-node — adds a node to a legion 🧩
--legion-freq — sets the frequency of legion packets 📶
--legion-tolerance — sets the tolerance of the legion subsystem 🫶
--legion-death-on-lord-error — if one of the lord hooks fails, the node declares itself a dead node for the amount of seconds you specify 💀
--legion-death-on-lord-error — (yes we said it) declares itself dead for the specified number of seconds when a lord hook fails 😭
--legion-skew-tolerance — sets the clock skew tolerance of the legion subsystem, and the 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 (that's the shutdown of the instance) ⚰️
--legion-join — the action to call on legion join (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 — sets the quorum of a legion 🔢
--legion-scroll — sets the scroll of a legion 📜
--legion-scroll-max-size — sets the max size of the legion scroll buffer 📦
--legion-scroll-list-max-size — sets the max size of the legion scroll list buffer 📚
--subscriptions-sign-check — sets the digest algorithm and certificate directory for the secured subscription system 🔐
--subscriptions-sign-check-tolerance — sets the maximum tolerance (in seconds) of clock skew for the secured subscription system ⏳
--subscriptions-sign-skip-uid — skips the signature check for the specified uid when using unix sockets credentials 🙈
--subscriptions-credentials-check — adds a directory to search for subscriptions key credentials 🔑
--subscriptions-use-credentials — enables management of SCM_CREDENTIALS in subscriptions UNIX sockets 🧾
--subscription-algo — sets the load balancing algorithm for the subscription system ⚖️
--subscription-dotsplit — tries to fallback to the next part (dot based) in the subscription key 🎯
--subscribe-to — subscribes to the subscription server you specify 📡
--st — subscribe to the specified subscription server (short and sweet) ✨
--subscribe — subscribes to the specified subscription server 🫶
--subscribe2 — subscribes to the specified subscription server using advanced keyval syntax. fancy 💅
--subscribe-freq — sends the subscription announce at the interval you specify ⏰
--subscription-tolerance — sets tolerance for subscription servers 🎚️
--unsubscribe-on-graceful-reload — forces the unsubscribe request even during a graceful reload 🚪
--start-unsubscribed — configures subscriptions but doesn't send them. useful with master fifo 😴
--subscribe-with-modifier1 — forces the specififed (yes, that's spelled that way in the original, bestie) modifier1 when subscribing 🔧
--snmp — enables the embedded snmp server 🌳
--snmp-community — sets the snmp community string 🏘️
--ssl-verbose — be verbose about SSL errors. spill the tea ☕
--ssl-verify-depth — sets the maximum certificate verification depth 📏
--sni — adds 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 — sets the ssl ciphers for the sni-dir option 🔐
--ssl-enable3 — enables SSLv3, and it's insecure 😬
--ssl-enable-sslv3 — enables SSLv3, insecure (same warning bestie) ⚠️
--ssl-enable-tlsv1 — enables TLSv1, insecure 🚩
--ssl-option — sets a raw ssl option, and the value is numeric 🔢
--sni-regexp — adds an SNI-governed SSL context, where the key is a regexp 🧠
--ssl-tmp-dir — stores ssl-related temp files in the directory you specify 🗃️
--check-interval — sets the interval (in seconds) of master checks ⏱️
--forkbomb-delay — when a forkbomb is detected, it sleeps for the number of seconds you specify 😴
--binary-path — forces the binary path 📍
--privileged-binary-patch — patches the uwsgi binary with a new command (this happens before privileges drop) 🩹
--unprivileged-binary-patch — patches the uwsgi binary with a new command (this happens after privileges drop) 🩹
--privileged-binary-patch-arg — patches the uwsgi binary with a new command and arguments (before privileges drop) 🧰
--unprivileged-binary-patch-arg — patches the uwsgi binary with a new command and arguments (after privileges drop) 🧰
--async — enables async mode with the number of cores you specify ⚡
--max-fd — sets the maximum number of file descriptors. requires root privileges, bestie 👑
--logto — sets the logfile/udp address 📝
--logto2 — logs to the specified file or udp address after privileges drop 📤
--log-format — sets the advanced format for request logging 🖋️
--logformat — sets advanced format for request logging (same thing, no space) ✍️
--logformat-strftime — applies strftime to logformat output 🗓️
--log-format-strftime — applies strftime to logformat output (the hyphenated twin) 📆
--logfile-chown — chowns logfiles 👤
--logfile-chmod — chmods logfiles 🔧
--log-syslog — logs to syslog 📻
--log-socket — sends logs to the socket you specify 🕳️
--req-logger — sets/appends a request logger 🧾
--logger-req — sets/appends a request logger (same deal, flipped name) 📄
--logger — sets/appends a logger 📚
--logger-list — lists enabled loggers 📋
--loggers-list — lists enabled loggers (plural version) 🗒️
--threaded-logger — offloads log writing to a thread 🧵
--log-encoder — adds an item in the log encoder chain ⛓️
--log-req-encoder — adds an item in the log req encoder chain 🔗
--log-drain — drains (aka does not show) log lines matching the regexp you specify 🚫
--log-filter — shows only 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. could be useful for generating a core dump 💥
--alarm — creates a new alarm. syntax: <alarm> <plugin:args> 🚨
--alarm-cheap — okay so instead of making a dedicated thread for every curl-based alarm, it uses the main alarm thread. Thread budget stays cute. 💅
--alarm-freq — tune the anti-loop alarm system, default is 3 seconds. So if your alarms are doing too much, this is the vibe check interval. ⏰
--alarm-fd — raises the alarm you pick when an fd is read for read. By default it reads 1 byte, but set it to 8 for eventfd. Bestie, numbers matter. 🔢
--alarm-segfault — raises the alarm you specify when the segmentation fault handler runs. Ouchie but alerted. 💀
--segfault-alarm — same as above: raises your chosen alarm when the segfault handler is executed. Twin energy. 🫶
--alarm-backlog — raises the specified alarm when the socket backlog queue is full. She’s packed, bestie. 😭
--backlog-alarm — also raises your specified alarm when the socket backlog queue is full. Same thing, different name. 🔁
--lq-alarm — raises the specified alarm when the socket backlog queue is full. The LQ said “we full.” 💅
--alarm-lq — yep, raises the specified alarm when the socket backlog queue is full. Alias behavior, same facts. ✨
--alarm-listen-queue — raises the specified alarm when the socket backlog queue is full. Listen queue said no vacancy. 🚫
--listen-queue-alarm — raises the specified alarm when the socket backlog queue is full. Same alarm vibe. 🎀
--log-alarm — raise the specified alarm when a log line matches the specified regexp. Syntax is <alarm>[,alarm...] <regexp>. So you can ping multiple alarms, comma-separated. 🔥
--alarm-log — raise the specified alarm when a log line matches the specified regexp. Syntax: <alarm>[,alarm...] <regexp>. It’s the alias twin, still exact. 🌸
--not-log-alarm — skip the specified alarm when a log line matches the specified regexp. Syntax: <alarm>[,alarm...] <regexp>. So it’s the opposite: no alarm for this match. 🙈
--not-alarm-log — skip the specified alarm when a log line matches the specified regexp. Syntax: <alarm>[,alarm...] <regexp>. Same skip, alias name. 💜
--alarm-list — list enabled alarms. Show me the roster, bestie. 📋
--alarms-list — list enabled alarms. Plural alias, same list. 👑
--alarm-msg-size — set the max size of an alarm message, default 8192. Keep it under the limit or it’s giving truncation. ✂️
--log-master — delegate logging to the master process. Let the master handle the gossip. 👑
--log-master-bufsize — set the buffer size for the master logger. Bigger log messages will be truncated, so don’t write a novel. 📚
--log-master-stream — create the master logpipe as SOCK_STREAM. Stream mode, slay. 🌊
--log-master-req-stream — create the master requests logpipe as SOCK_STREAM. Requests logs get stream energy too. 💧
--log-reopen — reopen log after reload. Fresh log, same me. 🔄
--log-truncate — truncate log on startup. Clean slate, periodt. 🧼
--log-maxsize — set maximum logfile size. When it hits the cap, rotation time. 📏
--log-backupname — set logfile name after rotation. So the old log gets a new name. 💾
--logdate — prefix logs with date or a strftime string. Time stamps but make it custom. 🗓️
--log-date — prefix logs with date or a strftime string. Alias, same timestamp energy. 🕰️
--log-prefix — prefix logs with a string. Put your fave little phrase in front. 💬
--log-zero — log responses without body. Empty body? Still logged. 🫥
--log-slow — log requests slower than the specified number of milliseconds. Slow queens get noticed. 🐢
--log-4xx — log requests with a 4xx response. Client errors, we see you. 👀
--log-5xx — log requests with a 5xx response. Server errors, we see you too. 🚨
--log-big — log requests bigger than the specified size. Big request energy. 🐘
--log-sendfile — log sendfile requests. Sendfile moment, logged. 📤
--log-ioerror — log requests with io errors. I/O said oops. 💔
--log-micros — report response time in microseconds instead of milliseconds. Tiny numbers, precise. 🔬
--log-x-forwarded-for — use the ip from X-Forwarded-For header instead of REMOTE_ADDR. Real IP detective work. 🕵️
--master-as-root — leave master process running as root. Master stays root, no drop. 👑
--drop-after-init — run privileges drop after plugin initialization, superseded by drop-after-apps. So it’s older behavior, and drop-after-apps wins. 👵
--drop-after-apps — run privileges drop after apps loading, superseded by master-as-root. Older-ish; master-as-root takes over. 📦
--force-cwd — force the initial working directory to the specified value. No wandering, bestie. 📌
--binsh — override /bin/sh (used by exec hooks, it always fallback to /bin/sh). So you can point it elsewhere, but it always falls back to /bin/sh. 🐚
--chdir — chdir to specified directory before apps loading. Move first, load later. 📁
--chdir2 — chdir to specified directory after apps loading. Load first, move later. 📂
--lazy — set lazy mode (load apps in workers instead of master). Workers do the app loading. 🦥
--lazy-apps — load apps in each worker instead of the master. Every worker gets its own app load, no copy-paste from master. 🧑‍🍳
--cheap — set cheap mode (spawn workers only after the first request). No request? No workers. Budget queen. 💸
--cheaper — set cheaper mode (adaptive process spawning). Workers scale with the vibe. 📈
--cheaper-initial — set the initial number of processes to spawn in cheaper mode. Starting lineup, bestie. 🏁
--cheaper-algo — choose to algorithm used for adaptive process spawning. Pick your scaling algorithm. 🧠
--cheaper-step — number of additional processes to spawn at each overload. Overloaded? Spawn this many more. ➕
--cheaper-overload — increase workers after specified overload. Threshold said “now we grow.” 🌱
--cheaper-algo-list — list enabled cheapers algorithms. Show me the algo menu. 📜
--cheaper-algos-list — list enabled cheapers algorithms. Plural alias, same menu. 🗂️
--cheaper-list — list enabled cheapers algorithms. Yep, also lists them. 🧾
--cheaper-rss-limit-soft — don’t spawn new workers if total resident memory usage of all workers is higher than this limit. Soft boundary, don’t cross. 🧷
--cheaper-rss-limit-hard — if total workers resident memory usage is higher try to stop workers. Hard boundary, workers get stopped. 🛑
--idle — set idle mode (put uWSGI in cheap mode after inactivity). Chill out, go cheap after nothing happens. 😴
--die-on-idle — shutdown uWSGI when idle. Idle? Bye. 💀
--mount — load application under mountpoint. App goes under the mountpoint. ⛰️
--worker-mount — load application under mountpoint in the specified worker or after workers spawn. Worker-specific or post-spawn mount. 👷
--threads — run each worker in prethreaded mode with the specified number of threads. Threads go brrr. 🧵
--thread-stacksize — set threads stacksize. Stack size, set it. 📚
--threads-stacksize — set threads stacksize. Alias, same stack. 📚
--thread-stack-size — set threads stacksize. Another alias, same stack size. 📚
--threads-stack-size — set threads stacksize. Fourth alias, still stack size. 📚
--vhost — enable virtualhosting mode (based on SERVER_NAME variable). Vhost based on SERVER_NAME. 🏠
--vhost-host — enable virtualhosting mode (based on HTTP_HOST variable). Vhost based on HTTP_HOST. 🏡
--route — add a route. Just add a route, bestie. 🛣️
--route-host — add a route based on Host header. Route match on Host. 🏷️
--route-uri — add a route based on REQUEST_URI. Route match on REQUEST_URI. 🔗
--route-qs — add a route based on QUERY_STRING. Route match on QUERY_STRING. ❓
--route-remote-addr — add a route based on REMOTE_ADDR. Route match on REMOTE_ADDR. 📍
--route-user-agent — add a route based on HTTP_USER_AGENT. Route match on HTTP_USER_AGENT. 🕵️
--route-remote-user — add a route based on REMOTE_USER. Route match on REMOTE_USER. 🙋
--route-referer — add a route based on HTTP_REFERER. Route match on HTTP_REFERER. 🔙
--route-label — add a routing label (for use with goto). Labels for routes, goto vibes. 🏷️
--route-if — add a route based on condition. Conditional route, if-coded. 🤔
--route-if-not — add a route based on condition (negate version). Same but negated. 🙃
--route-run — always run the specified route action. No condition, just run it. 🏃
--final-route — add a final route. Final route, endgame. 🏁
--final-route-status — add a final route for the specified status. Final route matching status. 🔢
--final-route-host — add a final route based on Host header. Final route on Host. 🏷️
--final-route-uri — add a final route based on REQUEST_URI. Final route on REQUEST_URI. 🔗
--final-route-qs — add a final route based on QUERY_STRING. Final route on QUERY_STRING. ❓
--final-route-remote-addr — add a final route based on REMOTE_ADDR. Final route on REMOTE_ADDR. 📍
--final-route-user-agent — add a final route based on HTTP_USER_AGENT. Final route on HTTP_USER_AGENT. 🕵️
--final-route-remote-user — add a final route based on REMOTE_USER. Final route on REMOTE_USER. 🙋
--final-route-referer — add a final route based on HTTP_REFERER. Final route on HTTP_REFERER. 🔙
--final-route-label — add a final routing label (for use with goto). Final label, goto-ready. 🏷️
--final-route-if — add a final route based on condition. Final conditional route. 🤔
--final-route-if-not — add a final route based on condition (negate version). Final conditional route, negated. 🙃
--final-route-run — always run the specified final route action. Final route action, always. 🏃
--error-route — add an error route. Error route, oopsie path. 🚨
--error-route-status — add an error route for the specified status. Error route matching status. 🔢
--error-route-host — add an error route based on Host header. Error route on Host. 🏷️
--error-route-uri — add an error route based on REQUEST_URI. Error route on REQUEST_URI. 🔗
--error-route-qs — add an error route based on QUERY_STRING. Error route on QUERY_STRING. ❓
--error-route-remote-addr — add an error route based on REMOTE_ADDR. Error route on REMOTE_ADDR. 📍
--error-route-user-agent — add an error route based on HTTP_USER_AGENT. Error route on HTTP_USER_AGENT. 🕵️
--error-route-remote-user — add an error route based on REMOTE_USER. Error route on REMOTE_USER. 🙋
--error-route-referer — add an error route based on HTTP_REFERER. Error route on HTTP_REFERER. 🔙
--error-route-label — add an error routing label (for use with goto). Error label, goto-ready. 🏷️
--error-route-if — add an error route based on condition. Error route, conditional. 🤔
--error-route-if-not — add an error route based on condition (negate version). Error route, negated conditional. 🙃
--error-route-run — always run the specified error route action. Error route action, always. 🏃
--response-route — add a response route. Response route, route the reply. 📬
--response-route-status — add a response route for the specified status. Response route matching status. 🔢
--response-route-host — add a response route based on Host header. Response route on Host. 🏷️
--response-route-uri — add a response route based on REQUEST_URI. Response route on REQUEST_URI. 🔗
--response-route-qs — add a response route based on QUERY_STRING. Response route on QUERY_STRING. ❓
--response-route-remote-addr — add a response route based on REMOTE_ADDR. Response route on REMOTE_ADDR. 📍
--response-route-user-agent — add a response route based on HTTP_USER_AGENT. Response route on HTTP_USER_AGENT. 🕵️
--response-route-remote-user — add a response route based on REMOTE_USER. Response route on REMOTE_USER. 🙋
--response-route-referer — add a response route based on HTTP_REFERER. Response route on HTTP_REFERER. 🔙
--response-route-label — add a response routing label (for use with goto). Response label, goto-ready. 🏷️
--response-route-if — add a response route based on condition. Response route, conditional. 🤔
--response-route-if-not — add a response route based on condition (negate version). Response route, negated. 🙃
--response-route-run — always run the specified response route action. Response route action, always. 🏃
--router-list — list enabled routers. Router roster, please. 📋
--routers-list — list enabled routers. Plural alias, same roster. 👑
--error-page-403 — add an error page (html) for managed 403 response. Custom 403 HTML, slay. 🚫
--error-page-404 — add an error page (html) for managed 404 response. Custom 404 HTML, iconic. 🔍
--error-page-500 — add an error page (html) for managed 500 response. Custom 500 HTML, dramatic. 💥
--websockets-ping-freq — set the frequency (in seconds) of websockets automatic ping packets. Ping timer in seconds. 🏓
--websocket-ping-freq — set the frequency (in seconds) of websockets automatic ping packets. Alias, same ping timer. 🏓
--websockets-pong-tolerance — set the tolerance (in seconds) of websockets ping/pong subsystem. Pong patience in seconds. ⏳
--websocket-pong-tolerance — set the tolerance (in seconds) of websockets ping/pong subsystem. Alias, same tolerance. ⏳
--websockets-max-size — set the max allowed size of websocket messages (in Kbytes, default 1024). Message cap in Kbytes. 📦
--websocket-max-size — set the max allowed size of websocket messages (in Kbytes, default 1024). Alias, same max size. 📦
--chunked-input-limit — set the max size of a chunked input part (default 1MB, in bytes). Chunked input cap, default 1MB. 🧱
--chunked-input-timeout — set default timeout for chunked input. Chunked input timeout. ⏰
--clock — set a clock source. Clock source, pick one. 🕰️
--clock-list — list enabled clocks. Show me the clocks. ⏱️
--clocks-list — bestie, it literally just lists the enabled clocks ✨
--add-header — automatically sprinkles HTTP headers onto the response, no cap 💅
--rem-header — automatically yeets the specified HTTP header out of the response
--del-header — same energy, also automatically removes the specified HTTP header from the response
--collect-header — stores the specified response header into a request var, syntax is header var 🎀
--response-header-collect — stores the specified response header into a request var, syntax header var
--pull-header — stores the specified response header into a request var and removes it from the response, syntax header var

🌸 static file era 🌸

--check-static — check for static files in the specified directory
--check-static-docroot — check for static files in the requested DOCUMENT_ROOT
--static-check — check for static files in the specified directory
--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 from staticfile checks
--static-index — if a directory is requested, it searches for the specified file 👑
--static-safe — skips security checks if the file lives under the specified path
--static-cache-paths — puts resolved paths in the uWSGI cache for the specified amount of seconds
--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 filename regexp
--static-expires-mtime — sets the Expires header based on filename regexp and file mtime
--static-expires-uri — sets the Expires header based on REQUEST_URI regexp
--static-expires-uri-mtime — sets the Expires header based on REQUEST_URI regexp and file mtime
--static-expires-path-info — sets the Expires header based on PATH_INFO regexp
--static-expires-path-info-mtime — sets the Expires header based on PATH_INFO regexp and file mtime
--static-gzip — if the supplied regexp matches the static file translation, it goes looking for a gzip version 🔍
--static-gzip-all — checks for a gzip version of all requested static files
--static-gzip-dir — checks for a gzip version of all requested static files 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 — enables support for the HTTP Range header 🙌
--offload-threads — sets the number of offload threads to spawn, per-worker, default 0
--offload-thread — sets the number of 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 relies on boring read()/write() instead 😴
--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)

🌈 env, cgroups & namespaces 🌈

--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 the 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 — run in a new namespace under the specified rootfs
--namespace-keep-mount — keeps the specified mountpoint in your namespace
--ns — run in a new namespace under the specified rootfs
--namespace-net — adds a network namespace
--ns-net — adds a network namespace

💜 sockets & networking 💜

--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 specified qlen value
--tcp-fastopen — enables the TCP_FASTOPEN flag on TCP sockets with the specified qlen value
--tcp-fast-open-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported
--tcp-fastopen-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported
--zerg — attach 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 corner 🎀

--cron — add a cron task
--cron2 — add a cron task (key=val syntax)
--unique-cron — add a unique cron task
--cron-harakiri — sets the maximum time (in seconds) we wait for a cron command to complete ⏳
--legion-cron — add a cron task runnable only when the instance is a lord of the specified legion
--cron-legion — add a cron task runnable only when the instance is a lord of the specified legion
--unique-legion-cron — add a unique cron task runnable only when the instance is a lord of the specified legion
--unique-cron-legion — add a unique cron task runnable only when the instance is a lord of the specified legion

🦋 loops & workers 🦋

--loop — select the uWSGI loop engine
--loop-list — list enabled loop engines
--loops-list — list enabled loop engines
--worker-exec — run the specified command as worker
--worker-exec2 — run the specified command as worker (after the post_fork hook)

💅 daemon attachment 💅

--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 — does not change the stdin of external daemons to /dev/null
--attach-daemon2 — attach-daemon keyval variant (supports smart modes too)

✨ plugins, no notes ✨

--plugins — load uWSGI plugins
--plugin — load uWSGI plugins
--need-plugins — load uWSGI plugins (and exit on error) 😭
--need-plugin — load uWSGI plugins (and exit on error) 😭
--plugins-dir — adds a directory to the uWSGI plugin search path
--plugin-dir — adds a directory to the uWSGI plugin search path
--plugins-list — list enabled plugins
--plugin-list — list enabled plugins
--autoload — tries to automatically load plugins when unknown options are found 🔮
--dlopen — blindly load a shared library (yes, blindly, she said what she said)
--allowed-modifiers — comma separated list of allowed modifiers
--remap-modifier — remaps a request modifier from one id to another

🧚 debugging & building 🧚

--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 — print uWSGI version
--response-headers-limit — sets the response header maximum size (default: 64k)

ok that's the whole options buffet, bestie — every flag, every default, every "syntax: header var", all of it, untouched 🫶

and that's the page!! 💖 this whole thing came from uwsgi_ldap version 2.0.31-debian, dated July 2026, and it's filed under UWSGI_LDAP(1) — literally the manual page, periodt. go configure something iconic 🌟

📦 where this page comes from

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