UWSGI_GCCGO(1)

📦

version 2.0.31+2+0.0.3build2 · 6 versions

2.0.31+2+0.0.3build2 · ubuntu resolute, ubuntu stonking (latest)
2.0.29+1build1+0.0.3build1 · ubuntu questing
2.0.20 · ubuntu jammy
2.0.24 · ubuntu noble
2.0.21 · debian bookworm
2.0.28+8+0.0.3 · debian trixie

💖 uwsgi_gccgo 💖

okay bestie, welcome to the User Commands corner of the manual, this is the page for uwsgi_gccgo and honestly? it's giving legendary. ✨

🌸 NAME 🌸

uwsgi_gccgo — a fast (pure C), self-healing, developer-friendly WSGI server 🫶

no cap, that's the whole pitch. pure C. fast. heals itself. loves developers. icon behavior fr fr 💅

🌈 SYNOPSIS 🌈

uwsgi-core [options...]

literally just the binary and then however many options your heart desires 💖

✨ DESCRIPTION ✨

okay so here's the thing — this whole section is basically one giant stack of options and every single one of them is listed below. no skipping, no summarizing, we're going all the way down. grab a snack, bestie 🍓

🔌 sockets & protocols (the "where do i listen" era)

-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) 🤝

🧑🍳 workers, locking & harakiri (the "keep it alive" chapter)

-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 🐴🗡️

📂 config loading (feeding the server its lore)

-x, --xmlconfig — load config from xml file 📄
-x, --xml — load config from xml file 📄
--config — load configuration using the pluggable system 🧩
--fallback-config — re-exec uwsgi with the specified config when exit code is 1 🪂
--strict — enable strict mode (placeholder cannot be used) 😤
--skip-zero — skip check of file descriptor 0 0️⃣
--skip-atexit — skip atexit hooks (ignored by the master) 🚪
--skip-atexit-teardown — skip atexit teardown (ignored by the master) 🧹

🎀 placeholders, custom options & the opt-logic era

-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 ✅

🩹 write errors & sigpipe (the "stop screaming" section)

--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() 🚫

🧵 templating & includes

--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) 💉

🧚 daemonize, control & inspection

-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 📤

⚙️ tuning & limits (the numbers bestie)

-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 🗺️

🧵 threads & process names

-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 🏷️

👑 app loading & the master

-i, --single-interpreter — do not use multiple interpreters (where available) 1️⃣
--need-app — exit if no app can be loaded 😤
-M, --master — enable master process 👑
--honour-stdin — do not remap stdin to /dev/null 🫶

🏰 the Emperor (yes, really, it's called that)

--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 🧙

okay that's part 1 of 6 bestie, and there is SO much more coming — don't go anywhere 💖

okay bestie, deep breath, hydrate, we're still in the option mines ⛏️✨ but honestly? this part is kinda iconic. Emperor stuff, caches, spoolers, namespaces — it's giving systems programming main character energy fr fr.

--emperor-pidfile — drop the Emperor's pid into the file you name. That's it, that's the whole job 🫶
--emperor-tyrant — flip the Emperor into Tyrant mode. yes it's called that. no we didn't name it.
--emperor-tyrant-nofollow — in Tyrant mode, when it's checking uid/gid, do not follow symlinks. don't get tricked by a sneaky link, bestie 🚫🔗
--emperor-stats — run the Emperor stats server.
--emperor-stats-server — run the Emperor stats server. (same thing, different name, they're twins 💅)
--early-emperor — spawn the emperor as soon as possible. impatient king behavior 👑
--emperor-broodlord — run the emperor in BroodLord mode. yes, BroodLord. we love a dramatic name.
--emperor-throttle — set the throttling level, in milliseconds, for vassals that are acting up. default is 1000. time-out for misbehaving children 😤
--emperor-max-throttle — set the max throttling level, in milliseconds, for bad-behaving vassals. default is 3 minutes. so the naughty corner has a ceiling.
--emperor-magic-exec — if a vassal's config file has the executable bit set, prefix it with exec://. magic ✨
--emperor-on-demand-extension — go looking for a text file named <vassal name><extension> that contains the on demand socket name.
--emperor-on-demand-ext — same deal, shorter name. searches for a text file (vassal name + extension) holding the on demand socket name.
--emperor-on-demand-directory — turns on on demand mode and binds to a unix socket inside the directory you give, named like the vassal + .socket.
--emperor-on-demand-dir — the abbreviated twin of the above. same behavior: on demand mode, unix socket in your directory, named <vassal> + .socket.
--emperor-on-demand-exec — use the output of the command you specify as the on demand socket name. the vassal name gets passed in as the only argument.
--emperor-extra-extension — lets the Emperor accept the extension you name. vassals with it get called with --config.
--emperor-extra-ext — the short-name version: allow the given extension in the Emperor, vassal invoked with --config.
--emperor-no-blacklist — kill the Emperor blacklisting subsystem. no more naughty list 🚫📝
--emperor-use-clone — use clone() instead of fork(), passing along the unshare() flags you specify.
--emperor-graceful-shutdown — during ragnarok, let the vassals go out with a graceful shutdown. respectful. 🌸
--emperor-cap — set the vassals' capability.
--vassals-cap — set the vassals' capability. (yes, same as above, this page really said "here's three spellings, pick your fave")
--vassal-cap — set the vassals' capability. third one. collect the whole set 🎀
--imperial-monitor-list — list the imperial monitors that are enabled.
--imperial-monitors-list — list the enabled imperial monitors. plural, same energy.
--vassals-inherit — add config templates into the vassals' config. this one uses --inherit.
--vassals-include — include config templates into the vassals' config. this one uses --include instead of --inherit.
--vassals-inherit-before — add config templates to the vassals' config using --inherit, and it parses before the vassal file.
--vassals-include-before — include config templates into the vassals' config using --include instead of --inherit, parsed before the vassal file.
--vassals-start-hook — run your command before each vassal starts up. hype person for every vassal 📣
--vassals-stop-hook — run your command after a vassal dies.
--vassal-sos — when a vassal is overloaded, it asks the emperor for reinforcement. SOS bestie, send help 🆘
--vassal-sos-backlog — ask the emperor for SOS when the backlog queue has more items than the value you set.
--vassals-set — automatically --set the option you name for every single vassal. mass apply, slay.
--vassal-set — automatically set the specified option (via --set) for every vassal. singular spelling, same power.
--heartbeat — announce healthiness to the emperor. "i'm alive!!" 💓
--reload-mercy — the max time, in seconds, that we wait for workers and other processes to die during reload/shutdown.
--worker-reload-mercy — the max time, in seconds, that a worker is allowed to take to reload/shutdown. default is 60.
--mule-reload-mercy — the max time, in seconds, that a mule is allowed to take to reload/shutdown. default is 60.
--exit-on-reload — force an exit even if a reload was requested. it said no and meant it 🚪
--die-on-term — on SIGTERM, exit instead of doing a brutal reload.
--force-gateway — force the first registered gateway to spawn without a master.
-h, --help — show this help.
-h, --usage — show this help. (yep, -h does both, it's a multitasker 💅)
--print-sym — print the content of the binary symbol you specify.
--print-symbol — print the content of the specified binary symbol. long-form twin.
-r, --reaper — call waitpid(-1,...) after each request to clear out zombies. 🧟 no undead processes on our watch.
-R, --max-requests — reload workers after the specified amount of managed requests.
--max-requests-delta — add (worker_id * delta) to the max_requests value of each worker.
--min-worker-lifetime — number of seconds a worker has to run before it can be reloaded. default is 10.
--max-worker-lifetime — reload workers after the specified amount of seconds. default is disabled.
--max-worker-lifetime-delta — add (worker_id * delta) seconds to the max_worker_lifetime value of each worker.
-z, --socket-timeout — set the internal sockets timeout.
--no-fd-passing — disable file descriptor passing.
--locks — create the number of shared locks you specify.
--lock-engine — set the lock engine.
--ftok — set the ipcsem key via ftok() so you dodge duplicates.
--persistent-ipcsem — do not remove ipcsem's on shutdown. they stay. periodt.
-A, --sharedarea — create a raw shared memory area of the specified number of pages. note: it supports keyval too.
--safe-fd — do not close the file descriptor you specify.
--fd-safe — do not close the specified file descriptor. same thing, flipped name, we love that for us.
--cache — create a shared cache containing the given elements.
--cache-blocksize — set the cache blocksize.
--cache-store — enable a persistent cache to disk. it survives 💾
--cache-store-sync — set how often the persistent cache syncs.
--cache-no-expire — disable the auto sweep of expired items.
--cache-expire-freq — set how often the cache sweeper scans. default is 3 seconds.
--cache-report-freed-items — constantly report each cache item the sweeper frees. > use only for debug, bestie, this one is loud.
--cache-udp-server — bind the cache udp server to the socket you specify. it's used only for set/update/delete.
--cache-udp-node — send cache update/deletion over to the cache udp server you name.
--cache-sync — copy the entire content of another uWSGI cache server when the server starts up.
--cache-use-last-modified — update the last_modified_at timestamp on every cache item modification. default is disabled.
--add-cache-item — add an item into the cache.
--load-file-in-cache — load a static file into the cache.
--load-file-in-cache-gzip — load a static file into the cache, with gzip compression. 🗜️✨
--cache2 — create a new generation shared cache. keyval syntax.
--queue — enable the shared queue.
--queue-blocksize — set the queue blocksize.
--queue-store — enable a persistent queue to disk.
--queue-store-sync — set how often the persistent queue syncs.
-Q, --spooler — run a spooler on the directory you specify.
--spooler-external — map spooler requests onto a spooler directory that's managed by an external instance.
--spooler-ordered — try to order how spooler tasks get executed. we're trying our best okay 😭
--spooler-chdir — chdir() into the specified directory before each spooler task.
--spooler-processes — set the number of processes for spoolers.
--spooler-quiet — don't be verbose about spooler tasks. shhh 🤫
--spooler-max-tasks — set the maximum number of tasks to run before recycling a spooler.
--spooler-harakiri — set the harakiri timeout for spooler tasks.
--spooler-frequency — set the spooler frequency.
--spooler-freq — set the spooler frequency. the short one. same vibe.
--mule — add a mule. 🐴
--mules — add the specified number of mules. herd behavior.
--farm — add a mule farm. yes, a farm of mules. the theme is committed.
--mule-msg-size — set the mule message buffer size.
--signal — send a uwsgi signal to a server.
--signal-bufsize — set the buffer size for the signal queue.
--signals-bufsize — set the buffer size for the signal queue. plural spelling, same buffer.
--signal-timer — add a timer. syntax: <signal> <seconds>.
--timer — add a timer. syntax: <signal> <seconds>. (short name, same timer)
--signal-rbtimer — add a redblack timer. syntax: <signal> <seconds>.
--rbtimer — add a redblack timer. syntax: <signal> <seconds>.
--rpc-max — maximum number of rpc slots. default: 64.
-L, --disable-logging — disable request logging.
--flock — lock the specified file before starting. if it's already locked, exit. 🔒
--flock-wait — lock the specified file before starting, and if it's locked, wait instead of bailing.
--flock2 — lock the specified file after logging/daemon setup. exit if it's locked.
--flock-wait2 — lock the specified file after logging/daemon setup, and wait if it's locked.
--pidfile — create a pidfile. this happens before privileges drop.
--pidfile2 — create a pidfile. this one happens after privileges drop.
--safe-pidfile — create a safe pidfile, before privileges drop.
--safe-pidfile2 — create a safe pidfile, after privileges drop.
--chroot — chroot() into the directory you specify.
--pivot-root — pivot_root() into the directories you specify. new_root and put_old must be separated with a space.
--pivot_root — pivot_root() into the specified directories. again: new_root and put_old separated by a space. underscores, same option.
--uid — setuid to the user/uid you specify.
--gid — setgid to the group/gid you specify.
--add-gid — add the group id you specify to the process credentials.
--immediate-uid — setuid to the specified user/uid IMMEDIATELY. no waiting, no queue, right now.
--immediate-gid — setgid to the specified group/gid IMMEDIATELY.
--no-initgroups — disable the additional groups that get set via initgroups().
--cap — set the process capability.
--unshare — unshare() part of the processes and drop it into a new namespace. 🫧
--unshare2 — unshare() part of the processes into a new namespace, but after the rootfs change.
--setns-socket — expose a unix socket that returns namespace fds from /proc/self/ns.
--setns-socket-skip — skip the entry you name when sending setns file descriptors.
--setns-skip — skip the specified entry when sending setns file descriptors. short-name twin.
--setns — join a namespace that was created by an external uWSGI instance.
--setns-preopen — open /proc/self/ns as soon as possible and cache the fds. early bird gets the namespace 🐦
--jailed — marks this instance as jailed, which forces the post_jail hooks to actually run 💅
--refork — does a fork() again after the privileges drop. Super handy for jailing systems 🧚
--re-fork — same thing bestie: fork() again after privileges drop. Useful for jailing systems.
--refork-as-root — fork() again but before the privileges drop this time. Useful for jailing systems ✨
--re-fork-as-root — identical energy: fork() again before privileges drop. Useful for jailing systems.
--refork-post-jail — fork() again after jailing. Useful for jailing systems 🫶
--re-fork-post-jail — yep, the twin: fork() again after jailing. Useful for jailing systems.
--hook-asap — runs the hook you specify as soon as possible, like literally the moment it can 👑
--hook-pre-jail — runs the specified hook before jailing.
--hook-post-jail — runs the specified hook after jailing.
--hook-in-jail — runs the specified hook inside the jail, after initialization.
--hook-as-root — runs the specified hook before the privileges drop.
--hook-as-user — runs the specified hook after the privileges drop.
--hook-as-user-atexit — runs the specified hook before app exit and reload 🌸
--hook-pre-app — runs the specified hook before app loading.
--hook-post-app — runs the specified hook after app loading.
--hook-post-fork — runs the specified hook after each fork 🔁
--hook-accepting — runs the specified hook after each worker enters the accepting phase.
--hook-accepting1 — runs the specified hook after the first worker enters the accepting phase.
--hook-accepting-once — runs the specified hook after each worker enters the accepting phase, but once per-instance.
--hook-accepting1-once — runs the specified hook after the first worker enters the accepting phase, once per instance.
--hook-master-start — runs the specified hook when the Master starts up 🌈
--hook-touch — runs the specified hook whenever the file you name gets touched. Syntax: <file> <action> 👀
--hook-emperor-start — runs the specified hook when the Emperor starts.
--hook-emperor-stop — runs the specified hook when the Emperor sends a stop message.
--hook-emperor-reload — runs the specified hook when the Emperor sends a reload message.
--hook-emperor-lost — runs the specified hook when the Emperor connection is lost 💀
--hook-as-vassal — runs the specified hook before exec()ing the vassal.
--hook-as-emperor — runs the specified hook in the emperor after the vassal has been started.
--hook-as-mule — runs the specified hook in each mule.
--hook-as-gateway — runs the specified hook in each gateway.
--after-request-hook — runs the specified function/symbol after each request.
--after-request-call — runs the specified function/symbol after each request.
--exec-asap — runs the specified command as soon as possible ⚡
--exec-pre-jail — runs the specified command before jailing.
--exec-post-jail — runs the specified command after jailing.
--exec-in-jail — runs the specified command in jail after initialization.
--exec-as-root — runs the specified command before the privileges drop.
--exec-as-user — runs the specified command after the privileges drop.
--exec-as-user-atexit — runs the specified command before app exit and reload.
--exec-pre-app — runs the specified command before app loading.
--exec-post-app — runs the specified command after app loading.
--exec-as-vassal — runs the specified command before exec()ing the vassal.
--exec-as-emperor — runs the specified command in the emperor after the vassal has been started.
--mount-asap — mounts a filesystem as soon as possible 📁
--mount-pre-jail — mounts filesystem before jailing.
--mount-post-jail — mounts filesystem after jailing.
--mount-in-jail — mounts filesystem in jail after initialization.
--mount-as-root — mounts filesystem before the privileges drop.
--mount-as-vassal — mounts filesystem before exec()ing the vassal.
--mount-as-emperor — mounts filesystem in the emperor after the vassal has been started.
--umount-asap — unmounts a filesystem as soon as possible 🧹
--umount-pre-jail — unmounts filesystem before jailing.
--umount-post-jail — unmounts filesystem after jailing.
--umount-in-jail — unmounts filesystem in jail after initialization.
--umount-as-root — unmounts filesystem before the privileges drop.
--umount-as-vassal — unmounts filesystem before exec()ing the vassal.
--umount-as-emperor — unmounts filesystem in the emperor after the vassal has been started.
--wait-for-interface — waits for the network interface you name to come up before running root hooks 🌐
--wait-for-interface-timeout — sets the timeout for wait-for-interface.
--wait-interface — waits for the specified network interface to come up before running root hooks.
--wait-interface-timeout — sets the timeout for wait-for-interface.
--wait-for-iface — waits for the specified network interface to come up before running root hooks.
--wait-for-iface-timeout — sets the timeout for wait-for-interface.
--wait-iface — waits for the specified network interface to come up before running root hooks.
--wait-iface-timeout — sets the timeout for wait-for-interface.
--wait-for-fs — waits for the specified filesystem item to appear before running root hooks.
--wait-for-file — waits for the specified file to appear before running root hooks 📄
--wait-for-dir — waits for the specified directory to appear before running root hooks.
--wait-for-mountpoint — waits for the specified mountpoint to appear before running root hooks.
--wait-for-fs-timeout — sets the timeout for wait-for-fs/file/dir ⏳
--wait-for-socket — waits for the specified socket to be ready before loading apps.
--wait-for-socket-timeout — sets the timeout for wait-for-socket.
--call-asap — calls the specified function as soon as possible 📞
--call-pre-jail — calls the specified function before jailing.
--call-post-jail — calls the specified function after jailing.
--call-in-jail — calls the specified function in jail after initialization.
--call-as-root — calls the specified function before the privileges drop.
--call-as-user — calls the specified function after the privileges drop.
--call-as-user-atexit — calls the specified function before app exit and reload.
--call-pre-app — calls the specified function before app loading.
--call-post-app — calls the specified function after app loading.
--call-as-vassal — calls the specified function() before exec()ing the vassal.
--call-as-vassal1 — calls the specified function(char *) before exec()ing the vassal.
--call-as-vassal3 — calls the specified function(char *, uid_t, gid_t) before exec()ing the vassal.
--call-as-emperor — calls the specified function() in the emperor after the vassal has been started.
--call-as-emperor1 — calls the specified function(char *) in the emperor after the vassal has been started.
--call-as-emperor2 — calls the specified function(char *, pid_t) in the emperor after the vassal has been started.
--call-as-emperor4 — calls the specified function(char *, pid_t, uid_t, gid_t) in the emperor after the vassal has been started.
--ini — loads config from an ini file 📜
-y|--yaml — loads config from a yaml file.
-y|--yml — loads config from a yaml file.
-j|--json — loads config from a json file.
-j|--js — loads config from a json file.
--weight — sets the weight of the instance (used by clustering/lb/subscriptions) ⚖️
--auto-weight — sets the weight of the instance (used by clustering/lb/subscriptions) automatically.
--no-server — forces no-server mode.
--command-mode — forces command mode.
--no-defer-accept — disables deferred-accept on sockets.
--tcp-nodelay — enables TCP NODELAY on each request 🚀
--so-keepalive — enables TCP KEEPALIVEs.
--so-send-timeout — sets SO_SNDTIMEO.
--socket-send-timeout — sets SO_SNDTIMEO.
--so-write-timeout — sets SO_SNDTIMEO.
--socket-write-timeout — sets SO_SNDTIMEO.
--socket-sndbuf — sets SO_SNDBUF.
--socket-rcvbuf — sets SO_RCVBUF.
--shutdown-sockets — forces calling shutdown() in addition to close() when sockets are destroyed 🔌
--limit-as — limits processes address space/vsz.
--limit-nproc — limits the number of spawnable processes.
--reload-on-as — reloads if address space is higher than the specified megabytes.
--reload-on-rss — reloads if rss memory is higher than the specified megabytes.
--evil-reload-on-as — forces the master to reload a worker if its address space is higher than the specified megabytes 😈
--evil-reload-on-rss — forces the master to reload a worker if its rss memory is higher than the specified megabytes.
--mem-collector-freq — sets the memory collector frequency when evil reloads are in place.
--reload-on-fd — reloads if the specified file descriptor is ready.
--brutal-reload-on-fd — brutal reload if the specified file descriptor is ready 💀
--ksm — enables Linux KSM.
--pcre-jit — enables pcre jit (if available).
--never-swap — locks all memory pages, avoiding swapping 🔒
--touch-reload — reloads uWSGI if the specified file is modified/touched.
--touch-workers-reload — triggers a reload of (only) the workers if the specified file is modified/touched.
--touch-mules-reload — reloads mules if the specified file is modified/touched.
--touch-spoolers-reload — reloads spoolers if the specified file is modified/touched.
--touch-chain-reload — triggers a chain reload if the specified file is modified/touched ⛓️
--touch-logrotate — triggers logrotation if the specified file is modified/touched.
--touch-logreopen — triggers log reopen if the specified file is modified/touched.
--touch-exec — runs a command when the specified file is modified/touched. Syntax: file command ✨
--touch-signal — the moment that one file gets modified or touched, fire off a signal, bestie ✨ (syntax is file signal, so like --touch-signal /tmp/thing 17)
--fs-reload — if the filesystem object you point at gets modified, do a graceful reload 💅
--fs-brutal-reload — same energy, except it's a brutal reload when that filesystem object changes 😤 no softness, no grace
--fs-signal — raise a uwsgi signal when the specified filesystem object gets modified (syntax: file signal) 🦋
--check-mountpoint — if a filesystem becomes unreachable, the instance gets destroyed 💀 genuinely useful if you want reliable Fuse management
--mountpoint-check — exact same thing: destroy the instance if a filesystem is no longer reachable (again, for reliable Fuse management) 🔥
--check-mount — yep, you guessed it — destroy the instance when a filesystem is unreachable, for that reliable Fuse management life 🌸
--mount-check — the fourth alias, same deal: instance goes bye-bye if the filesystem can't be reached, useful for reliable Fuse management 🎀
--propagate-touch — the over-engineering option, for systems with flaky signal management 🙈 it's giving "we did too much and we know it"
--limit-post — cap that request body, periodt 💅
--no-orphans — workers get automatically killed if the master dies. Heads up though: this can be dangerous for availability ⚠️
--prio — set processes/threads priority 👑
--cpu-affinity — set cpu affinity 🧚
--post-buffering — set the size in bytes where, past that point, it buffers to disk instead of memory 🍓
--post-buffering-bufsize — set the buffer size used for read() in post buffering mode 💜
--body-read-warning — set how much memory allocation (in megabytes) is allowed for a request body before it starts printing a warning 😭
--upload-progress — turn on creation of .json files in the directory you specify, while a file upload is happening ✨
--no-default-app — do not fall back to the default app 🙅
--manage-script-name — automatically rewrite SCRIPT_NAME and PATH_INFO 🦋
--ignore-script-name — just ignore SCRIPT_NAME entirely
--catch-exceptions — report exceptions as http output. Discouraged — use this only for testing, fr fr 🚨
--reload-on-exception — reload a worker whenever an exception gets raised 🔄
--reload-on-exception-type — reload a worker when one specific exception type gets raised 🎯
--reload-on-exception-value — reload a worker when a specific exception value gets raised
--reload-on-exception-repr — reload a worker when a specific exception type+value (language-specific) is raised 💅
--exception-handler — add an exception handler 🫶
--enable-metrics — turn on the metrics subsystem 📊
--metric — add a custom metric ✨
--metric-threshold — add a metric threshold/alarm 🚨
--metric-alarm — also adds a metric threshold/alarm (same thing, different name bestie)
--alarm-metric — and again — add a metric threshold/alarm 💖
--metrics-dir — export metrics as text files into the directory you name 📁
--metrics-dir-restore — restore the last value taken from the metrics dir
--metric-dir — export metrics as text files to the specified directory (yes, singular spelling, same vibe)
--metric-dir-restore — restore last value taken from the metrics dir 💫
--metrics-no-cores — disable generation of cores-related metrics 🚫
--udp — run the udp server on the address you give it 🌈
--stats — enable the stats server on the specified address 📈
--stats-server — enable the stats server on the specified address (same option, other name)
--stats-http — prefix the stats server json output with http headers 🌐
--stats-minified — minify the statistics json output ✂️
--stats-min — minify statistics json output (short version, same result)
--stats-push — push the stats json to the destination you specify 🚀
--stats-pusher-default-freq — set the default frequency of stats pushers ⏱️
--stats-pushers-default-freq — set the default frequency of stats pushers (plural spelling, same deal)
--stats-no-cores — disable generation of cores-related stats
--stats-no-metrics — don't include metrics in the stats output 🙅
--multicast — subscribe to the multicast group you specify 📡
--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 — declare itself a dead node for the number of seconds you specify if one of the lord hooks fails 💀
--legion-skew-tolerance — set the clock skew tolerance of the legion subsystem (default 60 seconds) ⏰
--legion-lord — action to call on Lord election 👑
--legion-unlord — action to call on Lord dismiss
--legion-setup — action to call on legion setup ✨
--legion-death — action to call on legion death (that's the shutdown of the instance, dramatic ik) 😭
--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 the max size of the legion scroll buffer
--legion-scroll-list-max-size — set the max size of the legion scroll list buffer
--subscriptions-sign-check — set the digest algorithm and certificate directory for the secured subscription system 🔐
--subscriptions-sign-check-tolerance — set the maximum tolerance (in seconds) of clock skew for the secured subscription system
--subscriptions-sign-skip-uid — skip the signature check for the uid you specify when using unix sockets credentials 🪪
--subscriptions-credentials-check — add a directory to search for subscriptions key credentials 🔎
--subscriptions-use-credentials — enable management of SCM_CREDENTIALS in subscriptions UNIX sockets
--subscription-algo — set the load balancing algorithm for the subscription system ⚖️
--subscription-dotsplit — try to fall back to the next part (dot based) in the subscription key 🎯
--subscribe-to — subscribe to the subscription server you specify 📬
--st — subscribe to the specified subscription server (the tiny version)
--subscribe — subscribe to the specified subscription server 🫶
--subscribe2 — subscribe to the specified subscription server using the advanced keyval syntax ✨
--subscribe-freq — send subscription announce at the interval you specify ⏱️
--subscription-tolerance — set tolerance for subscription servers
--unsubscribe-on-graceful-reload — force the unsubscribe request even during a graceful reload 💅
--start-unsubscribed — configure subscriptions but don't actually send them (super handy 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 📢
--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 ssl ciphers for the sni-dir option 🔒
--ssl-enable3 — enable SSLv3. This is insecure ⚠️ like, genuinely, bestie
--ssl-enable-sslv3 — enable SSLv3 — also insecure 🚨
--ssl-enable-tlsv1 — enable TLSv1 — insecure too 😬
--ssl-option — set a raw ssl option (numeric value) 🔢
--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 number of seconds you specify when a forkbomb is detected 💣
--binary-path — force binary path 🛣️
--privileged-binary-patch — patch the uwsgi binary with a new command (this happens before privileges drop) 👑
--unprivileged-binary-patch — patch the uwsgi binary with a new command (this happens 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 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 (same option, one dash fewer)
--logformat-strftime — apply strftime to logformat output 🕰️
--log-format-strftime — apply strftime to logformat output (yep, the dashed twin)
--logfile-chown — chown logfiles 👤
--logfile-chmod — chmod logfiles 🔧
--log-syslog — log to syslog 📮
--log-socket — send logs to the socket you specify 🔌
--req-logger — set/append a request logger
--logger-req — set/append a request logger (same thing, flipped name, we love consistency 💅)
--logger — set/append a logger 📋
--logger-list — list enabled loggers 📃
--loggers-list — list enabled loggers (plural, same output)
--threaded-logger — offload log writing to a thread 🧵
--log-encoder — add an item in the log encoder chain 🔗
--log-req-encoder — add an item in the log req encoder chain
--log-drain — drain (aka don't show) log lines that match the regexp you specify 🕳️
--log-filter — show only log lines matching the regexp you specify 🔍
--log-route — log to the named logger you specify if the regexp applied to the logline matches 🚏
--log-req-route — log requests to the named logger you specify if the regexp applied to the logline matches
--use-abort — call abort() on segfault/fpe, which could be useful for generating a core dump 💥
--alarm — create a new alarm, syntax: <alarm> <plugin:args> ⏰
--alarm-cheap — bestie, instead of spinning up a whole dedicated thread for every curl-based alarm, just reuse the main alarm thread 💅 cheaper, faster, iconic.
--alarm-freq — tunes the anti-loop alarm system. default is 3 seconds btw ⏱️
--alarm-fd — fire the alarm you name whenever an fd gets read for read. by default it reads 1 byte — set it to 8 for eventfd, no cap 🫶
--alarm-segfault — raise the specified alarm the moment the segmentation fault handler runs 💀
--segfault-alarm — same energy, same thing: raise the specified alarm when the segfault handler executes 💀
--alarm-backlog — raise the specified alarm when the socket backlog queue is full 😭
--backlog-alarm — yep, twin: raise the specified alarm when the socket backlog queue is full 😭
--lq-alarm — raise the specified alarm when the socket backlog queue is full (listen-queue girlies rise 🙈)
--alarm-lq — same deal, raise the specified alarm when the socket backlog queue is full.
--alarm-listen-queue — raise the specified alarm when the socket backlog queue is full 🔥
--listen-queue-alarm — and again, raise the specified alarm when the socket backlog queue is full.
--log-alarm — raise the specified alarm whenever a log line matches your regexp. syntax: <alarm>[,alarm...] <regexp> ✨
--alarm-log — raise the specified alarm when a log line matches the specified regexp. syntax: <alarm>[,alarm...] <regexp>
--not-log-alarm — skip the specified alarm when a log line matches the regexp. syntax: <alarm>[,alarm...] <regexp> 🙅‍♀️
--not-alarm-log — skip the specified alarm when a log line matches the specified regexp. syntax: <alarm>[,alarm...] <regexp>
--alarm-list — just lists all your enabled alarms, so you can vibe check them 👑
--alarms-list — same, list enabled alarms.
--alarm-msg-size — sets the max size of an alarm message. default is 8192 📏
--log-master — delegate the logging to the master process 🧚
--log-master-bufsize — set the buffer size for the master logger. heads up: bigger log messages will be truncated ✂️
--log-master-stream — create the master logpipe as SOCK_STREAM 🌊
--log-master-req-stream — create the master requests logpipe as SOCK_STREAM 🌊
--log-reopen — reopen the log after a reload 🔄
--log-truncate — truncate the log on startup 🧼
--log-maxsize — set maximum logfile size.
--log-backupname — set the logfile name used after rotation 🎀
--logdate — prefix logs with a date, or a strftime string 📅
--log-date — prefix logs with date or a strftime string (same thing, cuter hyphen 💖)
--log-prefix — prefix logs with a string of your choosing ✍️
--log-zero — log responses that have no body 👻
--log-slow — log requests slower than the number of milliseconds you specify 🐌
--log-4xx — log requests that come back with a 4xx response 😬
--log-5xx — log requests with a 5xx response 😭
--log-big — log requests bigger than the size you specify 🐘
--log-sendfile — log sendfile requests 📨
--log-ioerror — log requests that hit io errors 💥
--log-micros — report response time in microseconds instead of milliseconds 🔬
--log-x-forwarded-for — use the ip from the X-Forwarded-For header instead of REMOTE_ADDR 🕵️‍♀️

--master-as-root — leave the master process running as root 👑
--drop-after-init — run the privileges drop after plugin initialization. note: this is superseded by drop-after-apps ⚠️
--drop-after-apps — run the privileges drop after apps loading. note: this is superseded by master-as-root ⚠️
--force-cwd — force the initial working directory to the value you specify 📂
--binsh — override /bin/sh (used by exec hooks, and it always falls back to /bin/sh) 🐚
--chdir — chdir to the specified directory before apps loading 🚪
--chdir2 — chdir to the specified directory after apps loading 🚪
--lazy — set lazy mode: load apps in the workers instead of the master 😴
--lazy-apps — load apps in each worker instead of the master 💤
--cheap — set cheap mode: only spawn workers after the first request 🪙
--cheaper — set cheaper mode, aka adaptive process spawning 📈
--cheaper-initial — set the initial number of processes to spawn in cheaper mode 🌱
--cheaper-algo — choose the algorithm used for adaptive process spawning 🧠
--cheaper-step — the number of additional processes to spawn at each overload 🪜
--cheaper-overload — increase workers after the specified overload 🚀
--cheaper-algo-list — list enabled cheapers algorithms 📜
--cheaper-algos-list — list enabled cheapers algorithms.
--cheaper-list — list enabled cheapers algorithms.
--cheaper-rss-limit-soft — don't spawn new workers if the total resident memory usage of all workers is higher than this limit 🧷
--cheaper-rss-limit-hard — if total workers resident memory usage is higher than this, try to stop workers ✋
--idle — set idle mode: put uWSGI into cheap mode after inactivity 😌
--die-on-idle — shutdown uWSGI when idle 💀
--mount — load the application under the specified mountpoint 🗂️
--worker-mount — load the application under the mountpoint in the specified worker, or after workers spawn 👷
--threads — run each worker in prethreaded mode with the specified number of threads 🧵
--thread-stacksize — set threads stacksize.
--threads-stacksize — set threads stacksize.
--thread-stack-size — set threads stacksize.
--threads-stack-size — set threads stacksize (yes bestie, four whole spellings of the same thing, slay 💅)
--vhost — enable virtualhosting mode, based on the SERVER_NAME variable 🌐
--vhost-host — enable virtualhosting mode, based on the HTTP_HOST variable 🌐

--route — add a route 🛣️
--route-host — add a route based on the 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 a condition 🤔
--route-if-not — add a route based on a condition, but the 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 the 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 a condition 🤔
--final-route-if-not — add a final route based on a 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 the 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 a condition 🤔
--error-route-if-not — add an error route based on a 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 the 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 a condition 🤔
--response-route-if-not — add a response route based on a condition, negate version 🙃
--response-route-run — always run the specified response route action ▶️
--router-list — list enabled routers 📋
--routers-list — list enabled routers.
--error-page-403 — add an error page (html) for a managed 403 response 🚫
--error-page-404 — add an error page (html) for a managed 404 response 🔍
--error-page-500 — add an error page (html) for a managed 500 response 💥

--websockets-ping-freq — set the frequency (in seconds) of websockets automatic ping packets 🏓
--websocket-ping-freq — set the frequency (in seconds) of websockets automatic ping packets.
--websockets-pong-tolerance — set the tolerance (in seconds) of the websockets ping/pong subsystem 🏓
--websocket-pong-tolerance — set the tolerance (in seconds) of the websockets ping/pong subsystem.
--websockets-max-size — set the max allowed size of websocket messages, in Kbytes, default 1024 📦
--websocket-max-size — set the max allowed size of websocket messages, in Kbytes, default 1024.
--chunked-input-limit — set the max size of a chunked input part. default 1MB, in bytes 🧩
--chunked-input-timeout — set the default timeout for chunked input ⏳
--clock — set a clock source ⏰
--clock-list — list enabled clocks 🕰️

okay we're SO back bestie, the options keep going and honestly? iconic behavior 💅

--clocks-list — shows you every clock that's enabled, like a lil headcount of your clocks ⏰
--add-header — auto-slaps HTTP headers onto the response, no manual labor required ✨
--rem-header — auto-removes the HTTP header you name from the response, gone, bye 🫶
--del-header — same vibe as above: auto-removes the specified HTTP header from the response 💫
--collect-header — stashes the specified response header into a request var (syntax: header var) 🎀
--response-header-collect — also stores that specified response header in a request var (syntax: header var) 🌸
--pull-header — stores the specified response header in a request var and yeets it out of the response (syntax: header var) 💀
--check-static — peeks for static files in the directory you name 👀
--check-static-docroot — checks for static files in the requested DOCUMENT_ROOT 🗂️
--static-check — checks for static files in the specified directory (yes, same energy as check-static, different flag name) 🔍
--static-map — maps a mountpoint to a static directory (or file) 🗺️
--static-map2 — like --static-map except it completely appends the requested resource to the docroot 🌈
--static-skip-ext — skips the extension you name when doing staticfile checks 🙈
--static-index — searches for the file you specify if a directory is what got requested 📁
--static-safe — skips security checks when the file lives under the path you give it 🛡️
--static-cache-paths — pops resolved paths into the uWSGI cache for however many seconds you say ⏱️
--static-cache-paths-name — uses the cache you named for static paths 💾
--mimefile — sets the mime types file path (default /etc/mime.types) 📄
--mime-file — also sets the mime types file path (default /etc/mime.types), twin flag fr fr 👯
--static-expires-type — sets the Expires header based on content type 🕰️
--static-expires-type-mtime — sets the Expires header based on content type and file mtime ⏳
--static-expires — sets the Expires header based on a filename regexp 🔤
--static-expires-mtime — sets the Expires header based on filename regexp and file mtime ⌛
--static-expires-uri — sets the Expires header based on a REQUEST_URI regexp 🔗
--static-expires-uri-mtime — sets the Expires header based on REQUEST_URI regexp and file mtime 🕐
--static-expires-path-info — sets the Expires header based on a PATH_INFO regexp 🛤️
--static-expires-path-info-mtime — sets the Expires header based on PATH_INFO regexp and file mtime 🕑
--static-gzip — if your regexp matches the static file translation, it goes hunting for a gzip version 🗜️
--static-gzip-all — checks for a gzip version of every requested static file 🎁
--static-gzip-dir — checks for a gzip version of all requested static files in the dir/prefix you specify 📦
--static-gzip-prefix — same deal: gzip version check for all requested static files in the specified dir/prefix 🧳
--static-gzip-ext — checks for a gzip version of all requested static files with the ext/suffix you give 🏷️
--static-gzip-suffix — same but it's the specified ext/suffix, matching energy 💅
--honour-range — turns on support for the HTTP Range header 🎯
--offload-threads — sets how many offload threads to spawn (per-worker, default 0) 🧵
--offload-thread — same: number of offload threads to spawn (per-worker, default 0) 🪡
--file-serve-mode — sets the static file serving mode 🍽️
--fileserve-mode — also sets the static file serving mode, bestie twin 🫂
--disable-sendfile — disables sendfile() and relies on the "boring" read()/write() instead 😴
--check-cache — checks for response data in the cache you name (leave it empty for the default cache) 🔎
--close-on-exec — sets close-on-exec on connection sockets (could be required for spawning processes in requests) 🔒
--close-on-exec2 — sets close-on-exec on server sockets (could be required for spawning processes in requests) 🗝️
--mode — sets a uWSGI custom mode 🎛️
--env — sets an environment variable 🌱
--envdir — loads a daemontools compatible envdir 📂
--early-envdir — loads a daemontools compatible envdir ASAP, like right now, no waiting 🏃‍♀️
--unenv — unsets an environment variable 🚫
--vacuum — tries to remove all the generated file/sockets 🧹
--file-write — writes the content you specify to the file you specify (syntax: file=value) before privileges drop ✍️
--cgroup — puts the processes in the cgroup you name 🪺
--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 rootfs you specify 🌌
--namespace-keep-mount — keeps the mountpoint you name inside your namespace 📌
--ns — also runs in a new namespace under the specified rootfs, twin flag 💫
--namespace-net — adds a network namespace 🕸️
--ns-net — adds a network namespace, matching set 🌐
--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 qlen value you give ⚡
--tcp-fastopen — same: TCP_FASTOPEN flag on TCP sockets with the specified qlen value 🚀
--tcp-fast-open-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if it's supported 📨
--tcp-fastopen-client — same energy: sendto(..., MSG_FASTOPEN, ...) over connect() if supported 📬
--zerg — attaches to a zerg server 🛸
--zerg-fallback — falls back to normal sockets when the zerg server isn't available 🪂
--zerg-server — enables the zerg server on the UNIX socket you specify 🔌
--cron — adds a cron task ⏲️
--cron2 — adds a cron task with key=val syntax 🔑
--unique-cron — adds a unique cron task 🌟
--cron-harakiri — sets the max time (in seconds) we wait for the cron command to complete ⏳
--legion-cron — adds a cron task that only runs when the instance is a lord of the specified legion 👑
--cron-legion — same thing, legion-lord-only cron task 🏰
--unique-legion-cron — adds a unique cron task that only runs when the instance is a lord of the specified legion 💎
--unique-cron-legion — unique cron task, legion-lord-only, yes again 🎠
--loop — selects the uWSGI loop engine 🔄
--loop-list — lists enabled loop engines 📋
--loops-list — also lists enabled loop engines, plural twin 📝
--worker-exec — runs the command you specify as a worker 👷
--worker-exec2 — runs the specified command as a worker (after the post_fork hook) 🪝
--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), 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 only runs on the legion lord node 👑
--legion-smart-attach-daemon — same as --smart-attach-daemon but daemon only runs on the legion lord node 🏅
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2 but daemon only runs on the legion lord node 🎖️
--daemons-honour-stdin — does not change the stdin of external daemons to /dev/null 🙅
--attach-daemon2 — the attach-daemon keyval variant (supports smart modes too) 🔧
--plugins — loads uWSGI plugins 🧩
--plugin — loads uWSGI plugins, singular twin 🧷
--need-plugins — loads uWSGI plugins and exits on error 🚪
--need-plugin — same: loads uWSGI plugins, exits on error 🛑
--plugins-dir — adds a directory to the uWSGI plugin search path 🗺️
--plugin-dir — adds a directory to the uWSGI plugin search path, twin again 📍
--plugins-list — lists enabled plugins 📜
--plugin-list — lists enabled plugins, yep 📃
--autoload — tries to automatically load plugins when unknown options show up 🤖
--dlopen — blindly loads a shared library, no questions asked 🙈
--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 (the immediate version) ⚡
--exit — forces exit() of the instance 🚪
--cflags — reports uWSGI CFLAGS (useful for building external plugins) 🏗️
--dot-h — dumps the uwsgi.h used for building the core (useful for building external plugins) 📄
--config-py — dumps the uwsgiconfig.py used for building the core (useful for building external plugins) 🐍
--build-plugin — builds a uWSGI plugin for the current binary 🔨
--version — 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 made it to the end and honestly? main character energy fr fr. this page comes to you from uwsgi_gccgo version 2.0.31-2, dated February 2026 — go build something gorgeous with it 💖✨🌸

📦 where this page comes from

ubuntu resolute: uwsgi-plugin-gccgo 2.0.31+2+0.0.3build2 · GPL-3.0-or-later
ubuntu stonking: uwsgi-plugin-gccgo 2.0.31+2+0.0.3build2 · GPL-3.0-or-later
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-18: a language model's rewrite of the original, under its terms