UWSGI_LUAJIT(1)
✨ NAME ✨
uwsgi_luajit — the fast (pure C), self-healing, developer-friendly WSGI server 💖
🦋 SYNOPSIS 🦋
uwsgi-core [options...]💅 DESCRIPTION 💅
okay bestie, gather round, because this is the whole menu of flags and it is a lot. every single one is here, no skips, no cap. let's go 🫶
-s,--socket— bind to the specified UNIX/TCP socket using the default protocol 🌸-s,--uwsgi-socket— bind to the specified UNIX/TCP socket using theuwsgiprotocol--suwsgi-socket— bind to the specified UNIX/TCP socket using theuwsgiprotocol over SSL 🔒--ssl-socket— bind to the specified UNIX/TCP socket using theuwsgiprotocol 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 HTTP 1.1 (Keep-Alive) protocol--https-socket— bind to the specified UNIX/TCP socket using 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 FastCGI protocol--fastcgi-nph-socket— bind to the specified UNIX/TCP socket using 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 SCGI protocol--scgi-nph-socket— bind to the specified UNIX/TCP socket using 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 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 persistentuwsgiprotocol (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 asigkill--harakiri-graceful-signal— use this signal instead ofsigtermfor 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 is1--strict— enable strict mode (placeholder cannot be used)--skip-zero— skip check of file descriptor0--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 from1)--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)--need-app— exit if no app can be loaded-M,--master— enable master process 👑--honour-stdin— do not remap stdin to/dev/null--emperor— run the Emperor--emperor-proxy-socket— force the vassal to became an Emperor proxy--emperor-wrapper— set a binary wrapper for vassals--emperor-wrapper-override— set a binary wrapper for vassals to try before the default one--emperor-wrapper-fallback— set a binary wrapper for vassals to try as a last resort--emperor-nofollow— do not follow symlinks when checking for mtime--emperor-procname— set the Emperor process name--emperor-freq— set the Emperor scan frequency (default3seconds)--emperor-required-heartbeat— set the Emperor tolerance about heartbeats 💓--emperor-curse-tolerance— set the Emperor tolerance about cursed vassals
okay that's part one bestie, there is so much more coming, don't go anywhere 💜
--emperor-pidfile— writes the Emperor pid into the file you name. keeping receipts on the main character emperor, periodt 👑--emperor-tyrant— puts the Emperor into Tyrant mode. it's giving absolute monarchy energy 💅--emperor-tyrant-nofollow— in Tyrant mode, do not follow symlinks when checking for uid/gid. lowkey a safety vibe check 🚫🔗--emperor-stats,--emperor-stats-server— runs the Emperor stats server. stats server said slay 📊✨--early-emperor— spawns the emperor as soon as possible. no waiting, main character energy fr fr ⏰--emperor-broodlord— runs the emperor in BroodLord mode. iconic name, no notes 🐉--emperor-throttle— sets the throttling level in milliseconds for bad behaving vassals (default1000). timeout for the misbehaving besties ⏳--emperor-max-throttle— sets the max throttling level in milliseconds for bad behaving vassals (default3 minutes). the ultimate time-out 🚫--emperor-magic-exec— prefixes vassals config files withexec://if they have the executable bit. magic indeed ✨--emperor-on-demand-extension,--emperor-on-demand-ext— searches for a text file (vassal name + extension) containing the on demand socket name. iykyk 🔍--emperor-on-demand-directory,--emperor-on-demand-dir— enables on demand mode binding to the unix socket in the specified directory named like the vassal +.socket. socket vibes 🧦--emperor-on-demand-exec— uses the output of the specified command as the on demand socket name (the vassal name is passed as the only argument). command said speak 🗣️--emperor-extra-extension,--emperor-extra-ext— allows the specified extension in the Emperor (vassal will be called with--config). extra, as a treat 🎀--emperor-no-blacklist— disables the Emperor blacklisting subsystem. no blacklist, only vibes 🚫📝--emperor-use-clone— usesclone()instead offork()passing the specifiedunshare()flags. clone era 🧬--emperor-graceful-shutdown— uses vassals graceful shutdown during ragnarok. ragnarok but make it polite 🕊️--emperor-cap,--vassals-cap,--vassal-cap— sets vassals capability. cap as in capabilities, not baseball cap 🧢--imperial-monitor-list,--imperial-monitors-list— lists enabled imperial monitors. monitor check 👀--vassals-inherit— adds config templates to vassals config (uses--inherit). inherit the vibe 🧬--vassals-include— includes config templates to vassals config (uses--includeinstead of--inherit). include, not inherit, bestie 📎--vassals-inherit-before— adds config templates to vassals config (uses--inherit, parses before the vassal file). before era ⏮️--vassals-include-before— includes config templates to vassals config (uses--includeinstead of--inherit, parses before the vassal file). before + include 🫶--vassals-start-hook— runs the specified command before each vassal starts. pre-game ritual 🎬--vassals-stop-hook— runs the specified command after vassal's death. post-mortem vibes 💀--vassal-sos— asks emperor for reinforcement when overloaded. sos bestie 🆘--vassal-sos-backlog— asks emperor for sos if backlog queue has more items than the value specified. queue too long? sos 📬--vassals-set,--vassal-set— automatically sets the specified option (via--set) for every vassal. set it and forget it 💅--heartbeat— announces healthiness to the emperor. healthy queen 💖--reload-mercy— sets the maximum time (in seconds) we wait for workers and other processes to die during reload/shutdown. mercy, but make it a deadline ⏱️--worker-reload-mercy— sets the maximum time (in seconds) a worker can take to reload/shutdown (default is60). worker said give me a minute ⏳--mule-reload-mercy— sets the maximum time (in seconds) a mule can take to reload/shutdown (default is60). mule mercy, same energy 🐴--exit-on-reload— forces exit even if a reload is requested. exit stage left 🚪--die-on-term— exits instead of brutal reload onSIGTERM. term says bye 👋--force-gateway— forces the spawn of the first registered gateway without a master. gateway said go solo 🚀-h|--help,-h|--usage— shows this help. help, but make it cute 🆘--print-sym,--print-symbol— prints content of the specified binary symbol. symbol reveal 🔍-r|--reaper— callswaitpid(-1,...)after each request to get rid of zombies. zombie apocalypse? not on my watch 🧟-R|--max-requests— reloads workers after the specified amount of managed requests. request limit, reload era 🔄--max-requests-delta— adds(worker_id * delta)to themax_requestsvalue of each worker. math but make it worker-specific 🧮--min-worker-lifetime— number of seconds a worker must run before being reloaded (default is10). minimum vibe time ⏲️--max-worker-lifetime— reloads workers after the specified amount of seconds (default is disabled). max lifetime, but off by default 🚫--max-worker-lifetime-delta— adds(worker_id * delta)seconds to themax_worker_lifetimevalue of each worker. delta magic ✨-z|--socket-timeout— sets internal sockets timeout. socket said don't wait up ⏳--no-fd-passing— disables file descriptor passing. no passing, periodt 🚫--locks— creates the specified number of shared locks. locks, but make it plural 🔒--lock-engine— sets the lock engine. engine of locks 🚂--ftok— sets the ipcsem key viaftok()for avoiding duplicates. no duplicates, bestie 🚫--persistent-ipcsem— does not remove ipcsem's on shutdown. persistent queen 👑-A|--sharedarea— creates a raw shared memory area of specified pages (note: it supports keyval too). shared area, shared vibes 🤝--safe-fd,--fd-safe— does not close the specified file descriptor. safe fd, no cap 🛡️--cache— creates a shared cache containing given elements. cache me outside, how bout dat? 🗃️--cache-blocksize— sets cache blocksize. block size, block party 🧱--cache-store— enables persistent cache to disk. save it for later 💾--cache-store-sync— sets frequency of sync for persistent cache. sync frequency, iykyk 🔄--cache-no-expire— disables auto sweep of expired items. no expiration, only vibes 🚫⏰--cache-expire-freq— sets the frequency of cache sweeper scans (default3seconds). sweep sweep 🧹--cache-report-freed-items— constantly reports the cache item freed by the sweeper (use only for debug). debug only, bestie 🐛--cache-udp-server— binds the cache udp server (used only for set/update/delete) to the specified socket. udp server said hi 📡--cache-udp-node— sends cache update/deletion to the specified cache udp server. udp node, sending signals 📶--cache-sync— copies the whole content of another uWSGI cache server on server startup. copy that, whole vibe 📋--cache-use-last-modified— updateslast_modified_attimestamp on every cache item modification (default is disabled). last modified era, off by default 🕒--add-cache-item— adds an item in the cache. add to cart 🛒--load-file-in-cache— loads a static file in the cache. file in cache, iconic 📁--load-file-in-cache-gzip— loads a static file in the cache with gzip compression. gzip said squeeze 🗜️--cache2— creates a new generation shared cache (keyval syntax). cache but generation 2 ✨--queue— enables shared queue. queue era 🎟️--queue-blocksize— sets queue blocksize. queue block party 🧱--queue-store— enables persistent queue to disk. queue saved to disk 💾--queue-store-sync— sets frequency of sync for persistent queue. sync frequency, queue edition 🔄-Q|--spooler— runs a spooler on the specified directory. spooler, not spoiler 🎬--spooler-external— maps spoolers requests to a spooler directory managed by an external instance. external spooler vibes 🌐--spooler-ordered— tries to order the execution of spooler tasks. order in the court 👩⚖️--spooler-chdir—chdir()to specified directory before each spooler task. change directory, change vibe 📂--spooler-processes— sets the number of processes for spoolers. spooler processes, plural 🧑🤝🧑--spooler-quiet— do not be verbose with spooler tasks. quiet spooler, no yapping 🤫--spooler-max-tasks— sets the maximum number of tasks to run before recycling a spooler. max tasks, then recycle ♻️--spooler-harakiri— sets harakiri timeout for spooler tasks. harakiri timeout, dramatic 💀--spooler-frequency,--spooler-freq— sets spooler frequency. frequency, spooler edition 📻--mule— adds a mule. mule said hi 🐴--mules— adds the specified number of mules. mules, plural 🐴🐴--farm— adds a mule farm. farm era 🚜--mule-msg-size— sets mule message buffer size. message buffer size, mule edition 📨--signal— sends a uwsgi signal to a server. signal sent 📡--signal-bufsize,--signals-bufsize— sets buffer size for signal queue. signal buffer size, queue vibes 📶--signal-timer,--timer— adds a timer (syntax:<signal> <seconds>). timer said tick tock ⏰--signal-rbtimer,--rbtimer— adds a redblack timer (syntax:<signal> <seconds>). redblack timer, fancy ⏱️--rpc-max— maximum number of rpc slots (default:64). rpc slots, maxed out 🎰-L|--disable-logging— disables request logging. no logging, no yapping 🚫📝--flock— locks the specified file before starting, exits if locked. flock and roll 🐑--flock-wait— locks the specified file before starting, waits if locked. wait for it 🕰️--flock2— locks the specified file after logging/daemon setup, exits if locked. flock but later 🐑--flock-wait2— locks the specified file after logging/daemon setup, waits if locked. wait but later 🕰️--pidfile— creates pidfile (before privileges drop). pidfile before the drop 👑--pidfile2— creates pidfile (after privileges drop). pidfile after the drop 💅--safe-pidfile— creates safe pidfile (before privileges drop). safe pidfile, before 🛡️--safe-pidfile2— creates safe pidfile (after privileges drop). safe pidfile, after 🛡️--chroot—chroot()to the specified directory. chroot jail, but make it cute 🏠--pivot-root,--pivot_root—pivot_root()to the specified directories (new_rootandput_oldmust be separated with a space). pivot root, space required 🚪--uid—setuidto the specified user/uid. uid said set it 🆔--gid—setgidto the specified group/gid. gid said set it 🆔--add-gid— adds the specified group id to the process credentials. add gid to the credentials 🪪--immediate-uid—setuidto the specified user/uid IMMEDIATELY. immediate uid, no waiting ⚡--immediate-gid—setgidto the specified group/gid IMMEDIATELY. immediate gid, no waiting ⚡--no-initgroups— disables additional groups set viainitgroups(). no initgroups, no extra groups 🚫--cap— sets process capability. process capability, cap it 🧢--unshare—unshare()part of the processes and puts it in a new namespace. unshare, new namespace era 🌌--unshare2—unshare()part of the processes and puts it in a new namespace after rootfs change. unshare but after rootfs change 🌌--setns-socket— exposes a unix socket returning namespace fds from/proc/self/ns. setns socket, namespace fds 📡--setns-socket-skip,--setns-skip— skips the specified entry when sending setns file descriptors. skip it, setns edition 🚫--setns— joins a namespace created by an external uWSGI instance. setns, join the namespace 🌌--setns-preopen— opens/proc/self/nsas soon as possible and caches fds. preopen, cache the fds 🗂️--jailed— mark the instance as jailed (and yes, that forces the execution ofpost_jailhooks) 💅--refork—fork()again after privileges drop. Useful for jailing systems ✨--re-fork—fork()again after privileges drop. Useful for jailing systems 🦋--refork-as-root—fork()again before privileges drop. Useful for jailing systems 🔥--re-fork-as-root—fork()again before privileges drop. Useful for jailing systems 🔥--refork-post-jail—fork()again after jailing. Useful for jailing systems 🌸--re-fork-post-jail—fork()again after jailing. Useful for jailing systems 🌸--hook-asap— run the specified hook as soon as possible ⚡--hook-pre-jail— run the specified hook before jailing 🧚--hook-post-jail— run the specified hook after jailing 🧚--hook-in-jail— run the specified hook in jail after initialization 💫--hook-as-root— run the specified hook before privileges drop 👑--hook-as-user— run the specified hook after privileges drop 🫶--hook-as-user-atexit— run the specified hook before app exit and reload 🙈--hook-pre-app— run the specified hook before app loading 🍓--hook-post-app— run the specified hook after app loading 🍓--hook-post-fork— run the specified hook after each fork 🌀--hook-accepting— run the specified hook after each worker enter the accepting phase 🎀--hook-accepting1— run the specified hook after the first worker enters the accepting phase 🎀--hook-accepting-once— run the specified hook after each worker enter the accepting phase (once per-instance) 🎀--hook-accepting1-once— run the specified hook after the first worker enters the accepting phase (once per instance) 🎀--hook-master-start— run the specified hook when the Master starts 👑--hook-touch— run the specified hook when the specified file is touched(syntax: <file> <action>)💥--hook-emperor-start— run the specified hook when the Emperor starts 👑--hook-emperor-stop— run the specified hook when the Emperor send a stop message 🛑--hook-emperor-reload— run the specified hook when the Emperor send a reload message 🔄--hook-emperor-lost— run the specified hook when the Emperor connection is lost 😭--hook-as-vassal— run the specified hook 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 ✨--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-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 👑--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 👑--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 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 👑--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 callingshutdown()in addition toclose()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— signal when the specified file is modified/touched (syntax:file signal). Like, you give it a file and a signal, and it fires that signal when the file gets touched. 💅--fs-reload— graceful reload when the specified filesystem object is modified. So if something in the filesystem changes, it does a graceful reload. So chill. 🦋--fs-brutal-reload— brutal reload when the specified filesystem object is modified. No chill, just straight up brutal reload when that filesystem object changes. 💀--fs-signal— raise a uwsgi signal when the specified filesystem object is modified (syntax:file signal). It's giving "I'll signal uwsgi when this file changes". Periodt. ✨--check-mountpoint— destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management). Like, if the mountpoint ghosts you, the instance gets destroyed. Bye. 🫶--mountpoint-check— destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management). Same vibe as above, just a different name. Still destroys if filesystem unreachable. 💖--check-mount— destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management). Yep, another alias. Destroy on unreachable filesystem. 🔥--mount-check— destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management). The last of the mount-check squad. Same energy. 🌈--propagate-touch— over-engineering option for system with flaky signal management. Like, if your signal management is a mess, this is extra. But hey, it's there. 🙈--limit-post— limit request body. Just caps how much body you can send. Simple. 🍓--no-orphans— automatically kill workers if master dies (can be dangerous for availability). So if the master dips, workers get killed. But careful, it might mess with availability. ⚠️--prio— set processes/threads priority. You can set the priority, bestie. 💜--cpu-affinity— set cpu affinity. Pin those processes to specific CPUs. Slay. 🎀--post-buffering— set size in bytes after which will buffer to disk instead of memory. So when the request body gets too big, it goes to disk instead of RAM. iykyk. 💙--post-buffering-bufsize— set buffer size for read() in post buffering mode. Sets the buffer size forread()when post buffering is on. No cap. 📖--body-read-warning— set the amount of allowed memory allocation (in megabytes) for request body before starting printing a warning. So if the body allocation goes over this many MB, you get a warning. Heads up. ⚠️--upload-progress— enable creation of .json files in the specified directory during a file upload. It makes.jsonfiles in that dir while uploading. Track that progress, bestie. 📊--no-default-app— do not fallback to default app. No default app fallback. It's giving "I stand alone". 🚫--manage-script-name— automatically rewrite SCRIPT_NAME and PATH_INFO. It auto-rewrites those. Magic. ✨--ignore-script-name— ignore SCRIPT_NAME. Just ignore it. Bye. 🙅♀️--catch-exceptions— report exception as http output (discouraged, use only for testing). So it shows exceptions as HTTP output, but don't do it in prod, okay? Only for testing. 💀--reload-on-exception— reload a worker when an exception is raised. If an exception pops off, the worker gets reloaded. 🔄--reload-on-exception-type— reload a worker when a specific exception type is raised. Same but for a specific exception type. 🎯--reload-on-exception-value— reload a worker when a specific exception value is raised. Yep, for a specific value. 💎--reload-on-exception-repr— reload a worker when a specific exception type+value (language-specific) is raised. Type+value, language-specific. Fancy. 🧚--exception-handler— add an exception handler. You can add a handler for exceptions. Handle it. 💅--enable-metrics— enable metrics subsystem. Turn on the metrics subsystem. Let's get those numbers. 📈--metric— add a custom metric. Add your own metric. Customize it. 🎨--metric-threshold— add a metric threshold/alarm. Set a threshold or alarm for a metric. 🚨--metric-alarm— add a metric threshold/alarm. Same thing, different name. Alarm it up. 🔔--alarm-metric— add a metric threshold/alarm. Another alias. Same energy. ⏰--metrics-dir— export metrics as text files to the specified directory. Dump those metrics as text files in a dir. 📁--metrics-dir-restore— restore last value taken from the metrics dir. Restore the last value from that metrics dir. Rewind. ⏪--metric-dir— export metrics as text files to the specified directory. Same as--metrics-dirbut shorter. Still exports text files. 📂--metric-dir-restore— restore last value taken from the metrics dir. Same restore vibe. ⏮️--metrics-no-cores— disable generation of cores-related metrics. No cores metrics. Skip that. 🚫--udp— run the udp server on the specified address. Runs a UDP server on the address you give. 🌐--stats— enable the stats server on the specified address. Turn on the stats server at that address. 📊--stats-server— enable the stats server on the specified address. Same thing. Stats server, go. 🚀--stats-http— prefix stats server json output with http headers. Adds HTTP headers before the JSON. Fancy. 🎩--stats-minified— minify statistics json output. Makes the JSON smol. 🐜--stats-min— minify statistics json output. Same minify energy. 📉--stats-push— push the stats json to the specified destination. Pushes stats JSON to a destination. Send it. 📤--stats-pusher-default-freq— set the default frequency of stats pushers. Sets how often stats pushers push. Default freq. ⏱️--stats-pushers-default-freq— set the default frequency of stats pushers. Same thing, plural. Still freq. 🕒--stats-no-cores— disable generation of cores-related stats. No cores stats. Skip. 🚫--stats-no-metrics— do not include metrics in stats output. Metrics not included in stats. Bye. 📊--multicast— subscribe to specified multicast group. Join that multicast group. 👯♀️--multicast-ttl— set multicast ttl. Set the TTL. ⏳--multicast-loop— set multicast loop (default 1). Set the loop, default is1. 🔁--master-fifo— enable the master fifo. Turn on the master FIFO. 🎛️--notify-socket— enable the notification socket. Enable the notification socket. 🔔--subscription-notify-socket— set the notification socket for subscriptions. Set the notification socket specifically for subscriptions. 📬--legion— became a member of a legion. Join a legion. ⚔️--legion-mcast— became a member of a legion (shortcut for multicast). Same but shortcut for multicast. 🚀--legion-node— add a node to a legion. Add a node to the legion. ➕--legion-freq— set the frequency of legion packets. Set the freq of legion packets. 📡--legion-tolerance— set the tolerance of legion subsystem. Set the tolerance. 🤝--legion-death-on-lord-error— declare itself as a dead node for the specified amount of seconds if one of the lord hooks fails. If a lord hook fails, it declares itself dead for the specified amount of seconds. Dramatic. 💀--legion-skew-tolerance— set the clock skew tolerance of legion subsystem (default 60 seconds). Set clock skew tolerance, default is60seconds. ⏰--legion-lord— action to call on Lord election. Action when Lord is elected. 👑--legion-unlord— action to call on Lord dismiss. Action when Lord is dismissed. 🚫--legion-setup— action to call on legion setup. Action on legion setup. 🛠️--legion-death— action to call on legion death (shutdown of the instance). Action on legion death (shutdown). 💀--legion-join— action to call on legion join (first time quorum is reached). Action when legion joins (first quorum). 🎉--legion-node-joined— action to call on new node joining legion. Action when a new node joins. 👋--legion-node-left— action to call node leaving legion. Action when a node leaves. 👋--legion-quorum— set the quorum of a legion. Set the quorum. 🗳️--legion-scroll— set the scroll of a legion. Set the scroll. 📜--legion-scroll-max-size— set max size of legion scroll buffer. Max size of scroll buffer. 📏--legion-scroll-list-max-size— set max size of legion scroll list buffer. Max size of scroll list buffer. 📋--subscriptions-sign-check— set digest algorithm and certificate directory for secured subscription system. Sets digest algo and cert dir for secured subscriptions. 🔐--subscriptions-sign-check-tolerance— set the maximum tolerance (in seconds) of clock skew for secured subscription system. Max tolerance in seconds for clock skew. ⏳--subscriptions-sign-skip-uid— skip signature check for the specified uid when using unix sockets credentials. Skip sig check for that uid with unix socket creds. 🆔--subscriptions-credentials-check— add a directory to search for subscriptions key credentials. Add a dir to search for subscription key creds. 🔑--subscriptions-use-credentials— enable management of SCM_CREDENTIALS in subscriptions UNIX sockets. EnableSCM_CREDENTIALSmanagement in subscriptions UNIX sockets. 🔓--subscription-algo— set load balancing algorithm for the subscription system. Set the load balancing algo for subscriptions. ⚖️--subscription-dotsplit— try to fallback to the next part (dot based) in subscription key. Try fallback to next dot-based part in subscription key. 🔍--subscribe-to— subscribe to the specified subscription server. Subscribe to that server. 📬--st— subscribe to the specified subscription server. Short for--subscribe-to. Same. 📩--subscribe— subscribe to the specified subscription server. Same subscribe energy. 📨--subscribe2— subscribe to the specified subscription server using advanced keyval syntax. Subscribe with advanced keyval syntax. Fancy. 🎩--subscribe-freq— send subscription announce at the specified interval. Send announce at that interval. ⏰--subscription-tolerance— set tolerance for subscription servers. Set tolerance for subscription servers. 🤝--unsubscribe-on-graceful-reload— force unsubscribe request even during graceful reload. Force unsubscribe even on graceful reload. Bye. 👋--start-unsubscribed— configure subscriptions but do not send them (useful with master fifo). Configure but don't send. Useful with master FIFO. 📝--subscribe-with-modifier1— force the specififed modifier1 when subscribing. Force that modifier1 when subscribing. (Yes, it says "specififed" — we keep it real.) 💅--snmp— enable the embedded snmp server. Turn on the embedded SNMP server. 🌐--snmp-community— set the snmp community string. Set the SNMP community string. 🔑--ssl-verbose— be verbose about SSL errors. Be loud about SSL errors. 📢--ssl-verify-depth— set maximum certificate verification depth. Set max cert verification depth. 📏--sni— add an SNI-governed SSL context. Add an SNI-governed SSL context. 🔒--sni-dir— check for cert/key/client_ca file in the specified directory and create a sni/ssl context on demand. Checks forcert/key/client_cafiles in the dir and creates an SNI/SSL context on demand. 🗂️--sni-dir-ciphers— set ssl ciphers for sni-dir option. Set SSL ciphers forsni-dir. 🔐--ssl-enable3— enable SSLv3 (insecure). Enables SSLv3, but it's insecure. Don't. 🚫--ssl-enable-sslv3— enable SSLv3 (insecure). Same insecure SSLv3. 💀--ssl-enable-tlsv1— enable TLSv1 (insecure). Enables TLSv1, also insecure. ⚠️--ssl-option— set a raw ssl option (numeric value). Set a raw SSL option with a numeric value. 🔢--sni-regexp— add an SNI-governed SSL context (the key is a regexp). Add SNI-governed SSL context where the key is a regexp. 🧩--ssl-tmp-dir— store ssl-related temp files in the specified directory. Store SSL temp files in that dir. 🗃️--check-interval— set the interval (in seconds) of master checks. Set master check interval in seconds. ⏲️--forkbomb-delay— sleep for the specified number of seconds when a forkbomb is detected. If a forkbomb is detected, sleep for the specified number of seconds. 😴--binary-path— force binary path. Force the binary path. 📂--privileged-binary-patch— patch the uwsgi binary with a new command (before privileges drop). 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). Same but after privileges drop. 🩹--privileged-binary-patch-arg— patch the uwsgi binary with a new command and arguments (before privileges drop). Patch with command and args before drop. 🧰--unprivileged-binary-patch-arg— patch the uwsgi binary with a new command and arguments (after privileges drop). Patch with command and args after drop. 🧰--async— enable async mode with specified cores. Enable async mode with the cores you specify. ⚡--max-fd— set maximum number of file descriptors (requires root privileges). Set max file descriptors, needs root. 🔓--logto— set logfile/udp address. Set the logfile or UDP address. 📝--logto2— log to specified file or udp address after privileges drop. Log to file or UDP after privileges drop. 📤--log-format— set advanced format for request logging. Set advanced format for request logs. 🎨--logformat— set advanced format for request logging. Same as above. 🖌️--logformat-strftime— apply strftime to logformat output. Applystrftimeto logformat output. 🕰️--log-format-strftime— apply strftime to logformat output. Same. ⏳--logfile-chown— chown logfiles.chownthe logfiles. 👤--logfile-chmod— chmod logfiles.chmodthe logfiles. 🔧--log-syslog— log to syslog. Log to syslog. 📡--log-socket— send logs to the specified socket. Send logs to that socket. 🔌--req-logger— set/append a request logger. Set or append a request logger. 📋--logger-req— set/append a request logger. Same. 📋--logger— set/append a logger. Set or append a logger. 📝--logger-list— list enabled loggers. List enabled loggers. 📃--loggers-list— list enabled loggers. Same list. 📃--threaded-logger— offload log writing to a thread. Offload log writing to a thread. 🧵--log-encoder— add an item in the log encoder chain. Add an item to the log encoder chain. ⛓️--log-req-encoder— add an item in the log req encoder chain. Add an item to the log req encoder chain. ⛓️--log-drain— drain (do not show) log lines matching the specified regexp. Drain (don't show) log lines matching the regexp. 🚫--log-filter— show only log lines matching the specified regexp. Show only log lines matching the regexp. 🔍--log-route— log to the specified named logger if regexp applied on logline matches. Log to the named logger if the regexp matches the logline. 🛤️--log-req-route— log requests to the specified named logger if regexp applied on logline matches. Same for requests. 🛤️--use-abort— call abort() on segfault/fpe, could be useful for generating a core dump. Callsabort()on segfault/FPE, might help with core dumps. 💥--alarm— create a new alarm, syntax: <alarm> <plugin:args>. Create a new alarm. Syntax is<alarm> <plugin:args>. 🚨--alarm-cheap— bestie, this uses the main alarm thread instead of creating dedicated threads for curl-based alarms. no cap, it's giving efficiency 💅--alarm-freq— tunes the anti-loop alarm system (default 3 seconds). lowkey important ⏰--alarm-fd— raises the specified alarm when an fd is read for read (by default it reads 1 byte, set 8 for eventfd). okay so fd energy, periodt 👀--alarm-segfault— raises the specified alarm when the segmentation fault handler is executed. segfault? not today, bestie 💀--segfault-alarm— raises the specified alarm when the segmentation fault handler is executed. alias alert, same energy 🚨--alarm-backlog— raises the specified alarm when the socket backlog queue is full. queue full? alarm goes brrr 🔔--backlog-alarm— raises the specified alarm when the socket backlog queue is full. alias vibes 🫶--lq-alarm— raises the specified alarm when the socket backlog queue is full. lq? listen queue, iykyk 🎧--alarm-lq— raises the specified alarm when the socket backlog queue is full. another alias, periodt 💅--alarm-listen-queue— raises the specified alarm when the socket backlog queue is full. listen queue said "i'm full" 😭--listen-queue-alarm— raises the specified alarm when the socket backlog queue is full. alias, no cap 🌈--log-alarm— raises the specified alarm when a log line matches the specified regexp, syntax:<alarm>[,alarm...] <regexp>. regexp match? alarm time, bestie 🔥--alarm-log— raises the specified alarm when a log line matches the specified regexp, syntax:<alarm>[,alarm...] <regexp>. alias, same syntax 🌸--not-log-alarm— skips the specified alarm when a log line matches the specified regexp, syntax:<alarm>[,alarm...] <regexp>. skip it, not me 🙈--not-alarm-log— skips the specified alarm when a log line matches the specified regexp, syntax:<alarm>[,alarm...] <regexp>. alias, skip vibes 🦋--alarm-list— lists enabled alarms. let's see what's enabled, bestie 👑--alarms-list— lists enabled alarms. alias, same list energy ✨--alarm-msg-size— sets the max size of an alarm message (default 8192). big message energy, but capped 📏--log-master— delegates logging to master process. master said "i got this" 💪--log-master-bufsize— sets the buffer size for the master logger. bigger log messages will be truncated. truncation vibes ✂️--log-master-stream— creates the master logpipe as SOCK_STREAM. stream mode, slay 🌊--log-master-req-stream— creates the master requests logpipe as SOCK_STREAM. requests logpipe, stream mode 🎀--log-reopen— reopens log after reload. reload? reopen that log, periodt 🔄--log-truncate— truncates log on startup. fresh start, truncate it 💅--log-maxsize— sets maximum logfile size. maxsize, don't let it get huge 🐘--log-backupname— sets logfile name after rotation. rotation? name it, bestie 📛--logdate— prefixes logs with date or a strftime string. date prefix, main character energy 📅--log-date— prefixes logs with date or a strftime string. alias, same date vibes 🗓️--log-prefix— prefixes logs with a string. custom prefix, cute 🎀--log-zero— logs responses without body. no body? still log it 👻--log-slow— logs requests slower than the specified number of milliseconds. slow? log it, bestie 🐢--log-4xx— logs requests with a 4xx response. 4xx said "log me" 📝--log-5xx— logs requests with a 5xx response. 5xx? yeah, log that too 🚨--log-big— logs requests bigger than the specified size. big request energy 🐘--log-sendfile— logs sendfile requests. sendfile, logged 📁--log-ioerror— logs requests with io errors. io error? log it, fr fr 💥--log-micros— reports response time in microseconds instead of milliseconds. micros, highkey precise 🔬--log-x-forwarded-for— uses the ip from X-Forwarded-For header instead of REMOTE_ADDR. X-Forwarded-For said "use my ip" 🌐--master-as-root— leaves master process running as root. root energy 🌶️--drop-after-init— runs privileges drop after plugin initialization, superseded by drop-after-apps. drop those privileges, but note it's superseded by drop-after-apps 🧚--drop-after-apps— runs privileges drop after apps loading, superseded by master-as-root. drop after apps, but master-as-root supersedes it 👑--force-cwd— forces the initial working directory to the specified value. cwd said "i'm forced" 📂--binsh— overrides /bin/sh (used by exec hooks, it always fallback to /bin/sh). override binsh, but it always fallback to /bin/sh, no cap 🐚--chdir— chdir to specified directory before apps loading. chdir before apps, periodt 📁--chdir2— chdir to specified directory after apps loading. chdir after apps, slay 📂--lazy— sets lazy mode (load apps in workers instead of master). lazy mode, but make it fashion 💅--lazy-apps— loads apps in each worker instead of the master. lazy apps, each worker gets a copy 🧬--cheap— sets cheap mode (spawn workers only after the first request). cheap mode, spawn on first request 💸--cheaper— sets cheaper mode (adaptive process spawning). cheaper mode, adaptive spawning, ate 🍽️--cheaper-initial— sets the initial number of processes to spawn in cheaper mode. initial processes, set it 🌱--cheaper-algo— choose to algorithm used for adaptive process spawning. pick the algo, bestie 🧠--cheaper-step— number of additional processes to spawn at each overload. step it up at overload 🪜--cheaper-overload— increase workers after specified overload. overload? increase workers 📈--cheaper-algo-list— lists enabled cheapers algorithms. list those algos 📋--cheaper-algos-list— lists enabled cheapers algorithms. alias, same list energy ✨--cheaper-list— lists enabled cheapers algorithms. another alias, periodt 💅--cheaper-rss-limit-soft— don't spawn new workers if total resident memory usage of all workers is higher than this limit. soft limit, don't spawn if memory is high 🧠--cheaper-rss-limit-hard— if total workers resident memory usage is higher try to stop workers. hard limit, try to stop workers 🛑--idle— sets idle mode (put uWSGI in cheap mode after inactivity). idle mode, cheap mode after inactivity 😴--die-on-idle— shutdowns uWSGI when idle. die on idle, dramatic but valid 💀--mount— loads application under mountpoint. mount it, bestie 🏔️--worker-mount— loads application under mountpoint in the specified worker or after workers spawn. worker mount, specific worker or after spawn 👷--threads— runs each worker in prethreaded mode with the specified number of threads. threads, prethreaded mode, slay 🧵--thread-stacksize— sets threads stacksize. stacksize, set it 📚--threads-stacksize— sets threads stacksize. alias, same stacksize energy 🧵--thread-stack-size— sets threads stacksize. another alias, periodt 💅--threads-stack-size— sets threads stacksize. alias again, no cap 🌈--vhost— enables virtualhosting mode (based on SERVER_NAME variable). vhost mode, based on SERVER_NAME 🏠--vhost-host— enables virtualhosting mode (based on HTTP_HOST variable). vhost-host, based on HTTP_HOST 🏡--route— adds a route. route added, periodt 🛣️--route-host— adds a route based on Host header. route based on Host header 🏷️--route-uri— adds a route based on REQUEST_URI. route based on REQUEST_URI 🔗--route-qs— adds a route based on QUERY_STRING. route based on QUERY_STRING ❓--route-remote-addr— adds a route based on REMOTE_ADDR. route based on REMOTE_ADDR 🌐--route-user-agent— adds a route based on HTTP_USER_AGENT. route based on HTTP_USER_AGENT 🕵️--route-remote-user— adds a route based on REMOTE_USER. route based on REMOTE_USER 👤--route-referer— adds a route based on HTTP_REFERER. route based on HTTP_REFERER 🔙--route-label— adds a routing label (for use with goto). routing label, for goto 🏷️--route-if— adds a route based on condition. route based on condition 🤔--route-if-not— adds a route based on condition (negate version). route based on condition, negate version 🙃--route-run— always runs the specified route action. always run that route action 🏃--final-route— adds a final route. final route, periodt 🏁--final-route-status— adds a final route for the specified status. final route for status 📟--final-route-host— adds a final route based on Host header. final route based on Host header 🏷️--final-route-uri— adds a final route based on REQUEST_URI. final route based on REQUEST_URI 🔗--final-route-qs— adds a final route based on QUERY_STRING. final route based on QUERY_STRING ❓--final-route-remote-addr— adds a final route based on REMOTE_ADDR. final route based on REMOTE_ADDR 🌐--final-route-user-agent— adds a final route based on HTTP_USER_AGENT. final route based on HTTP_USER_AGENT 🕵️--final-route-remote-user— adds a final route based on REMOTE_USER. final route based on REMOTE_USER 👤--final-route-referer— adds a final route based on HTTP_REFERER. final route based on HTTP_REFERER 🔙--final-route-label— adds a final routing label (for use with goto). final routing label, for goto 🏷️--final-route-if— adds a final route based on condition. final route based on condition 🤔--final-route-if-not— adds a final route based on condition (negate version). final route based on condition, negate version 🙃--final-route-run— always runs the specified final route action. always run final route action 🏃--error-route— adds an error route. error route, added 🚨--error-route-status— adds an error route for the specified status. error route for status 📟--error-route-host— adds an error route based on Host header. error route based on Host header 🏷️--error-route-uri— adds an error route based on REQUEST_URI. error route based on REQUEST_URI 🔗--error-route-qs— adds an error route based on QUERY_STRING. error route based on QUERY_STRING ❓--error-route-remote-addr— adds an error route based on REMOTE_ADDR. error route based on REMOTE_ADDR 🌐--error-route-user-agent— adds an error route based on HTTP_USER_AGENT. error route based on HTTP_USER_AGENT 🕵️--error-route-remote-user— adds an error route based on REMOTE_USER. error route based on REMOTE_USER 👤--error-route-referer— adds an error route based on HTTP_REFERER. error route based on HTTP_REFERER 🔙--error-route-label— adds an error routing label (for use with goto). error routing label, for goto 🏷️--error-route-if— adds an error route based on condition. error route based on condition 🤔--error-route-if-not— adds an error route based on condition (negate version). error route based on condition, negate version 🙃--error-route-run— always runs the specified error route action. always run error route action 🏃--response-route— adds a response route. response route, added 📬--response-route-status— adds a response route for the specified status. response route for status 📟--response-route-host— adds a response route based on Host header. response route based on Host header 🏷️--response-route-uri— adds a response route based on REQUEST_URI. response route based on REQUEST_URI 🔗--response-route-qs— adds a response route based on QUERY_STRING. response route based on QUERY_STRING ❓--response-route-remote-addr— adds a response route based on REMOTE_ADDR. response route based on REMOTE_ADDR 🌐--response-route-user-agent— adds a response route based on HTTP_USER_AGENT. response route based on HTTP_USER_AGENT 🕵️--response-route-remote-user— adds a response route based on REMOTE_USER. response route based on REMOTE_USER 👤--response-route-referer— adds a response route based on HTTP_REFERER. response route based on HTTP_REFERER 🔙--response-route-label— adds a response routing label (for use with goto). response routing label, for goto 🏷️--response-route-if— adds a response route based on condition. response route based on condition 🤔--response-route-if-not— adds a response route based on condition (negate version). response route based on condition, negate version 🙃--response-route-run— always runs the specified response route action. always run response route action 🏃--router-list— lists enabled routers. list routers, periodt 📋--routers-list— lists enabled routers. alias, same list energy ✨--error-page-403— adds an error page (html) for managed 403 response. 403 error page, html 🚫--error-page-404— adds an error page (html) for managed 404 response. 404 error page, html 🔍--error-page-500— adds an error page (html) for managed 500 response. 500 error page, html 💥--websockets-ping-freq— sets the frequency (in seconds) of websockets automatic ping packets. ping freq, in seconds 🏓--websocket-ping-freq— sets the frequency (in seconds) of websockets automatic ping packets. alias, same ping energy 🏓--websockets-pong-tolerance— sets the tolerance (in seconds) of websockets ping/pong subsystem. pong tolerance, in seconds 🏓--websocket-pong-tolerance— sets the tolerance (in seconds) of websockets ping/pong subsystem. alias, same tolerance vibes 🏓--websockets-max-size— sets the max allowed size of websocket messages (in Kbytes, default 1024). max size, in Kbytes, default 1024 📦--websocket-max-size— sets the max allowed size of websocket messages (in Kbytes, default 1024). alias, same max size energy 📦--chunked-input-limit— sets the max size of a chunked input part (default 1MB, in bytes). chunked input limit, default 1MB in bytes 🧩--chunked-input-timeout— sets default timeout for chunked input. chunked input timeout, set it ⏳--clock— sets a clock source. clock source, set it ⏰--clock-list— lists enabled clocks. list those clocks, periodt 🕰️--clocks-list— lists all the clocks that are enabled rn ⏰--add-header— automatically adds HTTP headers to the response for you, no manual labour 💅--rem-header— automatically removes a specified HTTP header from the response--del-header— same energy as--rem-header, it automatically removes a specified HTTP header from the response 🗑️--collect-header— stores the specified response header in a request var (syntax: header var)--response-header-collect— stores the specified response header in a request var (syntax: header var)--pull-header— stores the specified response header in a request var and removes it from the response (syntax: header var) — it's giving grab-and-go ✨--check-static— checks for static files in the directory you specify 📂--check-static-docroot— checks for static files in the requestedDOCUMENT_ROOT--static-check— checks for static files in the directory you specify--static-map— maps a mountpoint to a static directory (or a file) 🗺️--static-map2— like--static-mapbut it completely appends the requested resource to the docroot--static-skip-ext— skips the specified extension from staticfile checks 🙈--static-index— searches for the specified file if a directory is requested--static-safe— skips security checks if the file is under the specified path 🛡️--static-cache-paths— puts resolved paths in the uWSGI cache for the specified amount of seconds--static-cache-paths-name— uses 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 theExpiresheader based on content type--static-expires-type-mtime— sets theExpiresheader based on content type and file mtime--static-expires— sets theExpiresheader based on a filename regexp--static-expires-mtime— sets theExpiresheader based on a filename regexp and file mtime--static-expires-uri— sets theExpiresheader based on aREQUEST_URIregexp--static-expires-uri-mtime— sets theExpiresheader based on aREQUEST_URIregexp and file mtime--static-expires-path-info— sets theExpiresheader based on aPATH_INFOregexp--static-expires-path-info-mtime— sets theExpiresheader based on aPATH_INFOregexp and file mtime--static-gzip— if the regexp you supply matches the static file translation, it will search 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 HTTPRangeheader 📏--offload-threads— sets the number of offload threads to spawn (per-worker, default0)--offload-thread— sets the number of offload threads to spawn (per-worker, default0)--file-serve-mode— sets the static file serving mode--fileserve-mode— sets the static file serving mode--disable-sendfile— disablessendfile()and relies on boringread()/write()instead 😴--check-cache— checks for response data in the specified cache (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 uWSGI custom mode--env— sets an environment variable 🌱--envdir— loads a daemontools compatible envdir--early-envdir— loads a daemontools compatible envdir ASAP ⚡--unenv— unsets an environment variable--vacuum— tries to remove all of the generated file/sockets 🧹--file-write— writes the specified content to the specified file (syntax: file=value) before privileges drop--cgroup— puts the processes in the specified cgroup--cgroup-opt— sets a value in the specified cgroup option--cgroup-dir-mode— sets permission for the cgroup directory (default is700)--namespace— runs in a new namespace under the specified rootfs--namespace-keep-mount— keeps the specified mountpoint in your namespace--ns— runs in a new namespace under the specified rootfs--namespace-net— adds a network namespace 🌐--ns-net— adds a network namespace--enable-proxy-protocol— enables PROXY1 protocol support (only for http parsers)--reuse-port— enables theREUSE_PORTflag on socket (BSD only)--tcp-fast-open— enables theTCP_FASTOPENflag on TCP sockets with the specified qlen value 🚀--tcp-fastopen— enables theTCP_FASTOPENflag on TCP sockets with the specified qlen value--tcp-fast-open-client— usessendto(..., MSG_FASTOPEN, ...)instead ofconnect()if supported--tcp-fastopen-client— usessendto(..., MSG_FASTOPEN, ...)instead ofconnect()if supported--zerg— attaches to a zerg server 🐛--zerg-fallback— falls back to normal sockets if the zerg server is not available--zerg-server— enables the zerg server on the specified UNIX socket--cron— adds a cron task ⏳--cron2— adds a cron task (key=val syntax)--unique-cron— adds a unique cron task--cron-harakiri— sets the maximum time (in seconds) we wait for the cron command to complete 💀--legion-cron— adds a cron task runnable only when the instance is a lord of the specified legion 👑--cron-legion— adds a cron task runnable only when the instance is a lord of the specified legion--unique-legion-cron— adds a unique cron task runnable only when the instance is a lord of the specified legion--unique-cron-legion— adds a unique cron task runnable only when the instance is a lord of the specified legion--loop— selects the uWSGI loop engine 🔁--loop-list— lists enabled loop engines--loops-list— lists enabled loop engines--worker-exec— runs the specified command as worker--worker-exec2— runs the specified command as worker (after thepost_forkhook)--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-daemonbut the daemon runs only on the legion lord node--legion-smart-attach-daemon— same as--smart-attach-daemonbut the daemon runs only on the legion lord node--legion-smart-attach-daemon2— same as--smart-attach-daemon2but 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— the attach-daemon keyval variant (supports smart modes too)--plugins— loads uWSGI plugins 🧩--plugin— loads uWSGI plugins--need-plugins— loads uWSGI plugins (exit on error)--need-plugin— loads uWSGI plugins (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— lists enabled plugins--plugin-list— lists enabled plugins--autoload— tries to automatically load plugins when unknown options are found 🤖--dlopen— blindly loads a shared library 🙈--allowed-modifiers— comma separated list of allowed modifiers--remap-modifier— remaps a request modifier from one id to another--dump-options— dumps the full list of available options 🗒️--show-config— shows the current config reformatted as ini--binary-append-data— returns the content of a resource to stdout for appending to a uwsgi binary (fordata://usage)--print— simple print 🖨️--iprint— simple print (immediate version)--exit— forcesexit()of the instance--cflags— reports uWSGICFLAGS(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 options, bestie — you ate that whole list 💖 This page is from uwsgi_luajit version 2.0.31-2, dated February 2026, and it lives in section UWSGI_LUAJIT(1). Go forth and configure something iconic ✨🦋👑
📦 where this page comes from
- ubuntu resolute: uwsgi-plugin-luajit 2.0.31+2+0.0.8build6 · GPL-3.0-or-later
- ubuntu stonking: uwsgi-plugin-luajit 2.0.31+2+0.0.8build6 · GPL-3.0-or-later
- 💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms