UWSGI_GRAYLOG2(1)

📦

version 2.0.31 · 7 versions

💖 UWSGI_GRAYLOG2(1) 💖

okay bestie, welcome to uwsgi_graylog2 — it's a User Command, section 1 of the manual, and it's literally the whole uwsgi-core situation. no cap.

✨ NAME ✨

uwsgi_graylog2 — a fast (pure C), self-healing, developer-friendly WSGI server 🦋

like. she's fast, she's in C, she heals herself, and she's nice to developers. main character energy fr fr 💅

🌸 SYNOPSIS 🌸

uwsgi-core [options...]

that's it. that's the whole vibe. you just throw options at her and she goes 👑

🎀 DESCRIPTION 🎀

okay so this is the big one — a whole buffet of options. every single one matters, so i'm giving you all of them, no skipping, periodt. 💖

-s, --socket — bind to the specified UNIX/TCP socket using default protocol 🫶
-s, --uwsgi-socket — bind to the specified UNIX/TCP socket using uwsgi protocol
--suwsgi-socket — bind to the specified UNIX/TCP socket using uwsgi protocol over SSL 🔒
--ssl-socket — bind to the specified UNIX/TCP socket using uwsgi protocol over SSL
--http-socket — bind to the specified UNIX/TCP socket using HTTP protocol
--http-socket-modifier1 — force the specified modifier1 when using HTTP protocol
--http-socket-modifier2 — force the specified modifier2 when using HTTP protocol
--http11-socket — bind to the specified UNIX/TCP socket using HTTP 1.1 (Keep-Alive) protocol ✨
--https-socket — bind to the specified UNIX/TCP socket using HTTPS protocol
--https-socket-modifier1 — force the specified modifier1 when using HTTPS protocol
--https-socket-modifier2 — force the specified modifier2 when using HTTPS protocol
--fastcgi-socket — bind to the specified UNIX/TCP socket using FastCGI protocol
--fastcgi-nph-socket — bind to the specified UNIX/TCP socket using FastCGI protocol (nph mode)
--fastcgi-modifier1 — force the specified modifier1 when using FastCGI protocol
--fastcgi-modifier2 — force the specified modifier2 when using FastCGI protocol
--scgi-socket — bind to the specified UNIX/TCP socket using SCGI protocol
--scgi-nph-socket — bind to the specified UNIX/TCP socket using SCGI protocol (nph mode)
--scgi-modifier1 — force the specified modifier1 when using SCGI protocol
--scgi-modifier2 — force the specified modifier2 when using SCGI protocol
--raw-socket — bind to the specified UNIX/TCP socket using RAW protocol
--raw-modifier1 — force the specified modifier1 when using RAW protocol
--raw-modifier2 — force the specified modifier2 when using RAW protocol
--puwsgi-socket — bind to the specified UNIX/TCP socket using persistent uwsgi protocol (puwsgi)
--protocol — force the specified protocol for default sockets
--socket-protocol — force the specified protocol for default sockets
--shared-socket — create a shared socket for advanced jailing or ipc 🔥
--undeferred-shared-socket — create a shared socket for advanced jailing or ipc (undeferred mode)
-p, --processes — spawn the specified number of workers/processes
-p, --workers — spawn the specified number of workers/processes
--thunder-lock — serialize accept() usage (if possible) ⚡
-t, --harakiri — set harakiri timeout
--harakiri-verbose — enable verbose mode for harakiri
--harakiri-graceful-timeout — interval between graceful harakiri attempt and a sigkill
--harakiri-graceful-signal — use this signal instead of sigterm for graceful harakiri attempts
--harakiri-queue-threshold — only trigger harakiri if queue is greater than this threshold
--harakiri-no-arh — do not enable harakiri during after-request-hook
--no-harakiri-arh — do not enable harakiri during after-request-hook
--no-harakiri-after-req-hook — do not enable harakiri during after-request-hook
--backtrace-depth — set backtrace depth
--mule-harakiri — set harakiri timeout for mule tasks
-x, --xmlconfig — load config from xml file
-x, --xml — load config from xml file
--config — load configuration using the pluggable system 🧩
--fallback-config — re-exec uwsgi with the specified config when exit code is 1
--strict — enable strict mode (placeholder cannot be used)
--skip-zero — skip check of file descriptor 0
--skip-atexit — skip atexit hooks (ignored by the master)
--skip-atexit-teardown — skip atexit teardown (ignored by the master)
-S, --set — set a placeholder or an option
--set-placeholder — set a placeholder
--set-ph — set a placeholder
--get — print the specified option value and exit
--declare-option — declare a new uWSGI custom option
--declare-option2 — declare a new uWSGI custom option (non-immediate)
--resolve — place the result of a dns query in the specified placeholder, sytax: placeholder=name (immediate option)
--for — (opt logic) for cycle
--for-glob — (opt logic) for cycle (expand glob)
--for-times — (opt logic) for cycle (expand the specified num to a list starting from 1)
--for-readline — (opt logic) for cycle (expand the specified file to a list of lines)
--endfor — (opt logic) end for cycle
--end-for — (opt logic) end for cycle
--if-opt — (opt logic) check for option
--if-not-opt — (opt logic) check for option
--if-env — (opt logic) check for environment variable
--if-not-env — (opt logic) check for environment variable
--ifenv — (opt logic) check for environment variable
--if-reload — (opt logic) check for reload
--if-not-reload — (opt logic) check for reload
--if-hostname — (opt logic) check for hostname
--if-not-hostname — (opt logic) check for hostname
--if-hostname-match — (opt logic) try to match hostname against a regular expression
--if-not-hostname-match — (opt logic) try to match hostname against a regular expression
--if-exists — (opt logic) check for file/directory existence
--if-not-exists — (opt logic) check for file/directory existence
--ifexists — (opt logic) check for file/directory existence
--if-plugin — (opt logic) check for plugin
--if-not-plugin — (opt logic) check for plugin
--ifplugin — (opt logic) check for plugin
--if-file — (opt logic) check for file existence
--if-not-file — (opt logic) check for file existence
--if-dir — (opt logic) check for directory existence
--if-not-dir — (opt logic) check for directory existence
--ifdir — (opt logic) check for directory existence
--if-directory — (opt logic) check for directory existence
--endif — (opt logic) end if
--end-if — (opt logic) end if
--blacklist — set options blacklist context
--end-blacklist — clear options blacklist context
--whitelist — set options whitelist context
--end-whitelist — clear options whitelist context
--ignore-sigpipe — do not report (annoying) SIGPIPE 🙈
--ignore-write-errors — do not report (annoying) write()/writev() errors
--write-errors-tolerance — set the maximum number of allowed write errors (default: no tolerance)
--write-errors-exception-only — only raise an exception on write errors giving control to the app itself
--disable-write-exception — disable exception generation on write()/writev()
--inherit — use the specified file as config template
--include — include the specified file as immediate configuration
--inject-before — inject a text file before the config file (advanced templating)
--inject-after — inject a text file after the config file (advanced templating)
-d, --daemonize — daemonize uWSGI 👻
--daemonize2 — daemonize uWSGI after app loading
--stop — stop an instance
--reload — reload an instance
--pause — pause an instance
--suspend — suspend an instance
--resume — resume an instance
--connect-and-read — connect to a socket and wait for data from it
--extract — fetch/dump any supported address to stdout
-l, --listen — set the socket listen queue size
-v, --max-vars — set the amount of internal iovec/vars structures
--max-apps — set the maximum number of per-worker applications
-b, --buffer-size — set internal buffer size
-m, --memory-report — enable memory report
--profiler — enable the specified profiler
-c, --cgi-mode — force CGI-mode for plugins supporting it
-a, --abstract-socket — force UNIX socket in abstract mode (Linux only) 🐧
-C, --chmod-socket — chmod-socket
-C, --chmod — chmod-socket
--chown-socket — chown unix sockets
--umask — set umask
--freebind — put socket in freebind mode
--map-socket — map sockets to specific workers
-T, --enable-threads — enable threads (stub option this is true by default)
--no-threads-wait — do not wait for threads cancellation on quit/reload
--auto-procname — automatically set processes name to something meaningful
--procname-prefix — add a prefix to the process names
--procname-prefix-spaced — add a spaced prefix to the process names
--procname-append — append a string to process names
--procname — set process names
--procname-master — set master process name
-i, --single-interpreter — do not use multiple interpreters (where available)
--need-app — exit if no app can be loaded
-M, --master — enable master process 👑
--honour-stdin — do not remap stdin to /dev/null
--emperor — run the Emperor
--emperor-proxy-socket — force the vassal to became an Emperor proxy
--emperor-wrapper — set a binary wrapper for vassals
--emperor-wrapper-override — set a binary wrapper for vassals to try before the default one
--emperor-wrapper-fallback — set a binary wrapper for vassals to try as a last resort
--emperor-nofollow — do not follow symlinks when checking for mtime
--emperor-procname — set the Emperor process name
--emperor-freq — set the Emperor scan frequency (default 3 seconds) ⏰
--emperor-required-heartbeat — set the Emperor tolerance about heartbeats 💓
--emperor-curse-tolerance — set the Emperor tolerance about cursed vassals

bestie that's part 1 and there's so much more coming, don't go anywhere 💜

okay so we're still in flag city, and honestly? it's giving ✨power user✨ — every one of these is a real knob you can turn. no skips, no summarising, we go through ALL of them 💖

--emperor-pidfile — drops the Emperor's pid into the file you name. your emperor, pinned down in writing 👑
--emperor-tyrant — puts the Emperor into Tyrant mode. dramatic name, dramatic energy, that's the vibe
--emperor-tyrant-nofollow — when it's checking for uid/gid in Tyrant mode, it will not follow symlinks. no sneaky link-hopping, bestie 🙈
--emperor-stats — spins up the Emperor stats server
--emperor-stats-server — same thing, spins up the Emperor stats server
--early-emperor — spawns the emperor as soon as possible. impatient queen, we respect it 💅
--emperor-broodlord — runs the emperor in BroodLord mode
--emperor-throttle — sets the throttling level, in milliseconds, for vassals that are being badly behaved. default is 1000 😤
--emperor-max-throttle — sets the max throttling level, in milliseconds, for badly behaved vassals. default is 3 minutes
--emperor-magic-exec — if a vassal's config file has the executable bit set, it prefixes that config file with exec://. magic, literally ✨
--emperor-on-demand-extension — looks for a text file named vassal name + extension that contains the on demand socket name
--emperor-on-demand-ext — same deal: looks for a text file named vassal name + extension that contains the on demand socket name
--emperor-on-demand-directory — turns on on demand mode, binding to the unix socket inside the directory you specify, named like the vassal plus .socket
--emperor-on-demand-dir — yep, same: enables on demand mode, binds to the unix socket in the specified directory, named like the vassal plus .socket
--emperor-on-demand-exec — uses the output of the command you specify as the on demand socket name, and the vassal name gets passed in as the one and only argument
--emperor-extra-extension — allows the extension you specify in the Emperor, and the vassal gets called with --config
--emperor-extra-ext — allows the specified extension in the Emperor, vassal called with --config
--emperor-no-blacklist — disables the Emperor blacklisting subsystem. no more blacklist, gone, deleted 🚫
--emperor-use-clone — uses clone() instead of fork(), passing along the unshare() flags you specify
--emperor-graceful-shutdown — uses vassals' graceful shutdown during ragnarok 😭
--emperor-cap — sets the vassals' capability
--vassals-cap — sets the vassals' capability
--vassal-cap — sets the vassals' capability
--imperial-monitor-list — lists the enabled imperial monitors
--imperial-monitors-list — lists the enabled imperial monitors
--vassals-inherit — adds config templates to vassals' config, and it uses --inherit to do it
--vassals-include — includes config templates into vassals' config, using --include instead of --inherit
--vassals-inherit-before — adds config templates to vassals' config via --inherit, and it parses before the vassal file
--vassals-include-before — includes config templates into vassals' config via --include instead of --inherit, parsing before the vassal file
--vassals-start-hook — runs the command you specify before each vassal starts
--vassals-stop-hook — runs the specified command after a vassal dies 💀
--vassal-sos — asks the emperor for reinforcements when it's overloaded
--vassal-sos-backlog — asks the emperor for sos if the backlog queue has more items than the value you specify
--vassals-set — automatically sets the option you specify (via --set) for every single vassal
--vassal-set — same energy: automatically sets the specified option (via --set) for every vassal
--heartbeat — announces healthiness to the emperor. "i'm alive bestie!!" 🫶
--reload-mercy — the maximum time, in seconds, we wait for workers and other processes to die during reload/shutdown
--worker-reload-mercy — the maximum time, in seconds, a worker is allowed to take to reload/shutdown. default is 60
--mule-reload-mercy — the maximum time, in seconds, a mule is allowed to take to reload/shutdown. default is 60
--exit-on-reload — forces an exit even if a reload was requested
--die-on-term — exits instead of doing a brutal reload on SIGTERM
--force-gateway — forces the spawn of the first registered gateway, with no master involved
-h, --help — shows this help
-h, --usage — shows this help
--print-sym — prints the content of the binary symbol you specify
--print-symbol — prints the content of the specified binary symbol
-r, --reaper — calls waitpid(-1,...) after every request so zombies get cleaned up 🧟
-R, --max-requests — reloads workers after the specified amount of managed requests
--max-requests-delta — adds (worker_id * delta) to the max_requests value of each worker
--min-worker-lifetime — the number of seconds a worker must run before it can be reloaded. default is 10
--max-worker-lifetime — reloads workers after the specified amount of seconds. default is disabled
--max-worker-lifetime-delta — adds (worker_id * delta) seconds to the max_worker_lifetime value of each worker
-z, --socket-timeout — sets the internal sockets timeout
--no-fd-passing — disables file descriptor passing
--locks — creates the specified number of shared locks
--lock-engine — sets the lock engine
--ftok — sets the ipcsem key via ftok() so you dodge duplicates
--persistent-ipcsem — does 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 — does not close the file descriptor you specify
--fd-safe — does not close the specified file descriptor
--cache — creates a shared cache containing the given elements
--cache-blocksize — sets the cache blocksize
--cache-store — enables persistent cache to disk
--cache-store-sync — sets the frequency of sync for the persistent cache
--cache-no-expire — disables the auto sweep of expired items
--cache-expire-freq — sets how often the cache sweeper scans. default is 3 seconds
--cache-report-freed-items — constantly reports the cache item freed by the sweeper. use only for debug ⚠️
--cache-udp-server — binds the cache udp server (only used for set/update/delete) to the socket you specify
--cache-udp-node — sends cache update/deletion to the cache udp server you specify
--cache-sync — copies the whole content of another uWSGI cache server at server startup
--cache-use-last-modified — updates the last_modified_at timestamp on every cache item modification. default is disabled
--add-cache-item — adds an item into the cache
--load-file-in-cache — loads a static file into the cache
--load-file-in-cache-gzip — loads a static file into the cache, with gzip compression
--cache2 — creates a new generation shared cache, using keyval syntax
--queue — enables the shared queue
--queue-blocksize — sets the queue blocksize
--queue-store — enables persistent queue to disk
--queue-store-sync — sets the frequency of sync for the persistent queue
-Q, --spooler — runs a spooler on the directory you specify
--spooler-external — maps spooler requests to a spooler directory managed by an external instance
--spooler-ordered — tries to order the execution of spooler tasks
--spooler-chdir — does a chdir() into the specified directory before each spooler task
--spooler-processes — sets the number of processes for spoolers
--spooler-quiet — does not be verbose with spooler tasks 🤫
--spooler-max-tasks — sets the maximum number of tasks to run before recycling a spooler
--spooler-harakiri — sets the harakiri timeout for spooler tasks
--spooler-frequency — sets the spooler frequency
--spooler-freq — sets the spooler frequency
--mule — adds a mule
--mules — adds the specified number of mules
--farm — adds a mule farm 🌾
--mule-msg-size — sets the mule message buffer size
--signal — sends a uwsgi signal to a server
--signal-bufsize — sets the buffer size for the signal queue
--signals-bufsize — sets the buffer size for the signal queue
--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 you specify before starting, and exits if it's already locked
--flock-wait — locks the specified file before starting, and waits if it's already locked
--flock2 — locks the specified file after logging/daemon setup, exits if it's locked
--flock-wait2 — locks the specified file after logging/daemon setup, waits if it's locked
--pidfile — creates a pidfile, and this happens before the privileges drop
--pidfile2 — creates a pidfile, this time after the privileges drop
--safe-pidfile — creates a safe pidfile, before the privileges drop
--safe-pidfile2 — creates a safe pidfile, after the privileges drop
--chroot — chroot()s into the directory you specify
--pivot-root — pivot_root()s into the directories you specify. new_root and put_old must be separated with a space
--pivot_root — pivot_root()s into the specified directories. new_root and put_old must be separated with a space
--uid — setuids to the user/uid you specify
--gid — setgids to the group/gid you specify
--add-gid — adds the group id you specify to the process credentials
--immediate-uid — setuids to the user/uid you specify, IMMEDIATELY ⚡
--immediate-gid — setgids to the group/gid you specify, IMMEDIATELY ⚡
--no-initgroups — disables the additional groups that get set via initgroups()
--cap — sets the process capability
--unshare — unshare()s part of the processes and drops it into a new namespace
--unshare2 — unshare()s part of the processes and drops it into a new namespace, but after the rootfs change
--setns-socket — exposes a unix socket that returns namespace fds from /proc/self/ns
--setns-socket-skip — skips the entry you specify when sending setns file descriptors
--setns-skip — skips the specified entry when sending setns file descriptors
--setns — joins a namespace that was created by an external uWSGI instance
--setns-preopen — opens /proc/self/ns as soon as possible and caches the fds

still more flag lore coming bestie, don't you dare scroll away 🦋

--jailed — mark this instance as jailed, which forces the post_jail hooks to actually run. jail era 💅
--refork — do a fork() again after privileges drop. useful for jailing systems 🧚
--re-fork — same as --refork: fork() again after privileges drop. jailing systems stay fed 🫶
--refork-as-root — fork() again before privileges drop. useful for jailing systems ✨
--re-fork-as-root — yep, same: fork() again before privileges drop. jailing systems love this one 👑
--refork-post-jail — fork() again after jailing. useful for jailing systems 🔥
--re-fork-post-jail — twin energy: fork() again after jailing. useful for jailing systems 💖

--hook-asap — run the specified hook as soon as possible. no waiting bestie ⏳
--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. main character energy 👑
--hook-touch — run the specified hook when the specified file is touched (syntax: <file> <action>).
--hook-emperor-start — run the specified hook when the Emperor starts.
--hook-emperor-stop — run the specified hook when the Emperor sends a stop message.
--hook-emperor-reload — run the specified hook when the Emperor sends a reload message.
--hook-emperor-lost — run the specified hook when the Emperor connection is lost.
--hook-as-vassal — run the specified hook before exec()ing the vassal.
--hook-as-emperor — run the specified hook in the emperor after the vassal has been started.
--hook-as-mule — run the specified hook in each mule.
--hook-as-gateway — run the specified hook in each gateway.
--after-request-hook — run the specified function/symbol after each request.
--after-request-call — run the specified function/symbol after each request.

--exec-asap — run the specified command as soon as possible.
--exec-pre-jail — run the specified command before jailing.
--exec-post-jail — run the specified command after jailing.
--exec-in-jail — run the specified command in jail after initialization.
--exec-as-root — run the specified command before privileges drop.
--exec-as-user — run the specified command after privileges drop.
--exec-as-user-atexit — run the specified command before app exit and reload.
--exec-pre-app — run the specified command before app loading.
--exec-post-app — run the specified command after app loading.
--exec-as-vassal — run the specified command before exec()ing the vassal.
--exec-as-emperor — run the specified command in the emperor after the vassal has been started.

--mount-asap — mount filesystem as soon as possible.
--mount-pre-jail — mount filesystem before jailing.
--mount-post-jail — mount filesystem after jailing.
--mount-in-jail — mount filesystem in jail after initialization.
--mount-as-root — mount filesystem before privileges drop.
--mount-as-vassal — mount filesystem before exec()ing the vassal.
--mount-as-emperor — mount filesystem in the emperor after the vassal has been started.

--umount-asap — unmount filesystem as soon as possible.
--umount-pre-jail — unmount filesystem before jailing.
--umount-post-jail — unmount filesystem after jailing.
--umount-in-jail — unmount filesystem in jail after initialization.
--umount-as-root — unmount filesystem before privileges drop.
--umount-as-vassal — unmount filesystem before exec()ing the vassal.
--umount-as-emperor — unmount filesystem in the emperor after the vassal has been started.

--wait-for-interface — wait for the specified network interface to come up before running root hooks.
--wait-for-interface-timeout — set the timeout for wait-for-interface.
--wait-interface — wait for the specified network interface to come up before running root hooks.
--wait-interface-timeout — set the timeout for wait-for-interface.
--wait-for-iface — wait for the specified network interface to come up before running root hooks.
--wait-for-iface-timeout — set the timeout for wait-for-interface.
--wait-iface — wait for the specified network interface to come up before running root hooks.
--wait-iface-timeout — set the timeout for wait-for-interface.
--wait-for-fs — wait for the specified filesystem item to appear before running root hooks.
--wait-for-file — wait for the specified file to appear before running root hooks.
--wait-for-dir — wait for the specified directory to appear before running root hooks.
--wait-for-mountpoint — wait for the specified mountpoint to appear before running root hooks.
--wait-for-fs-timeout — set the timeout for wait-for-fs/file/dir.
--wait-for-socket — wait for the specified socket to be ready before loading apps.
--wait-for-socket-timeout — set the timeout for wait-for-socket.

--call-asap — call the specified function as soon as possible.
--call-pre-jail — call the specified function before jailing.
--call-post-jail — call the specified function after jailing.
--call-in-jail — call the specified function in jail after initialization.
--call-as-root — call the specified function before privileges drop.
--call-as-user — call the specified function after privileges drop.
--call-as-user-atexit — call the specified function before app exit and reload.
--call-pre-app — call the specified function before app loading.
--call-post-app — call the specified function after app loading.
--call-as-vassal — call the specified function() before exec()ing the vassal.
--call-as-vassal1 — call the specified function(char *) before exec()ing the vassal.
--call-as-vassal3 — call the specified function(char *, uid_t, gid_t) before exec()ing the vassal.
--call-as-emperor — call the specified function() in the emperor after the vassal has been started.
--call-as-emperor1 — call the specified function(char *) in the emperor after the vassal has been started.
--call-as-emperor2 — call the specified function(char *, pid_t) in the emperor after the vassal has been started.
--call-as-emperor4 — call the specified function(char *, pid_t, uid_t, gid_t) in the emperor after the vassal has been started.

--ini — load config from ini file.
-y|--yaml — load config from yaml file.
-y|--yml — load config from yaml file.
-j|--json — load config from json file.
-j|--js — load config from json file.

--weight — weight of the instance (used by clustering/lb/subscriptions).
--auto-weight — set weight of the instance (used by clustering/lb/subscriptions) automatically.
--no-server — force no-server mode.
--command-mode — force command mode.
--no-defer-accept — disable deferred-accept on sockets.
--tcp-nodelay — enable TCP NODELAY on each request.
--so-keepalive — enable TCP KEEPALIVEs.
--so-send-timeout — set SO_SNDTIMEO.
--socket-send-timeout — set SO_SNDTIMEO.
--so-write-timeout — set SO_SNDTIMEO.
--socket-write-timeout — set SO_SNDTIMEO.
--socket-sndbuf — set SO_SNDBUF.
--socket-rcvbuf — set SO_RCVBUF.
--shutdown-sockets — force calling shutdown() in addition to close() when sockets are destroyed.
--limit-as — limit processes address space/vsz.
--limit-nproc — limit the number of spawnable processes.
--reload-on-as — reload if address space is higher than specified megabytes.
--reload-on-rss — reload if rss memory is higher than specified megabytes.
--evil-reload-on-as — force the master to reload a worker if its address space is higher than specified megabytes.
--evil-reload-on-rss — force the master to reload a worker if its rss memory is higher than specified megabytes.
--mem-collector-freq — set the memory collector frequency when evil reloads are in place.
--reload-on-fd — reload if the specified file descriptor is ready.
--brutal-reload-on-fd — brutal reload if the specified file descriptor is ready.
--ksm — enable Linux KSM.
--pcre-jit — enable pcre jit (if available).
--never-swap — lock all memory pages avoiding swapping.
--touch-reload — reload uWSGI if the specified file is modified/touched.
--touch-workers-reload — trigger reload of (only) workers if the specified file is modified/touched.
--touch-mules-reload — reload mules if the specified file is modified/touched.
--touch-spoolers-reload — reload spoolers if the specified file is modified/touched.
--touch-chain-reload — trigger chain reload if the specified file is modified/touched.
--touch-logrotate — trigger logrotation if the specified file is modified/touched.
--touch-logreopen — trigger log reopen if the specified file is modified/touched.
--touch-exec — run command when the specified file is modified/touched (syntax: file command).
--touch-signal — the moment that file gets modified/touched, we send a signal. syntax: file signal 💫
--fs-reload — filesystem object changes? graceful reload, bestie. no drama, just vibes.
--fs-brutal-reload — same energy but make it brutal: the fs object changes and we hard reload. no soft launch here 🔥
--fs-signal — raise a uwsgi signal when the specified filesystem object is modified. syntax: file signal
--check-mountpoint — if a filesystem is no longer reachable, the instance gets destroyed. literally perfect for reliable Fuse management 💀
--mountpoint-check — same thing, different name: instance gets destroyed if a filesystem is no more reachable. useful for reliable Fuse management 🫶
--check-mount — you guessed it. filesystem unreachable → instance destroyed. reliable Fuse management stays winning ✨
--mount-check — the fourth twin 👯 filesystem gone → instance destroyed. useful for reliable Fuse management.
--propagate-touch — over-engineering option for systems with flaky signal management. it's giving "we tried everything" 😭
--limit-post — limit the request body. put a lil fence around it 🚧
--no-orphans — workers get auto-killed if the master dies. > ⚠️ fair warning: this can be dangerous for availability. protect the vibes responsibly.
--prio — set processes/threads priority ⭐
--cpu-affinity — set cpu affinity 🧚
--post-buffering — set the size in bytes after which stuff buffers to disk instead of memory.
--post-buffering-bufsize — set the buffer size for read() when you're in post buffering mode.
--body-read-warning — sets the amount of allowed memory allocation (in megabytes) for a request body before it starts printing a warning at you 👀
--upload-progress — creates .json files in the directory you name, while a file upload is happening 🍓
--no-default-app — no falling back to the default app. we don't do backup plans 💅
--manage-script-name — automatically rewrites SCRIPT_NAME and PATH_INFO for you. it's doing the most so you don't have to.
--ignore-script-name — straight up ignore SCRIPT_NAME. iconic.
--catch-exceptions — reports the exception as http output. > 🚨 discouraged, only use it for testing, fr fr.
--reload-on-exception — an exception gets raised → the worker reloads 🔄
--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 — turns the metrics subsystem on 📊
--metric — add a custom metric 🤏
--metric-threshold — add a metric threshold/alarm 🚨
--metric-alarm — add a metric threshold/alarm (yes, same thing, we love an alias)
--alarm-metric — add a metric threshold/alarm (third time's the charm ✨)
--metrics-dir — export metrics as text files into the directory you specify.
--metrics-dir-restore — restores the last value taken from the metrics dir.
--metric-dir — export metrics as text files to the specified directory 📁
--metric-dir-restore — restore last value taken from the metrics dir.
--metrics-no-cores — stops generating cores-related metrics. no cores, no problem.
--udp — run the udp server on the address you give it 📡
--stats — enable the stats server on the specified address 📈
--stats-server — enable the stats server on the specified address. same energy, different spelling.
--stats-http — prefixes the stats server json output with http headers.
--stats-minified — minifies the statistics json output. small and cute 🎀
--stats-min — minify statistics json output (the short king edition).
--stats-push — push the stats json to the destination you name 🚀
--stats-pusher-default-freq — set the default frequency of stats pushers.
--stats-pushers-default-freq — set the default frequency of stats pushers (plural gang 🌈)
--stats-no-cores — disable generation of cores-related stats.
--stats-no-metrics — keeps metrics out of the stats output entirely 🙈
--multicast — subscribe to the specified multicast group 📻
--multicast-ttl — set multicast ttl ⏳
--multicast-loop — set multicast loop (default 1) 🔁
--master-fifo — enable the master fifo 🎛️
--notify-socket — enable the notification socket 🔔
--subscription-notify-socket — set the notification socket used 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 — if one of the lord hooks fails, it declares itself a dead node for however many seconds you specify ☠️
--legion-skew-tolerance — set the clock skew tolerance of the legion subsystem (default 60 seconds) ⏰
--legion-lord — the action to call on Lord election 👑
--legion-unlord — the action to call on Lord dismiss.
--legion-setup — the action to call on legion setup 🛠️
--legion-death — action to call on legion death (that's the shutdown of the instance) 💀
--legion-join — action to call on legion join (the first time quorum is reached) 🎉
--legion-node-joined — action to call when a new node joins the legion 🫶
--legion-node-left — action to call when a node leaves the legion 👋
--legion-quorum — set the quorum of a legion 🗳️
--legion-scroll — set the scroll of a legion 📜
--legion-scroll-max-size — set max size of the legion scroll buffer.
--legion-scroll-list-max-size — set max size of the 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 — skips the signature check for the specified uid when unix sockets credentials are in play 🙈
--subscriptions-credentials-check — add a directory to search for subscriptions key credentials.
--subscriptions-use-credentials — enable management of SCM_CREDENTIALS in subscriptions UNIX sockets.
--subscription-algo — set the load balancing algorithm for the subscription system ⚖️
--subscription-dotsplit — tries to fall back 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 (tiny name, big job).
--subscribe — subscribe to the specified subscription server.
--subscribe2 — subscribe to the specified subscription server using the advanced keyval syntax ✨
--subscribe-freq — send the subscription announce at the interval you specify.
--subscription-tolerance — set tolerance for subscription servers.
--unsubscribe-on-graceful-reload — forces the unsubscribe request even during a graceful reload. no ghost subs 👻
--start-unsubscribed — configure subscriptions but don't send them (super useful with master fifo).
--subscribe-with-modifier1 — force the specified modifier1 when subscribing.
--snmp — enable the embedded snmp server 🧭
--snmp-community — set the snmp community string 🔑
--ssl-verbose — be verbose about SSL errors. spill the tea 🍵
--ssl-verify-depth — set the maximum certificate verification depth.
--sni — add an SNI-governed SSL context 🦋
--sni-dir — check for cert/key/client_ca files in the directory you specify and create a sni/ssl context on demand.
--sni-dir-ciphers — set the ssl ciphers for the sni-dir option 🔒
--ssl-enable3 — enable SSLv3. > ⚠️ insecure, bestie. just so we're clear.
--ssl-enable-sslv3 — enable SSLv3. > ⚠️ also insecure.
--ssl-enable-tlsv1 — enable TLSv1. > ⚠️ insecure too 🙈
--ssl-option — set a raw ssl option (a numeric value, no vibes, just numbers).
--sni-regexp — add an SNI-governed SSL context where the key is a regexp 🧠
--ssl-tmp-dir — store ssl-related temp files in the directory you specify.
--check-interval — set the interval (in seconds) of master checks ⏱️
--forkbomb-delay — sleep for the specified number of seconds when a forkbomb is detected 💣😴
--binary-path — force the 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 number of cores you specify ⚡
--max-fd — set the maximum number of file descriptors. > 🔑 requires root privileges.
--logto — set the logfile/udp address 📝
--logto2 — log to the specified file or udp address after privileges drop.
--log-format — set an advanced format for request logging 🎨
--logformat — set advanced format for request logging (the no-dash remix).
--logformat-strftime — apply strftime to the logformat output 📅
--log-format-strftime — apply strftime to logformat output (dashed flavour).
--logfile-chown — chown those logfiles 👑
--logfile-chmod — chmod those 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 (same thing, backwards name, still iconic).
--logger — set/append a logger 🪵
--logger-list — list enabled loggers 🗒️
--loggers-list — list enabled loggers (plural edition).
--threaded-logger — offloads log writing to a thread 🧵
--log-encoder — add an item in the log encoder chain ⛓️
--log-req-encoder — add an item in the log req encoder chain.
--log-drain — drain (do not show) log lines matching the specified regexp 🕳️
--log-filter — show only the 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 — calls abort() 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 spinning up dedicated threads for curl-based alarms 💸✂️
--alarm-freq — tune the anti-loop alarm system (default 3 seconds) ⏰
--alarm-fd — raise the specified alarm when an fd is read for read (by default it reads 1 byte, set 8 for eventfd) 🚨
--alarm-segfault, --segfault-alarm — raise the specified alarm when the segmentation fault handler is executed 💀
--alarm-backlog, --backlog-alarm, --lq-alarm, --alarm-lq, --alarm-listen-queue, --listen-queue-alarm — all six of these bad boys raise the specified alarm when the socket backlog queue is full 😭 (the whole gang, one job)
--log-alarm, --alarm-log — raise the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp> 🚨📝
--not-log-alarm, --not-alarm-log — skip the specified alarm when a log line matches the specified regexp, syntax: <alarm>[,alarm...] <regexp> 🙈
--alarm-list, --alarms-list — list enabled alarms ✨
--alarm-msg-size — set the max size of an alarm message (default 8192) 📏

--log-master — delegate logging to master process 👑
--log-master-bufsize — set the buffer size for the master logger. bigger log messages will be truncated ✂️
--log-master-stream — create the master logpipe as SOCK_STREAM 🌊
--log-master-req-stream — create the master requests logpipe as SOCK_STREAM 🌊
--log-reopen — reopen log after reload 🔄
--log-truncate — truncate log on startup 🗑️
--log-maxsize — set maximum logfile size 📦
--log-backupname — set logfile name after rotation 🌀
--logdate, --log-date — prefix logs with date or a strftime string 📅
--log-prefix — prefix logs with a string 🏷️
--log-zero — log responses without body 🫥
--log-slow — log requests slower than the specified number of milliseconds 🐌
--log-4xx — log requests with a 4xx response 😬
--log-5xx — log requests with a 5xx response 💀
--log-big — log requests bigger than the specified size 🐘
--log-sendfile — log sendfile requests 📤
--log-ioerror — log requests with io errors 🩹
--log-micros — report response time in microseconds instead of milliseconds ⏱️
--log-x-forwarded-for — use the ip from X-Forwarded-For header instead of REMOTE_ADDR 🕵️

--master-as-root — leave master process running as root 👑
--drop-after-init — run privileges drop after plugin initialization, superseded by drop-after-apps ⬇️
--drop-after-apps — run privileges drop after apps loading, superseded by master-as-root ⬇️
--force-cwd — force the initial working directory to the specified value 📁
--binsh — override /bin/sh (used by exec hooks, it always fallback to /bin/sh) 🐚
--chdir — chdir to specified directory before apps loading 📂
--chdir2 — chdir to specified directory after apps loading 📂
--lazy — set lazy mode (load apps in workers instead of master) 😴
--lazy-apps — load apps in each worker instead of the master 😴
--cheap — set cheap mode (spawn workers only after the first request) 🪙
--cheaper — set cheaper mode (adaptive process spawning) 🧠
--cheaper-initial — set the initial number of processes to spawn in cheaper mode 🔢
--cheaper-algo — choose to algorithm used for adaptive process spawning 🧮
--cheaper-step — number of additional processes to spawn at each overload 🪜
--cheaper-overload — increase workers after specified overload 📈
--cheaper-algo-list, --cheaper-algos-list, --cheaper-list — list enabled cheapers algorithms 📜
--cheaper-rss-limit-soft — don't spawn new workers if total resident memory usage of all workers is higher than this limit 🛑
--cheaper-rss-limit-hard — if total workers resident memory usage is higher try to stop workers 🛑💀
--idle — set idle mode (put uWSGI in cheap mode after inactivity) 💤
--die-on-idle — shutdown uWSGI when idle ⚰️
--mount — load application under mountpoint 🪝
--worker-mount — load application under mountpoint in the specified worker or after workers spawn 🪝
--threads — run each worker in prethreaded mode with the specified number of threads 🧵
--thread-stacksize, --threads-stacksize, --thread-stack-size, --threads-stack-size — set threads stacksize (four names, one vibe) 🧵📏
--vhost — enable virtualhosting mode (based on SERVER_NAME variable) 🏠
--vhost-host — enable virtualhosting mode (based on HTTP_HOST variable) 🏠

routing time bestie, this is where it gets good 🛣️✨

--route — add a route
--route-host — add a route based on Host header
--route-uri — add a route based on REQUEST_URI
--route-qs — add a route based on QUERY_STRING
--route-remote-addr — add a route based on REMOTE_ADDR
--route-user-agent — add a route based on HTTP_USER_AGENT
--route-remote-user — add a route based on REMOTE_USER
--route-referer — add a route based on HTTP_REFERER
--route-label — add a routing label (for use with goto) 🏷️
--route-if — add a route based on condition
--route-if-not — add a route based on condition (negate version) 🙃
--route-run — always run the specified route action

--final-route — add a final route 🏁
--final-route-status — add a final route for the specified status
--final-route-host — add a final route based on Host header
--final-route-uri — add a final route based on REQUEST_URI
--final-route-qs — add a final route based on QUERY_STRING
--final-route-remote-addr — add a final route based on REMOTE_ADDR
--final-route-user-agent — add a final route based on HTTP_USER_AGENT
--final-route-remote-user — add a final route based on REMOTE_USER
--final-route-referer — add a final route based on HTTP_REFERER
--final-route-label — add a final routing label (for use with goto) 🏷️
--final-route-if — add a final route based on condition
--final-route-if-not — add a final route based on condition (negate version) 🙃
--final-route-run — always run the specified final route action

--error-route — add an error route 💔
--error-route-status — add an error route for the specified status
--error-route-host — add an error route based on Host header
--error-route-uri — add an error route based on REQUEST_URI
--error-route-qs — add an error route based on QUERY_STRING
--error-route-remote-addr — add an error route based on REMOTE_ADDR
--error-route-user-agent — add an error route based on HTTP_USER_AGENT
--error-route-remote-user — add an error route based on REMOTE_USER
--error-route-referer — add an error route based on HTTP_REFERER
--error-route-label — add an error routing label (for use with goto) 🏷️
--error-route-if — add an error route based on condition
--error-route-if-not — add an error route based on condition (negate version) 🙃
--error-route-run — always run the specified error route action

--response-route — add a response route 📬
--response-route-status — add a response route for the specified status
--response-route-host — add a response route based on Host header
--response-route-uri — add a response route based on REQUEST_URI
--response-route-qs — add a response route based on QUERY_STRING
--response-route-remote-addr — add a response route based on REMOTE_ADDR
--response-route-user-agent — add a response route based on HTTP_USER_AGENT
--response-route-remote-user — add a response route based on REMOTE_USER
--response-route-referer — add a response route based on HTTP_REFERER
--response-route-label — add a response routing label (for use with goto) 🏷️
--response-route-if — add a response route based on condition
--response-route-if-not — add a response route based on condition (negate version) 🙃
--response-route-run — always run the specified response route action

--router-list, --routers-list — list enabled routers 📋
--error-page-403 — add an error page (html) for managed 403 response 🚫
--error-page-404 — add an error page (html) for managed 404 response 🔍
--error-page-500 — add an error page (html) for managed 500 response 💥

--websockets-ping-freq, --websocket-ping-freq — set the frequency (in seconds) of websockets automatic ping packets 🏓
--websockets-pong-tolerance, --websocket-pong-tolerance — set the tolerance (in seconds) of websockets ping/pong subsystem 🏓
--websockets-max-size, --websocket-max-size — set the max allowed size of websocket messages (in Kbytes, default 1024) 📦
--chunked-input-limit — set the max size of a chunked input part (default 1MB, in bytes) 📏
--chunked-input-timeout — set default timeout for chunked input ⏳

--clock — set a clock source 🕰️
--clock-list — list enabled clocks 🕰️📋
--clocks-list — lists all the enabled clocks ⏰ bonding time with your timers, bestie
--add-header — automatically adds HTTP headers to your response, so you don't have to hand-write them like it's 2009 💅
--rem-header — automatically removes the specified HTTP header from the response 🙈 poof, gone
--del-header — automatically removes the specified HTTP header from the response, same energy as the above, just a different name 🫶
--collect-header — stashes the specified response header into a request var (syntax: header var) 💖 grabbing receipts, but for headers
--response-header-collect — stashes the specified response header into a request var (syntax: header var) 💖 same thing, twin names fr fr
--pull-header — stashes the specified response header into a request var and yanks it out of the response (syntax: header var) — stealing it for yourself and removing the evidence 💀
--check-static — checks for static files in the specified directory 📁
--check-static-docroot — checks for static files in the requested DOCUMENT_ROOT 🏠 lowkey the vibe of "just look where it's supposed to be"
--static-check — checks for static files in the specified directory ✨ (yes babe, same deal as --check-static)
--static-map — maps a mountpoint to a static directory (or file) 🗺️ the classic
--static-map2 — like --static-map but it completely appends the requested resource to the docroot 🌸 no cap, slightly different behavior
--static-skip-ext — skips the specified extension from static file checks 🚫📄
--static-index — searches for the specified file if a directory is requested 🔍 so like, index.html behavior but you pick the file
--static-safe — skips security checks if the file is under the specified path 😭 iconic but be careful babes
--static-cache-paths — puts resolved paths in the uWSGI cache for the specified amount of seconds 🧠 a little memory moment
--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) 📜 (yes, the same one, it's giving two spellings for the price of one)
--static-expires-type — sets the Expires header based on content type ⏳
--static-expires-type-mtime — sets the Expires header based on content type and file mtime ⏳📅
--static-expires — sets the Expires header based on a filename regexp 🔎
--static-expires-mtime — sets the Expires header based on a filename regexp and file mtime 🔎📅
--static-expires-uri — sets the Expires header based on a REQUEST_URI regexp 🔎🌐
--static-expires-uri-mtime — sets the Expires header based on a REQUEST_URI regexp and file mtime 🔎🌐📅
--static-expires-path-info — sets the Expires header based on a PATH_INFO regexp 🔎🛣️
--static-expires-path-info-mtime — sets the Expires header based on a PATH_INFO regexp and file mtime 🔎🛣️📅
--static-gzip — if the supplied regexp matches the static file translation, it goes looking for a gzip version 🗜️✨
--static-gzip-all — checks for a gzip version of all requested static files 🗜️🔥
--static-gzip-dir — checks for a gzip version of all requested static files in the specified dir/prefix 📂🗜️
--static-gzip-prefix — checks for a gzip version of all requested static files in the specified dir/prefix 📂🗜️ (yep, same as --static-gzip-dir)
--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 🗜️🏷️ (twin of --static-gzip-ext, obviously)
--honour-range — enables support for the HTTP Range header 📏 serving partial file energy
--offload-threads — sets the number of offload threads to spawn (per-worker, default 0) 🧵
--offload-thread — sets the number of offload threads to spawn (per-worker, default 0) 🧵 same one, singular spelling era
--file-serve-mode — sets the static file serving mode 🍽️
--fileserve-mode — sets the static file serving mode 🍽️ (again, same option, two names, we love an alias moment)
--disable-sendfile — disables sendfile() and relies on boring read()/write() 🥱 sometimes the old ways hit different
--check-cache — checks for response data in the specified cache (leave it empty for the default cache) 📦💖
--close-on-exec — sets close-on-exec on connection sockets (could be required for spawning processes in requests) 🔒
--close-on-exec2 — sets close-on-exec on server sockets (could be required for spawning processes in requests) 🔐 note it's server sockets this time babe
--mode — sets uWSGI custom mode 🎛️ main character mode selection
--env — sets an environment variable 🌍
--envdir — loads a daemontools compatible envdir 📂🌍
--early-envdir — loads a daemontools compatible envdir ASAP ⚡🌍 like immediately immediately
--unenv — unsets an environment variable 🙅‍♀️🌍
--vacuum — tries to remove all of the generated file/sockets 🧹 clean girl behavior
--file-write — writes the specified content to the specified file (syntax: file=value) before privileges drop ✍️
--cgroup — puts the processes in the specified cgroup 🫂
--cgroup-opt — sets a value in the specified cgroup option ⚙️
--cgroup-dir-mode — sets permission for the cgroup directory (default is 700) 🔐
--namespace — runs in a new namespace under the specified rootfs 🌀
--namespace-keep-mount — keeps the specified mountpoint in your namespace 📌
--ns — runs in a new namespace under the specified rootfs 🌀 (same vibe as --namespace, shorter name slay)
--namespace-net — adds a network namespace 🌐
--ns-net — adds a network namespace 🌐 (yes babes, another alias)
--enable-proxy-protocol — enables PROXY1 protocol support (only for http parsers) 🎭
--reuse-port — enables the REUSE_PORT flag on the socket (BSD only) 🔁🍎
--tcp-fast-open — enables the TCP_FASTOPEN flag on TCP sockets with the specified qlen value 🚀
--tcp-fastopen — enables the TCP_FASTOPEN flag on TCP sockets with the specified qlen value 🚀 (spelling twin, no hyphen needed bestie)
--tcp-fast-open-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported 📞➡️🚀
--tcp-fastopen-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported 📞➡️🚀 (same one, we're just collecting pokémon at this point)
--zerg — attaches to a zerg server 🐛 iconic name, no notes
--zerg-fallback — falls back to normal sockets if the zerg server isn't available 🐛➡️🔌
--zerg-server — enables the zerg server on the specified UNIX socket 🐛🔌
--cron — adds a cron task ⏰
--cron2 — adds a cron task (key=val syntax) ⏰🔑
--unique-cron — adds a unique cron task ⏰✨ one of a kind
--cron-harakiri — sets the maximum time (in seconds) we wait for a cron command to complete ⏳💀 it's giving patience limits
--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 👑⏰ (same thing, swapped word order, we love versatility)
--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 ⏰✨👑 (yes, another reorder, embrace it)
--loop — selects the uWSGI loop engine 🔄
--loop-list — lists the enabled loop engines 📋🔄
--loops-list — lists the enabled loop engines 📋🔄 (plural era, same list)
--worker-exec — runs the specified command as worker 🏃‍♀️
--worker-exec2 — runs the specified command as worker (after the post_fork hook) 🏃‍♀️✨
--attach-daemon — attaches a command/daemon to the master process (the command has to not go in the background) 🧲
--attach-control-daemon — attaches a command/daemon to the master process (the command has to not go in the 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-daemon but the daemon runs only on the legion lord node 👑🧲
--legion-smart-attach-daemon — same as --smart-attach-daemon but the daemon runs only on the legion lord node 👑🧠🧲
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2 but the daemon runs only on the legion lord node 👑🧠🧲
--daemons-honour-stdin — does not change the stdin of external daemons to /dev/null 🫶 keep the stdin babes
--attach-daemon2 — the attach-daemon keyval variant (it supports smart modes too) 🧲🔑
--plugins — loads uWSGI plugins 🧩
--plugin — loads uWSGI plugins 🧩 (just the singular flavor)
--need-plugins — loads uWSGI plugins, and exits on error 🧩🚪
--need-plugin — loads uWSGI plugins, and exits on error 🧩🚪 (same, singular)
--plugins-dir — adds a directory to the uWSGI plugin search path 📂🧩
--plugin-dir — adds a directory to the uWSGI plugin search path 📂🧩 (twin alert)
--plugins-list — lists the enabled plugins 📋🧩
--plugin-list — lists the enabled plugins 📋🧩 (yes babe, plural/singular again, we're used to it now)
--autoload — tries to automatically load plugins when unknown options are found 🪄🧩
--dlopen — blindly loads a shared library 🙈📚 icu, no thoughts, just vibes
--allowed-modifiers — a comma separated list of allowed modifiers 📝
--remap-modifier — remaps a request modifier from one id to another 🔀
--dump-options — dumps the full list of available options 📜💥
--show-config — shows the current config reformatted as ini 📄✨
--binary-append-data — returns the content of a resource to stdout, for appending to a uwsgi binary (for data:// usage) 📤
--print — simple print 🖨️
--iprint — simple print (immediate version) 🖨️⚡
--exit — forces exit() of the instance 🚪💀 bye bestie
--cflags — reports uWSGI CFLAGS (useful for building external plugins) 🛠️
--dot-h — dumps the uwsgi.h used for building the core (useful for building external plugins) 📄🛠️
--config-py — dumps the uwsgiconfig.py used for building the core (useful for building external plugins) 📄🐍🛠️
--build-plugin — builds a uWSGI plugin for the current binary 🔨🧩
--version — prints the uWSGI version 🔢
--response-headers-limit — sets the response header maximum size (default: 64k) 📏

and that's a wrap on the whole options saga, bestie, we really read all of them 💖✨

this page came straight out of the uwsgi_graylog2 manual, version 2.0.31-debian, dated July 2026 — so if you're reading this in some other era, double-check that build babes 🌸🦋 and go forth and configure, you absolute icon 👑💅

📦 where this page comes from

ubuntu stonking: uwsgi-plugin-graylog2 2.0.31-6build1 · GPL-2.0-only
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-11-02: a language model's rewrite of the original, under its terms