UWSGI_PSGI(1)
✨ UWSGI_PSGI(1) ✨
hey bestie, welcome to the UWSGI_PSGI(1) manual page from the User Commands section. this is part 1 of 6, and it's giving "the origin story plus the giant options menu". no cap, every flag is here. 💅
🎀 NAME 🎀
uwsgi_psgi - fast (pure C), self-healing, developer-friendly WSGI server
🦋 SYNOPSIS 🦋
uwsgi-core [options...]💖 DESCRIPTION 💖
okay so DESCRIPTION is where the options live. it's the whole menu, bestie. let's go in order, no skipping. 🫶
-s,--socket— bind to the specified UNIX/TCP socket using default protocol 🌸-s,--uwsgi-socket— bind to the specified UNIX/TCP socket using the uwsgi protocol ✨--suwsgi-socket— bind to the specified UNIX/TCP socket using the uwsgi protocol over SSL 🔥--ssl-socket— bind to the specified UNIX/TCP socket using the uwsgi protocol over SSL 🌈--http-socket— bind to the specified UNIX/TCP socket using the HTTP protocol 💅--http-socket-modifier1— force the specifiedmodifier1when using HTTP protocol 🎀--http-socket-modifier2— force the specifiedmodifier2when using HTTP protocol 🎀--http11-socket— bind to the specified UNIX/TCP socket using the HTTP 1.1 (Keep-Alive) protocol ⭐--https-socket— bind to the specified UNIX/TCP socket using the HTTPS protocol ✨--https-socket-modifier1— force the specifiedmodifier1when using HTTPS protocol 🎀--https-socket-modifier2— force the specifiedmodifier2when using HTTPS protocol 🎀--fastcgi-socket— bind to the specified UNIX/TCP socket using the FastCGI protocol 💖--fastcgi-nph-socket— bind to the specified UNIX/TCP socket using the FastCGI protocol (nph mode) 💖--fastcgi-modifier1— force the specifiedmodifier1when using FastCGI protocol 🎀--fastcgi-modifier2— force the specifiedmodifier2when using FastCGI protocol 🎀--scgi-socket— bind to the specified UNIX/TCP socket using the SCGI protocol 🌸--scgi-nph-socket— bind to the specified UNIX/TCP socket using the SCGI protocol (nph mode) 🌸--scgi-modifier1— force the specifiedmodifier1when using SCGI protocol 🎀--scgi-modifier2— force the specifiedmodifier2when using SCGI protocol 🎀--raw-socket— bind to the specified UNIX/TCP socket using the RAW protocol 🔥--raw-modifier1— force the specifiedmodifier1when using RAW protocol 🎀--raw-modifier2— force the specifiedmodifier2when using RAW protocol 🎀--puwsgi-socket— bind to the specified UNIX/TCP socket using the persistent uwsgi protocol (puwsgi) 💫--protocol— force the specified protocol for default sockets 🧚--socket-protocol— force the specified protocol for default sockets 🧚--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— serializeaccept()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 onwrite()/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 become 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— writes the Emperor's pid into the file u tell it 🫶--emperor-tyrant— puts the Emperor in Tyrant mode. yes it's literally called that, the drama 👑--emperor-tyrant-nofollow— when checking for uid/gid in Tyrant mode, don't follow symlinks 🚫🔗--emperor-stats— runs the Emperor stats server ✨--emperor-stats-server— also runs the Emperor stats server (same energy, different flag name, she contains multitudes 💅)--early-emperor— spawns the emperor as soon as possible, no waiting around 🏃♀️💨--emperor-broodlord— runs the emperor in BroodLord mode 🦋--emperor-throttle— sets the throttling level (in milliseconds) for badly-behaving vassals. default is1000⏱️--emperor-max-throttle— sets the max throttling level (in milliseconds) for badly-behaving vassals. default is3 minutes😤--emperor-magic-exec— prefixes vassals' config files withexec://if they have the executable bit 🪄--emperor-on-demand-extension— searches for a text file (vassal name + extension) holding the on demand socket name 🔍--emperor-on-demand-ext— same thing, short spelling, still searching for that text file (vassal name + extension) with the on demand socket name 🍓--emperor-on-demand-directory— turns on on demand mode, binding to the unix socket in the directory u specify, named like the vassal +.socket🧦--emperor-on-demand-dir— the short-name twin: on demand mode, unix socket in the specified directory, named like the vassal +.socket💖--emperor-on-demand-exec— uses the output of the command u give 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— same deal, abbreviated: allows the specified extension in the Emperor (vassal called with--config) ✨--emperor-no-blacklist— disables the Emperor blacklisting subsystem 🚫📝--emperor-use-clone— usesclone()instead offork(), passing the unshare() flags u specify 🌱--emperor-graceful-shutdown— uses vassals' graceful shutdown during ragnarok 🌋--emperor-cap— sets vassals capability 👑--vassals-cap— sets vassals capability 👑--vassal-cap— sets vassals capability 👑--imperial-monitor-list— lists enabled imperial monitors 📋--imperial-monitors-list— lists enabled imperial monitors 📋--vassals-inherit— adds config templates to vassals config (uses--inherit) 🧬--vassals-include— includes config templates into vassals config (uses--includeinstead of--inherit) 🧬--vassals-inherit-before— adds config templates to vassals config (uses--inherit, and parses before the vassal file) ⏮️--vassals-include-before— includes config templates into vassals config (uses--includeinstead of--inherit, and parses before the vassal file) ⏮️--vassals-start-hook— runs the command u specify before each vassal starts 🏁--vassals-stop-hook— runs the command u specify after a vassal's death 🪦--vassal-sos— asks the emperor for reinforcement when overloaded 🆘--vassal-sos-backlog— asks the emperor for sos if the backlog queue has more items than the value u specify 🆘📈--vassals-set— automatically sets the option u specify (via--set) for every vassal 🎛️--vassal-set— automatically sets the option u specify (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 is60) ⏳--mule-reload-mercy— sets the max time (in seconds) a mule can take to reload/shutdown (default is60) ⏳--exit-on-reload— forces exit even if a reload is requested 🚪--die-on-term— exit instead of brutal reload onSIGTERM💀--force-gateway— forces the spawn of the first registered gateway without a master 🌉-h|--help— show this help 🆘-h|--usage— show this help 🆘--print-sym— prints the content of the binary symbol u specify 🔎--print-symbol— prints the content of the binary symbol u specify 🔎-r|--reaper— callswaitpid(-1,...)after each request to get rid of zombies 🧟🧹-R|--max-requests— reloads workers after the specified amount of managed requests 🔄--max-requests-delta— adds(worker_id * delta)to themax_requestsvalue of each worker ➕--min-worker-lifetime— number of seconds a worker must run before being reloaded (default is10) ⏲️--max-worker-lifetime— reloads workers after the specified amount of seconds (default is disabled) ⏲️--max-worker-lifetime-delta— adds(worker_id * delta)seconds to themax_worker_lifetimevalue of each worker ➕-z|--socket-timeout— sets 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— set the ipcsem key viaftok()for avoiding duplicates 🔑--persistent-ipcsem— do not remove ipcsem's on shutdown 🧷-A|--sharedarea— creates a raw shared memory area of the specified pages (note: it supports keyval too) 🧠--safe-fd— do not close the file descriptor u specify 🛟--fd-safe— do not close the file descriptor u specify 🛟
--cache— creates a shared cache containing the given elements 💾--cache-blocksize— sets cache blocksize 🧱--cache-store— enables persistent cache to disk 💽--cache-store-sync— sets the frequency of sync for persistent cache 🔁--cache-no-expire— disables auto sweep of expired items 🧹🚫--cache-expire-freq— sets the frequency of cache sweeper scans (default3 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 socket u specify 📡--cache-udp-node— sends cache update/deletion to the cache udp server u specify 📡--cache-sync— copies the whole content of another uWSGI cache server on server startup 🫂--cache-use-last-modified— updateslast_modified_attimestamp 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 shared queue 📥--queue-blocksize— sets queue blocksize 🧱--queue-store— enables persistent queue to disk 💽--queue-store-sync— sets the frequency of sync for persistent queue 🔁
-Q|--spooler— runs a spooler on the directory u specify 🗂️--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 directory u specify 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 max number of tasks to run before recycling a spooler ♻️--spooler-harakiri— sets harakiri timeout for spooler tasks 🗡️--spooler-frequency— sets spooler frequency 📶--spooler-freq— sets spooler frequency 📶--mule— add a mule 🐴--mules— add the specified number of mules 🐴🐴🐴--farm— add a mule farm 🚜--mule-msg-size— sets mule message buffer size 📨--signal— send a uwsgi signal to a server 📶--signal-bufsize— sets buffer size for signal queue 📦--signals-bufsize— sets buffer size for signal queue 📦--signal-timer— adds a timer (syntax:<signal> <seconds>) ⏱️--timer— adds a timer (syntax:<signal> <seconds>) ⏱️--signal-rbtimer— adds a redblack timer (syntax:<signal> <seconds>) 🌲⏱️--rbtimer— adds a redblack timer (syntax:<signal> <seconds>) 🌲⏱️--rpc-max— maximum number of rpc slots (default:64) 🎰-L|--disable-logging— disables request logging 🙈--flock— locks the file u specify before starting, and exits if it's locked 🔒--flock-wait— locks the file u specify before starting, and waits if it's locked ⏳🔒--flock2— locks the file u specify after logging/daemon setup, exits if it's locked 🔒--flock-wait2— locks the file u specify after logging/daemon setup, waits if it's locked ⏳🔒--pidfile— creates a pidfile (before privileges drop) 🪪--pidfile2— creates a pidfile (after privileges drop) 🪪--safe-pidfile— creates a safe pidfile (before privileges drop) 🛟🪪--safe-pidfile2— creates a safe pidfile (after privileges drop) 🛟🪪--chroot—chroot()s to the directory u specify 🏰--pivot-root—pivot_root()s to the directories u specify (new_rootandput_oldmust be separated with a space) 🌳--pivot_root—pivot_root()s to the directories u specify (new_rootandput_oldmust be separated with a space) 🌳--uid— setuid to the user/uid u specify 👤--gid— setgid to the group/gid u specify 👥--add-gid— adds the group id u specify to the process credentials ➕👥--immediate-uid— setuid to the user/uid u specify IMMEDIATELY ‼️👤--immediate-gid— setgid to the group/gid u specify IMMEDIATELY ‼️👥--no-initgroups— disables additional groups set viainitgroups()🚫👥--cap— set 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 after the rootfs change 🌀--setns-socket— exposes a unix socket returning namespace fds from/proc/self/ns🧵--setns-socket-skip— skips the entry u specify when sending setns file descriptors ⏭️--setns-skip— skips the entry u specify when sending setns file descriptors ⏭️--setns— joins a namespace created by an external uWSGI instance 🫂--setns-preopen— opens/proc/self/nsas soon as possible and caches fds 📂⚡--jailed— mark the instance as jailed (this forces thepost_jailhooks to actually run) 💅--refork—fork()again after privileges drop. literally made for jailing systems 🔒--re-fork— same exact thing as--refork, just spelled differently:fork()again after privileges drop, for jailing systems. pick whichever one your fingers like ✨--refork-as-root—fork()again before privileges drop. jailing systems stay winning 🫶--re-fork-as-root— the hyphenated twin of--refork-as-root:fork()again before privileges drop, still for jailing systems 💖--refork-post-jail—fork()again after jailing. jail girlies, this one's for you 🔒--re-fork-post-jail— yes bestie it's the same as--refork-post-jail:fork()again after jailing 🎀
✨ the hook options (aka the "run this exact thing at this exact moment" era) ✨
--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 is<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 beforeexec()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 (yep, same energy as the one above 💅)
✨ then we have the exec twins of every single one of those ✨
--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 beforeexec()ing the vassal--exec-as-emperor— run the specified command in the emperor after the vassal has been started
✨ mount, but make it timed ✨
--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 beforeexec()ing the vassal--mount-as-emperor— mount filesystem in the emperor after the vassal has been started
✨ and now the unmount arc 🌈 (yes it's the same list but backwards)
--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 beforeexec()ing the vassal--umount-as-emperor— unmount filesystem in the emperor after the vassal has been started
✨ waiting era (patience is a personality trait) ✨
--wait-for-interface— wait for the specified network interface to come up before running root hooks 🌐--wait-for-interface-timeout— set the timeout forwait-for-interface--wait-interface— same as--wait-for-interface: wait for the specified network interface to come up before running root hooks--wait-interface-timeout— set the timeout forwait-for-interface--wait-for-iface— again, same deal: wait for the specified network interface to come up before running root hooks--wait-for-iface-timeout— set the timeout forwait-for-interface--wait-iface— yep, another spelling: wait for the specified network interface to come up before running root hooks--wait-iface-timeout— set the timeout forwait-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 forwait-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 forwait-for-socket
✨ call options (the function-calling supremacy) ✨
--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 specifiedfunction()beforeexec()ing the vassal--call-as-vassal1— call the specifiedfunction(char *)beforeexec()ing the vassal--call-as-vassal3— call the specifiedfunction(char *, uid_t, gid_t)beforeexec()ing the vassal--call-as-emperor— call the specifiedfunction()in the emperor after the vassal has been started--call-as-emperor1— call the specifiedfunction(char *)in the emperor after the vassal has been started--call-as-emperor2— call the specifiedfunction(char *, pid_t)in the emperor after the vassal has been started--call-as-emperor4— call the specifiedfunction(char *, pid_t, uid_t, gid_t)in the emperor after the vassal has been started
✨ config loading + instance vibes ✨
--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 the 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— setSO_SNDTIMEO--socket-send-timeout— setSO_SNDTIMEO--so-write-timeout— setSO_SNDTIMEO--socket-write-timeout— setSO_SNDTIMEO--socket-sndbuf— setSO_SNDBUF--socket-rcvbuf— setSO_RCVBUF--shutdown-sockets— force callingshutdown()in addition toclose()when sockets are destroyed 🔌
✨ memory, limits and reload behaviour ✨
--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 options (touch grass? no. touch files.) ✨
--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 isfile command💫--touch-signal— when the file you point at gets modified/touched, it raises a signal. syntax:file signal✨--fs-reload— when the filesystem object you name gets modified, do a graceful reload. soft, gentle, tasteful 🎀--fs-brutal-reload— same vibe check, but when the filesystem object changes it does a brutal reload. no mercy, no grace 💀--fs-signal— raise a uwsgi signal when the filesystem object gets modified (syntax:file signal)--check-mountpoint— if a filesystem is no more reachable, it destroys the instance. yes, destroys. it's useful for reliable Fuse management 🫶--mountpoint-check— literally the same thing as--check-mountpoint: destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management)--check-mount— again bestie, same energy: destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management)--mount-check— the fourth twin 😭 destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management)--propagate-touch— the manual fr calls this an "over-engineering option for system with flaky signal management". take that however you want 💅--limit-post— limit the request body--no-orphans— automatically kill workers if the master dies. heads up: this can be dangerous for availability ⚠️--prio— set processes/threads priority--cpu-affinity— set cpu affinity--post-buffering— set the size in bytes after which it'll buffer to disk instead of memory--post-buffering-bufsize— set the buffer size forread()in post buffering mode--body-read-warning— set the amount of allowed memory allocation (in megabytes) for the request body before it starts printing a warning 👀--upload-progress— enable creation of.jsonfiles in the specified directory during a file upload 🍓--no-default-app— do not fallback to the default app--manage-script-name— automatically rewriteSCRIPT_NAMEandPATH_INFO--ignore-script-name— ignoreSCRIPT_NAME--catch-exceptions— report the exception as http output. the page itself says discouraged, use only for testing 🙈--reload-on-exception— reload a worker whenever an exception is raised--reload-on-exception-type— reload a worker when a specific exception type is raised--reload-on-exception-value— reload a worker when a specific exception value is raised--reload-on-exception-repr— reload a worker when a specific exception type+value (language-specific) is raised--exception-handler— add an exception handler--enable-metrics— turn on the metrics subsystem ✨--metric— add a custom metric--metric-threshold— add a metric threshold/alarm--metric-alarm— add a metric threshold/alarm--alarm-metric— add a metric threshold/alarm--metrics-dir— export metrics as text files into the directory you specify--metrics-dir-restore— restore the last value taken from the metrics dir--metric-dir— export metrics as text files to the specified directory--metric-dir-restore— restore the last value taken from the metrics dir--metrics-no-cores— disable generation of cores-related metrics--udp— run the udp server on the specified address--stats— enable the stats server on the specified address--stats-server— enable the stats server on the specified address--stats-http— prefix the stats server json output with http headers--stats-minified— minify the statistics json output--stats-min— minify the statistics json output--stats-push— push the stats json to the specified destination--stats-pusher-default-freq— set the default frequency of stats pushers--stats-pushers-default-freq— set the default frequency of stats pushers--stats-no-cores— disable generation of cores-related stats--stats-no-metrics— do not include metrics in the stats output--multicast— subscribe to the specified multicast group--multicast-ttl— set multicast ttl--multicast-loop— set multicast loop (default1)--master-fifo— enable the master fifo--notify-socket— enable the notification socket--subscription-notify-socket— set the notification socket for subscriptions--legion— become a member of a legion 👑--legion-mcast— become a member of a legion (shortcut for multicast)--legion-node— add a node to a legion--legion-freq— set the frequency of legion packets--legion-tolerance— set the tolerance of the legion subsystem--legion-death-on-lord-error— declare itself as a dead node for the specified amount of seconds if one of the lord hooks fails--legion-skew-tolerance— set the clock skew tolerance of the legion subsystem (default60seconds)--legion-lord— action to call on Lord election--legion-unlord— action to call on Lord dismiss--legion-setup— action to call on legion setup--legion-death— action to call on legion death (shutdown of the instance)--legion-join— action to call on legion join (first time quorum is reached)--legion-node-joined— action to call on a new node joining the legion--legion-node-left— action to call on a node leaving the legion--legion-quorum— set the quorum of a legion--legion-scroll— set the scroll of a legion--legion-scroll-max-size— set max size of legion scroll buffer--legion-scroll-list-max-size— set max size of legion scroll list buffer--subscriptions-sign-check— set the digest algorithm and certificate directory for the secured subscription system 🔐--subscriptions-sign-check-tolerance— set the maximum tolerance (in seconds) of clock skew for the secured subscription system--subscriptions-sign-skip-uid— skip the signature check for the specified uid when using unix sockets credentials--subscriptions-credentials-check— add a directory to search for subscriptions key credentials--subscriptions-use-credentials— enable management ofSCM_CREDENTIALSin subscriptions UNIX sockets--subscription-algo— set the load balancing algorithm for the subscription system--subscription-dotsplit— try to fallback to the next part (dot based) in the subscription key--subscribe-to— subscribe to the specified subscription server--st— subscribe to the specified subscription server--subscribe— subscribe to the specified subscription server--subscribe2— subscribe to the specified subscription server using advanced keyval syntax--subscribe-freq— send a subscription announce at the specified interval--subscription-tolerance— set tolerance for subscription servers--unsubscribe-on-graceful-reload— force the unsubscribe request even during a graceful reload--start-unsubscribed— configure subscriptions but do not send them (useful with master fifo)--subscribe-with-modifier1— force the specififed modifier1 when subscribing (yes, "specififed" — that's the manpage's own typo, leaving it exactly as found 💅)--snmp— enable the embedded snmp server--snmp-community— set the snmp community string--ssl-verbose— be verbose about SSL errors 🔥--ssl-verify-depth— set maximum certificate verification depth--sni— add an SNI-governed SSL context--sni-dir— check forcert/key/client_cafile in the specified directory and create a sni/ssl context on demand ✨--sni-dir-ciphers— set the ssl ciphers for thesni-diroption--ssl-enable3— enable SSLv3 (insecure) ⚠️--ssl-enable-sslv3— enable SSLv3 (insecure) ⚠️--ssl-enable-tlsv1— enable TLSv1 (insecure) ⚠️--ssl-option— set a raw ssl option (numeric value)--sni-regexp— add an SNI-governed SSL context (the key is a regexp)--ssl-tmp-dir— store ssl-related temp files in the specified directory--check-interval— set the interval (in seconds) of master checks--forkbomb-delay— sleep for the specified number of seconds when a forkbomb is detected 💀--binary-path— force binary path--privileged-binary-patch— patch the uwsgi binary with a new command (before privileges drop)--unprivileged-binary-patch— patch the uwsgi binary with a new command (after privileges drop)--privileged-binary-patch-arg— patch the uwsgi binary with a new command and arguments (before privileges drop)--unprivileged-binary-patch-arg— patch the uwsgi binary with a new command and arguments (after privileges drop)--async— enable async mode with the specified cores--max-fd— set maximum number of file descriptors (requires root privileges) 👑--logto— set logfile/udp address--logto2— log to the specified file or udp address after privileges drop--log-format— set advanced format for request logging--logformat— set advanced format for request logging--logformat-strftime— apply strftime to logformat output--log-format-strftime— apply strftime to logformat output--logfile-chown— chown logfiles--logfile-chmod— chmod logfiles--log-syslog— log to syslog--log-socket— send logs to the specified socket--req-logger— set/append a request logger--logger-req— set/append a request logger--logger— set/append a logger--logger-list— list enabled loggers--loggers-list— list enabled loggers--threaded-logger— offload log writing to a thread--log-encoder— add an item in the log encoder chain--log-req-encoder— add an item in the log req encoder chain--log-drain— drain (do not show) log lines matching the specified regexp 🚫--log-filter— show only log lines matching the specified regexp--log-route— log to the specified named logger if the regexp applied on the logline matches--log-req-route— log requests to the specified named logger if the regexp applied on the logline matches--use-abort— callabort()on segfault/fpe, could be useful for generating a core dump--alarm— create a new alarm, syntax:<alarm> <plugin:args>⏰--alarm-cheap— use the main alarm thread instead of spawning dedicated threads for curl-based alarms. thread budget? saved. 💅--alarm-freq— tune the anti-loop alarm system. default is3seconds, periodt.--alarm-fd— raise the specified alarm when anfdis read for read. by default it reads1byte, so set8if you're oneventfd. iykyk 🫶--alarm-segfault— raise the specified alarm when the segmentation fault handler gets executed 😭--segfault-alarm— raise the specified alarm when the segmentation fault handler gets executed. same vibe, different name, we love an alias 👑--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. yes bestie, another one 💀--lq-alarm— raise the specified alarm when the socket backlog queue is full 💖--alarm-lq— raise the specified alarm when the socket backlog queue is full ✨--alarm-listen-queue— raise the specified alarm when the socket backlog queue is full 🌸--listen-queue-alarm— raise the specified alarm when the socket backlog queue is full. the alias family is literally thriving 🌈--log-alarm— raise the specified alarm when a log line matches the specified regexp. syntax:<alarm>[,alarm...] <regexp>🎀--alarm-log— raise the specified alarm when a log line matches the specified regexp. syntax:<alarm>[,alarm...] <regexp>⭐--not-log-alarm— skip the specified alarm when a log line matches the specified regexp. syntax:<alarm>[,alarm...] <regexp>— the negate version, she said no 🙈--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 asSOCK_STREAM🦋--log-master-req-stream— create the master requests logpipe asSOCK_STREAM🦋--log-reopen— reopen the log after a reload 🔄--log-truncate— truncate the log on startup 🧹--log-maxsize— set maximum logfile size 📏--log-backupname— set the logfile name to use after rotation 🔁--logdate— prefix logs with a date or astrftimestring 📅--log-date— prefix logs with a date or astrftimestring 📅💖--log-prefix— prefix logs with a string 🏷️--log-zero— log responses without a body 👻--log-slow— log requests slower than the specified number of milliseconds 🐌--log-4xx— log requests with a4xxresponse 😬--log-5xx— log requests with a5xxresponse 💀--log-big— log requests bigger than the specified size 🐘--log-sendfile— logsendfilerequests 📤--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 theX-Forwarded-Forheader instead ofREMOTE_ADDR🕵️
--master-as-root— leave the master process running as root 👑 (yes, root root, be careful bestie)--drop-after-init— run privileges drop after plugin initialization. note: this is superseded bydrop-after-apps🌱--drop-after-apps— run privileges drop after apps loading. note: this is superseded bymaster-as-root🌱--force-cwd— force the initial working directory to the specified value 📁--binsh— override/bin/sh. this is used by exec hooks, and it always fallback to/bin/sh🐚--chdir—chdirto the specified directory before apps loading 📂--chdir2—chdirto the specified directory after apps loading 📂--lazy— set lazy mode: load apps in workers instead of the 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 the algorithm used for adaptive process spawning 🧠--cheaper-step— number of additional processes to spawn at each overload ➕--cheaper-overload— increase workers after the 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 the 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 📐 (four spellings, one truth 💅)--vhost— enable virtualhosting mode, based on theSERVER_NAMEvariable 🏠--vhost-host— enable virtualhosting mode, based on theHTTP_HOSTvariable 🏠
okay routing section, this is the main character of the options list, buckle up 🫶
--route— add a route 🛣️--route-host— add a route based on theHostheader 🛣️--route-uri— add a route based onREQUEST_URI🛣️--route-qs— add a route based onQUERY_STRING🛣️--route-remote-addr— add a route based onREMOTE_ADDR🛣️--route-user-agent— add a route based onHTTP_USER_AGENT🛣️--route-remote-user— add a route based onREMOTE_USER🛣️--route-referer— add a route based onHTTP_REFERER🛣️--route-label— add a routing label, for use withgoto🏷️--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 theHostheader 🏁--final-route-uri— add a final route based onREQUEST_URI🏁--final-route-qs— add a final route based onQUERY_STRING🏁--final-route-remote-addr— add a final route based onREMOTE_ADDR🏁--final-route-user-agent— add a final route based onHTTP_USER_AGENT🏁--final-route-remote-user— add a final route based onREMOTE_USER🏁--final-route-referer— add a final route based onHTTP_REFERER🏁--final-route-label— add a final routing label, for use withgoto🏷️🏁--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 theHostheader 🚨--error-route-uri— add an error route based onREQUEST_URI🚨--error-route-qs— add an error route based onQUERY_STRING🚨--error-route-remote-addr— add an error route based onREMOTE_ADDR🚨--error-route-user-agent— add an error route based onHTTP_USER_AGENT🚨--error-route-remote-user— add an error route based onREMOTE_USER🚨--error-route-referer— add an error route based onHTTP_REFERER🚨--error-route-label— add an error routing label, for use withgoto🏷️🚨--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 theHostheader 💬--response-route-uri— add a response route based onREQUEST_URI💬--response-route-qs— add a response route based onQUERY_STRING💬--response-route-remote-addr— add a response route based onREMOTE_ADDR💬--response-route-user-agent— add a response route based onHTTP_USER_AGENT💬--response-route-remote-user— add a response route based onREMOTE_USER💬--response-route-referer— add a response route based onHTTP_REFERER💬--response-route-label— add a response routing label, for use withgoto🏷️💬--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 a managed403response 🚫--error-page-404— add an error page (html) for a managed404response 🔍--error-page-500— add an error page (html) for a managed500response 💥--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 the websockets ping/pong subsystem ⏳--websocket-pong-tolerance— set the tolerance, in seconds, of the websockets ping/pong subsystem ⏳💖--websockets-max-size— set the max allowed size of websocket messages, in Kbytes. default:1024📦--websocket-max-size— set the max allowed size of websocket messages, in Kbytes. default:1024📦💖--chunked-input-limit— set the max size of a chunked input part. default:1MB, in bytes 📏--chunked-input-timeout— set the default timeout for chunked input ⏰--clock— set a clock source ⏰--clock-list— list enabled clocks 📋🕰️
okay bestie we're back in the options list, part six, the saga continues 💅
--clocks-list— lists all the enabled clocks ✨--add-header— automatically adds HTTP headers to the response 💌--rem-header,--del-header— automatically removes the HTTP header you name from the response 🧹 (yeah it's two names, same exact job, pick your fave)--collect-header,--response-header-collect— stores the response header you name into a request var. syntax:header var🎀--pull-header— same stash-it-in-a-request-var energy, BUT it also yanks that header out of the response entirely. syntax:header var🫳--check-static,--static-check— checks for static files in the directory you specify 📂--check-static-docroot— checks for static files inside the requestedDOCUMENT_ROOT🗂️--static-map— maps a mountpoint to a static directory (or a file) 🔗--static-map2— like--static-mapexcept it completely appends the requested resource onto the docroot ➕--static-skip-ext— skips the extension you give from static file checks 🚫--static-index— searches for the file you name whenever a directory is requested 🔎--static-safe— skips the security checks if the file lives under the path you specify 🛡️ (iykyk, be careful with this one)--static-cache-paths— puts the resolved paths into the uWSGI cache for however many seconds you say ⏱️--static-cache-paths-name— uses this cache for static paths, bestie 🎯--mimefile,--mime-file— sets the mime types file path. default is/etc/mime.types📄--static-expires-type— sets theExpiresheader based on content type 🕰️--static-expires-type-mtime— sets theExpiresheader based on content type and the file's mtime 🕰️➕--static-expires— sets theExpiresheader based on a filename regexp 🧬--static-expires-mtime— sets theExpiresheader based on a filename regexp and the file's mtime 🧬➕--static-expires-uri— sets theExpiresheader based on aREQUEST_URIregexp 🧬--static-expires-uri-mtime— sets theExpiresheader based on aREQUEST_URIregexp and the file's mtime 🧬➕--static-expires-path-info— sets theExpiresheader based on aPATH_INFOregexp 🧬--static-expires-path-info-mtime— sets theExpiresheader based on aPATH_INFOregexp and the file's mtime 🧬➕--static-gzip— if the regexp you hand it matches the static file translation, it goes looking for a gzip version 🗜️--static-gzip-all— checks for a gzip version of literally every requested static file 🗜️✨--static-gzip-dir,--static-gzip-prefix— checks for a gzip version of all requested static files in the dir/prefix you give 🗜️📁--static-gzip-ext,--static-gzip-suffix— checks for a gzip version of all requested static files with the ext/suffix you give 🗜️🏷️--honour-range— turns on support for the HTTPRangeheader 📏--offload-threads,--offload-thread— sets how many offload threads to spawn (per-worker, default0) 🧵--file-serve-mode,--fileserve-mode— sets the static file serving mode 🚚--disable-sendfile— disablessendfile()and makes it rely on the boring oldread()/write()instead 😴--check-cache— checks for response data in the cache you specify (leave it empty for the default cache) 🗃️--close-on-exec— sets close-on-exec on connection sockets (could be required for spawning processes in requests) 🔌--close-on-exec2— sets close-on-exec on server sockets (could be required for spawning processes in requests) 🔌--mode— 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 right now, immediately 🏃♀️--unenv— unsets an environment variable 🚮--vacuum— tries to remove all of the generated files/sockets 🧽--file-write— writes the content you give to the file you give (syntax:file=value) before privileges drop ✍️--cgroup— puts the processes in the cgroup you specify 📦--cgroup-opt— sets a value in the cgroup option you specify ⚙️--cgroup-dir-mode— sets the permission for the cgroup directory (default is700) 🔐--namespace,--ns— runs in a new namespace under the rootfs you specify 🌌--namespace-keep-mount— keeps the mountpoint you name inside your namespace 📌--namespace-net,--ns-net— adds a network namespace 🌐--enable-proxy-protocol— enables PROXY1 protocol support (only for http parsers, no cap) 🎫--reuse-port— enables theREUSE_PORTflag on the socket (BSD only, sorry bestie) ♻️--tcp-fast-open,--tcp-fastopen— enables theTCP_FASTOPENflag on TCP sockets with the qlen value you give ⚡--tcp-fast-open-client,--tcp-fastopen-client— usessendto(..., MSG_FASTOPEN, ...)instead ofconnect()if it's supported 🚀--zerg— attaches to a zerg server 👾--zerg-fallback— falls back to normal sockets if the zerg server isn't available 🪂--zerg-server— enables the zerg server on the UNIX socket you specify 🐛--cron— adds a cron task ⏰--cron2— adds a cron task (key=val syntax) ⏰🔑--unique-cron— adds a unique cron task ✨⏰--cron-harakiri— sets the max time (in seconds) we wait for a cron command to complete 🗡️--legion-cron,--cron-legion— adds a cron task that only runs when the instance is a lord of the legion you specify 👑--unique-legion-cron,--unique-cron-legion— adds a unique cron task that only runs when the instance is a lord of the legion you specify 👑✨--loop— selects the uWSGI loop engine 🔁--loop-list,--loops-list— lists the enabled loop engines 📋--worker-exec— runs the command you give as a worker 👷--worker-exec2— runs the command you give as a worker, but after thepost_forkhook 👷➕--attach-daemon— attaches a command/daemon to the master process (and heads up: 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), and 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-daemonbut the daemon only runs on the legion lord node 👑--legion-smart-attach-daemon— same as--smart-attach-daemonbut the daemon only runs on the legion lord node 👑--legion-smart-attach-daemon2— same as--smart-attach-daemon2but the daemon only runs on the legion lord node 👑--daemons-honour-stdin— does not change the stdin of external daemons to/dev/null🙅♀️--attach-daemon2— the attach-daemon keyval variant (supports smart modes too) 🗝️--plugins,--plugin— loads uWSGI plugins 🧩--need-plugins,--need-plugin— loads uWSGI plugins, and exits on error 🧩🛑--plugins-dir,--plugin-dir— adds a directory to the uWSGI plugin search path 📁--plugins-list,--plugin-list— lists the enabled plugins 📋--autoload— tries to automatically load plugins whenever unknown options pop up 🪄--dlopen— blindly loads a shared library 🙈 (yes, blindly, that's literally what it says)--allowed-modifiers— a comma separated list of allowed modifiers ✅--remap-modifier— remaps a request modifier from one id to another 🔀--dump-options— dumps the full list of every available option 📜--show-config— shows the current config, reformatted as ini 🪞--binary-append-data— returns the content of a resource to stdout so you can append it to a uwsgi binary (fordata://usage) 📎--print— a simple print 🖨️--iprint— a simple print, immediate version 🖨️⚡--exit— forcesexit()of the instance 🚪💀--cflags— reports the uWSGI CFLAGS (useful for building external plugins) 🏗️--dot-h— dumps theuwsgi.hused for building the core (useful for building external plugins) 🏗️--config-py— dumps theuwsgiconfig.pyused for building the core (useful for building external plugins) 🏗️--build-plugin— builds a uWSGI plugin for the current binary 🔨--version— prints the uWSGI version 🏷️--response-headers-limit— sets the response header maximum size (default:64k) 📏
and that's a wrap on the whole page bestie, you ATE this documentation 🎀✨ this was uwsgi_psgi version 2.0.31-6build1, dated August 2026, and yeah she's long but she's iconic and now she lives rent free in your brain 💖 no cap, go read your config files responsibly 🫶
📦 where this page comes from
- ubuntu stonking: uwsgi-plugin-psgi 2.0.31+6build1+0.0.2build3 · GPL-3.0-only
- 💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms