UWSGI_SQLITE3(1)

📦

version 2.0.31 · 7 versions

✨ NAME ✨

uwsgi_sqlite3 — fast (pure C), self-healing, developer-friendly WSGI server 💖

bestie, this is the UWSGI_SQLITE3(1) manual page and it's serving main character energy. no cap. 🫶

📜 SYNOPSIS 📜

uwsgi-core [options...]

so you run uwsgi-core with a whole pile of options, and she goes. periodt. 💅

💅 DESCRIPTION 💅

okay so here's the entire menu of options, bestie. each one is a little vibe. read carefully, because every single flag matters, fr fr. 👑

-s, --socket — bind to the specified UNIX/TCP socket using default protocol. it's giving "just connect me already" ✨
-s, --uwsgi-socket — bind to the specified UNIX/TCP socket using uwsgi protocol. lowkey iconic. 💜
--suwsgi-socket — bind to the specified UNIX/TCP socket using uwsgi protocol over SSL. secure vibes only. 🔒
--ssl-socket — bind to the specified UNIX/TCP socket using uwsgi protocol over SSL. slay. 💖
--http-socket — bind to the specified UNIX/TCP socket using HTTP protocol. yesss web requests. 🌐
--http-socket-modifier1 — force the specified modifier1 when using HTTP protocol. boss move. 👑
--http-socket-modifier2 — force the specified modifier2 when using HTTP protocol. another boss move. 👑
--http11-socket — bind to the specified UNIX/TCP socket using HTTP 1.1 (Keep-Alive) protocol. keep-alive is so fetch. ✨
--https-socket — bind to the specified UNIX/TCP socket using HTTPS protocol. secure and slay. 🔐
--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. speedy boi. ⚡
--fastcgi-nph-socket — bind to the specified UNIX/TCP socket using FastCGI protocol (nph mode). nph mode activated. 🦋
--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 and unfiltered, just like my group chat. 😭
--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). persistent? we love commitment. 💖
--protocol — force the specified protocol for default sockets. choose your fighter. ⚔️
--socket-protocol — force the specified protocol for default sockets. same energy. ✨
--shared-socket — create a shared socket for advanced jailing or ipc. sharing is caring. 🤝
--undeferred-shared-socket — create a shared socket for advanced jailing or ipc (undeferred mode). no waiting around. 💅
-p, --processes — spawn the specified number of workers/processes. get your crew. 👯
-p, --workers — spawn the specified number of workers/processes. same, but different name. 💖
--thunder-lock — serialize accept() usage (if possible). thunder lock sounds so dramatic, love that. ⚡
-t, --harakiri — set harakiri timeout. dramatic exit timing. 🗡️
--harakiri-verbose — enable verbose mode for harakiri. tell me everything. 🗣️
--harakiri-graceful-timeout — interval between graceful harakiri attempt and a sigkill. so you get a warning before the kill. 💀
--harakiri-graceful-signal — use this signal instead of sigterm for graceful harakiri attempts. pick your signal. 🚦
--harakiri-queue-threshold — only trigger harakiri if queue is greater than this threshold. don't be dramatic unless the queue is long. 📏
--harakiri-no-arh — do not enable harakiri during after-request-hook. chill. 🧘
--no-harakiri-arh — do not enable harakiri during after-request-hook. same vibe. 🧘
--no-harakiri-after-req-hook — do not enable harakiri during after-request-hook. okay we get it. 🙈
--backtrace-depth — set backtrace depth. how deep do you wanna go? 🌊
--mule-harakiri — set harakiri timeout for mule tasks. mules get their own drama timer. 🐴
-x, --xmlconfig — load config from xml file. old school but valid. 📜
-x, --xml — load config from xml file. same. 💅
--config — load configuration using the pluggable system. plug it in. 🔌
--fallback-config — re-exec uwsgi with the specified config when exit code is 1. backup plan activated. 🚨
--strict — enable strict mode (placeholder cannot be used). no placeholders, no exceptions. 😤
--skip-zero — skip check of file descriptor 0. zero? don't care. 0️⃣
--skip-atexit — skip atexit hooks (ignored by the master). bye bye cleanup. 👋
--skip-atexit-teardown — skip atexit teardown (ignored by the master). double bye. 👋👋
-S, --set — set a placeholder or an option. set it and forget it. ✨
--set-placeholder — set a placeholder. just a placeholder. 🎀
--set-ph — set a placeholder. short and sweet. 💖
--get — print the specified option value and exit. get in, get out. 🏃
--declare-option — declare a new uWSGI custom option. make it yours. 👑
--declare-option2 — declare a new uWSGI custom option (non-immediate). non-immediate, so it waits. ⏳
--resolve — place the result of a dns query in the specified placeholder, sytax: placeholder=name (immediate option). dns but make it placeholder. 🌐
--for — (opt logic) for cycle. loop de loop. 🔁
--for-glob — (opt logic) for cycle (expand glob). glob expansion, fancy. 🦋
--for-times — (opt logic) for cycle (expand the specified num to a list starting from 1). count from 1. 1️⃣
--for-readline — (opt logic) for cycle (expand the specified file to a list of lines). read those lines. 📖
--endfor — (opt logic) end for cycle. close the loop. 🔚
--end-for — (opt logic) end for cycle. same. 💅
--if-opt — (opt logic) check for option. if option, then. 🤔
--if-not-opt — (opt logic) check for option. if not, then. 🙅
--if-env — (opt logic) check for environment variable. env check. 🌱
--if-not-env — (opt logic) check for environment variable. not env check. 🚫
--ifenv — (opt logic) check for environment variable. short form. ✨
--if-reload — (opt logic) check for reload. reload check. 🔄
--if-not-reload — (opt logic) check for reload. not reload check. ❌
--if-hostname — (opt logic) check for hostname. hostname? 👀
--if-not-hostname — (opt logic) check for hostname. no hostname? 🙈
--if-hostname-match — (opt logic) try to match hostname against a regular expression. regex realness. 🔍
--if-not-hostname-match — (opt logic) try to match hostname against a regular expression. not match. 🤷
--if-exists — (opt logic) check for file/directory existence. does it exist? 🤔
--if-not-exists — (opt logic) check for file/directory existence. doesn't exist. 🙅
--ifexists — (opt logic) check for file/directory existence. short. ✨
--if-plugin — (opt logic) check for plugin. plugin check. 🔌
--if-not-plugin — (opt logic) check for plugin. no plugin. 🚫
--ifplugin — (opt logic) check for plugin. short. 💅
--if-file — (opt logic) check for file existence. file? 📄
--if-not-file — (opt logic) check for file existence. no file? ❌
--if-dir — (opt logic) check for directory existence. directory? 📁
--if-not-dir — (opt logic) check for directory existence. no directory? 🚫
--ifdir — (opt logic) check for directory existence. short. ✨
--if-directory — (opt logic) check for directory existence. long. 📂
--endif — (opt logic) end if. end it. 🔚
--end-if — (opt logic) end if. same. 💅
--blacklist — set options blacklist context. blacklist mode. 🖤
--end-blacklist — clear options blacklist context. clear it. 🧼
--whitelist — set options whitelist context. whitelist mode. 🤍
--end-whitelist — clear options whitelist context. clear it. 🧼
--ignore-sigpipe — do not report (annoying) SIGPIPE. ignore the noise. 🔇
--ignore-write-errors — do not report (annoying) write()/writev() errors. ignore the mess. 🙈
--write-errors-tolerance — set the maximum number of allowed write errors (default: no tolerance). zero tolerance? yes. 🚫
--write-errors-exception-only — only raise an exception on write errors giving control to the app itself. let the app handle it. 🎮
--disable-write-exception — disable exception generation on write()/writev(). no exceptions. 🚫
--inherit — use the specified file as config template. inherit the vibe. 🧬
--include — include the specified file as immediate configuration. include it now. ⚡
--inject-before — inject a text file before the config file (advanced templating). inject before. 💉
--inject-after — inject a text file after the config file (advanced templating). inject after. 💉
-d, --daemonize — daemonize uWSGI. go live in the background. 🌙
--daemonize2 — daemonize uWSGI after app loading. wait for the app, then background. ⏳
--stop — stop an instance. stop right there. ✋
--reload — reload an instance. refresh. 🔄
--pause — pause an instance. pause. ⏸️
--suspend — suspend an instance. suspend. ⏸️
--resume — resume an instance. play. ▶️
--connect-and-read — connect to a socket and wait for data from it. connect and chill. 🔌
--extract — fetch/dump any supported address to stdout. dump it. 📤
-l, --listen — set the socket listen queue size. how many can wait in line. 🚶
-v, --max-vars — set the amount of internal iovec/vars structures. structure budget. 🏗️
--max-apps — set the maximum number of per-worker applications. app limit. 📱
-b, --buffer-size — set internal buffer size. buffer baby. 📦
-m, --memory-report — enable memory report. report that memory. 🧠
--profiler — enable the specified profiler. profile it. 📊
-c, --cgi-mode — force CGI-mode for plugins supporting it. cgi mode. 🕰️
-a, --abstract-socket — force UNIX socket in abstract mode (Linux only). abstract, but only on Linux. 🐧
-C, --chmod-socket — chmod-socket. permission slip. 🔐
-C, --chmod — chmod-socket. same. 💅
--chown-socket — chown unix sockets. change owner. 👑
--umask — set umask. mask it. 🎭
--freebind — put socket in freebind mode. freebind, free your mind. 🕊️
--map-socket — map sockets to specific workers. assign them. 🗺️
-T, --enable-threads — enable threads (stub option this is true by default). threads are on by default, but here's the flag. 🧵
--no-threads-wait — do not wait for threads cancellation on quit/reload. don't wait up. 🏃
--auto-procname — automatically set processes name to something meaningful. name drop automatically. 🏷️
--procname-prefix — add a prefix to the process names. prefix it. 🔤
--procname-prefix-spaced — add a spaced prefix to the process names. space it out. ␣
--procname-append — append a string to process names. append it. ➕
--procname — set process names. name it. 📛
--procname-master — set master process name. name the master. 👑
-i, --single-interpreter — do not use multiple interpreters (where available). one interpreter only. 1️⃣
--need-app — exit if no app can be loaded. no app? bye. 🚪
-M, --master — enable master process. master mode. 👑
--honour-stdin — do not remap stdin to /dev/null. keep stdin real. ⌨️
--emperor — run the Emperor. bow down. 👑
--emperor-proxy-socket — force the vassal to became an Emperor proxy. vassal becomes proxy. 🔄
--emperor-wrapper — set a binary wrapper for vassals. wrap it up. 🎁
--emperor-wrapper-override — set a binary wrapper for vassals to try before the default one. try this first. 🥇
--emperor-wrapper-fallback — set a binary wrapper for vassals to try as a last resort. last resort. 🆘
--emperor-nofollow — do not follow symlinks when checking for mtime. no follow. 🚫
--emperor-procname — set the Emperor process name. name the Emperor. 📛
--emperor-freq — set the Emperor scan frequency (default 3 seconds). every 3 seconds by default. ⏰
--emperor-required-heartbeat — set the Emperor tolerance about heartbeats. heartbeat tolerance. 💓
--emperor-curse-tolerance — set the Emperor tolerance about cursed vassals. cursed vassals? tolerance. 😈

to be continued, bestie... ⏭️💖

Ok so like — the emperor section continues, and bestie, it is long. Buckle up 💖

--emperor-pidfile — drops the Emperor's pid into the file you name. That's it, that's the whole job ✨
--emperor-tyrant — flips the Emperor into Tyrant mode. Yes it's called that. No we don't make the rules 👑
--emperor-tyrant-nofollow — in Tyrant mode, when it's checking uid/gid, it will not follow symlinks. Fr fr, no shortcuts through links 🙅‍♀️
--emperor-stats — runs the Emperor stats server 📊
--emperor-stats-server — also runs the Emperor stats server. Yeah, twin flags, iconic behavior 💅
--early-emperor — spawns the emperor as soon as possible, like it's got somewhere to be 🏃‍♀️
--emperor-broodlord — runs the emperor in BroodLord mode. Very scary name, very real flag 🦋
--emperor-throttle — sets the throttling level, in milliseconds, for vassals that are acting up (default 1000)
--emperor-max-throttle — sets the max throttling level, in milliseconds, for your bad-behaving vassals (default 3 minutes). They get grounded, basically 😤
--emperor-magic-exec — prefixes vassals' config files with exec:// if those files have the executable bit set. magic fr ✨
--emperor-on-demand-extension — searches for a text file (vassal name + extension) that contains the on demand socket name
--emperor-on-demand-ext — same exact energy as above: searches for a text file (vassal name + extension) holding the on demand socket name
--emperor-on-demand-directory — enables on demand mode, binding to the unix socket in the directory you give, named like the vassal + .socket
--emperor-on-demand-dir — ok the short twin again: enables on demand mode, binding to the unix socket in your specified directory, named like the vassal + .socket
--emperor-on-demand-exec — uses the output of the command you specify as the on demand socket name (the vassal name gets passed as the only argument)
--emperor-extra-extension — lets the Emperor allow the extension you name (the vassal will get called with --config)
--emperor-extra-ext — same thing, short name: allows that specified extension in the Emperor (vassal gets called with --config)
--emperor-no-blacklist — kills the Emperor blacklisting subsystem entirely 💀
--emperor-use-clone — uses clone() instead of fork(), passing along whatever unshare() flags you specify 🧬
--emperor-graceful-shutdown — makes vassals do a graceful shutdown during ragnarok. Yes, ragnarok. Periodt ⚔️
--emperor-cap — sets vassals capability
--vassals-cap — sets vassals capability (yep, same thing, different name 🫶)
--vassal-cap — sets vassals capability (third one. obsessed with redundancy tbh)
--imperial-monitor-list — lists the enabled imperial monitors 👑
--imperial-monitors-list — lists the enabled imperial monitors (the plural version, for the plural girlies)
--vassals-inherit — adds config templates to your vassals' config (it uses --inherit)
--vassals-include — includes config templates into your vassals' config (uses --include instead of --inherit)
--vassals-inherit-before — adds config templates to vassals' config (uses --inherit, and it parses before the vassal file)
--vassals-include-before — includes config templates into vassals' config (uses --include instead of --inherit, and parses before the vassal file)
--vassals-start-hook — runs the command you give before every single vassal starts 🎬
--vassals-stop-hook — runs that command after a vassal's death 💀
--vassal-sos — asks the emperor for reinforcement when it's overloaded. literally a distress signal 🆘
--vassal-sos-backlog — asks the emperor for sos if the backlog queue has more items than the value you set
--vassals-set — automatically sets the option you specify (via --set) for every vassal
--vassal-set — same, singular flavor: automatically sets the specified option (via --set) for every vassal
--heartbeat — announces healthiness to the emperor 💓
--reload-mercy — sets the maximum time, in seconds, that we wait for workers and other processes to die during reload/shutdown
--worker-reload-mercy — sets the maximum time, in seconds, a worker can take to reload/shutdown (default is 60)
--mule-reload-mercy — sets the maximum time, in seconds, a mule can take to reload/shutdown (default is 60)
--exit-on-reload — forces exit even if a reload was requested. it's leaving and it doesn't care 🚪
--die-on-term — exits instead of doing a brutal reload on SIGTERM
--force-gateway — forces the spawn of the first registered gateway without a master
-h, --help — shows this help 🫶
-h, --usage — shows this help (same flag, second name, we love a double)
--print-sym — prints the content of the binary symbol you specify
--print-symbol — prints the content of that specified binary symbol (the long-name twin)
-r, --reaper — calls waitpid(-1,...) after each request to get rid of zombies 🧟‍♀️
-R, --max-requests — reloads workers after the specified amount of managed requests
--max-requests-delta — adds (worker_id * delta) to the max_requests value of each worker
--min-worker-lifetime — 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() for avoiding duplicates
--persistent-ipcsem — does not remove ipcsem's on shutdown. they stay. forever. 💜
-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 (the reversed-name twin)
--cache — creates a shared cache containing the given elements
--cache-blocksize — sets cache blocksize
--cache-store — enables persistent cache to disk 💾
--cache-store-sync — sets the frequency of sync for the persistent cache
--cache-no-expire — disables the auto sweep of expired items
--cache-expire-freq — sets the frequency of cache sweeper scans (default 3 seconds)
--cache-report-freed-items — constantly reports the cache items freed by the sweeper
--cache-udp-server — binds the cache udp server (used only 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 entire content of another uWSGI cache server on server startup
--cache-use-last-modified — updates the last_modified_at timestamp on every cache item modification (default is disabled)
--add-cache-item — adds an item in the cache
--load-file-in-cache — loads a static file 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 (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 — chdir()s to 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 spooler frequency
--spooler-freq — sets spooler frequency (yes, the short one, we stan a nickname)
--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 (plural vibe)
--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 specified file before starting, and exits if it's locked
--flock-wait — locks the specified file before starting, and waits if it's locked
--flock2 — locks the specified file after logging/daemon setup, and exits if locked
--flock-wait2 — locks the specified file after logging/daemon setup, and waits if locked
--pidfile — creates a pidfile (before privileges drop)
--pidfile2 — creates a pidfile (after privileges drop)
--safe-pidfile — creates a safe pidfile (before privileges drop)
--safe-pidfile2 — creates a safe pidfile (after privileges drop)
--chroot — chroot()s to the specified directory
--pivot-root — pivot_root()s to the specified directories
--pivot_root — pivot_root()s to the specified directories (same flag, underscore edition)

ok bestie, heads up on the pivot ones: new_root and put_old must be separated with a space. no space, no joy 💅

--uid — setuid to the specified user/uid
--gid — setgid to the specified group/gid
--add-gid — adds the given group id to the process credentials
--immediate-uid — setuid to the specified user/uid IMMEDIATELY — capital letters are doing the emotional labor here
--immediate-gid — setgid to the specified group/gid 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 throws them into a new namespace 🌀
--unshare2 — unshare()s part of the processes and puts them in a new namespace after rootfs change
--setns-socket — exposes a unix socket that returns namespace fds from /proc/self/ns
--setns-socket-skip — skips the specified entry when sending setns file descriptors
--setns-skip — skips the specified entry when sending setns file descriptors (same rule, shorter name)
--setns — joins a namespace created by an external uWSGI instance
--setns-preopen — opens /proc/self/ns as soon as possible and caches the fds ⭐

ok and there's still more coming, don't go anywhere 💖

okay bestie we're deep in the flag forest now 🌲 these are the ones that tell uWSGI when to do the cute little things — hooks, execs, mounts, waits, calls — plus a pile of socket tuning and reload triggers. Buckle up. 🎀

--jailed — marks the instance as jailed (which forces the post_jail hooks to actually run).
--refork — does a fork() again after privileges drop. Slays for jailing systems. 🦋
--re-fork — literally the same thing as --refork: fork() again after privileges drop. Jailing systems love this one.
--refork-as-root — fork() again, but before privileges drop. Still the jailing-systems vibe.
--re-fork-as-root — yes bestie, same as --refork-as-root. fork() again before privileges drop.
--refork-post-jail — fork() again after jailing. Jailing systems, u guessed it.
--re-fork-post-jail — identical twin of --refork-post-jail. fork() again after jailing.

💅 the hook squad 💅

--hook-asap — run the specified hook as soon as possible.
--hook-pre-jail — run the specified hook before jailing.
--hook-post-jail — run the specified hook after jailing.
--hook-in-jail — run the specified hook in jail, after initialization.
--hook-as-root — run the specified hook before privileges drop.
--hook-as-user — run the specified hook after privileges drop.
--hook-as-user-atexit — run the specified hook before app exit and reload.
--hook-pre-app — run the specified hook before app loading.
--hook-post-app — run the specified hook after app loading.
--hook-post-fork — run the specified hook after each fork.
--hook-accepting — run the specified hook after each worker enters the accepting phase.
--hook-accepting1 — run the specified hook after the first worker enters the accepting phase.
--hook-accepting-once — run the specified hook after each worker enters the accepting phase, but only once per-instance.
--hook-accepting1-once — run the specified hook after the first worker enters the accepting phase, once per instance.
--hook-master-start — run the specified hook when the Master starts. 👑
--hook-touch — run the specified hook when the specified file is touched. Syntax goes like: <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 (yep, same energy as the one above).

✨ exec o'clock ✨

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

🧚 mounts & unmounts 🧚

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

⏳ waiting era ⏳

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

📞 the call squad 📞

note the exact signatures bestie, they are NOT interchangeable 💀

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

🍓 config files, but make it a buffet 🍓

--ini — load config from an ini file.
-y, --yaml — load config from a yaml file.
-y, --yml — load config from a yaml file.
-j, --json — load config from a json file.
-j, --js — load config from a json file.

🌈 instance vibes & server mode 🌈

--weight — weight of the instance (used by clustering/lb/subscriptions).
--auto-weight — set the weight of the instance automatically (used by clustering/lb/subscriptions).
--no-server — force no-server mode.
--command-mode — force command mode.

🔥 socket glow-up 🔥

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

💀 limits & reloads (the spicy part) 💀

--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 the specified megabytes.
--reload-on-rss — reload if rss memory is higher than the specified megabytes.
--evil-reload-on-as — force the master to reload a worker if its address space is higher than the specified megabytes.
--evil-reload-on-rss — force the master to reload a worker if its rss memory is higher than the 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 it and it reacts 🌸

--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 a command when the specified file is modified/touched. Syntax: file command.
--touch-signal — bestie, this one keeps an eye on a file, and the second it gets modified/touched you get a signal. Syntax is file signal, okay? Two things, in that order. 👀
--fs-reload — watches a filesystem object and does a graceful reload when it changes. chill queen behaviour, no dropped requests ✨
--fs-brutal-reload — same energy but make it feral: brutal reload the moment that filesystem object changes. no grace, all drama 💀
--fs-signal — raise a uwsgi signal when the specified filesystem object is modified. syntax: file signal. 🦋
--check-mountpoint — if a filesystem stops being reachable, this destroys the instance. sounds harsh but it's literally useful for reliable Fuse management 🫶
--mountpoint-check — obvs the same thing: destroy the instance if a filesystem is no more reachable (again: useful for reliable Fuse management). twin sister of --check-mountpoint 💅
--check-mount — yep, you guessed it — destroy the instance if a filesystem is no more reachable. useful for reliable Fuse management. third sibling 🎀
--mount-check — and the fourth: destroy the instance if a filesystem is no more reachable. useful for reliable Fuse management. the whole squad is here 🌸
--propagate-touch — ngl this is described as an over-engineering option for systems with flaky signal management. it's giving bandaid energy but ok 🩹
--limit-post — put a cap on the request body. no giant posts allowed, we're gatekeeping 🚧
--no-orphans — if master dies, the workers get automatically killed. queen. but heads up: this can be dangerous for availability 😭
--prio — set the priority of processes/threads.
--cpu-affinity — pin down that cpu affinity. main character cores only 👑
--post-buffering — set the size in bytes after which the body gets buffered to disk instead of memory. spill the tea (to disk) 💾
--post-buffering-bufsize — sets the buffer size used for read() while you're in post buffering mode.
--body-read-warning — sets how much memory allocation (in megabytes) for the request body is allowed before it starts printing a warning at you. it's the "bestie are you okay" threshold 🙈
--upload-progress — turns on creation of .json files inside the directory you specify, while a file upload is happening. watch the progress live, iconic 📊
--no-default-app — don't fall back to the default app. we're not doing backups today ✋
--manage-script-name — automatically rewrites SCRIPT_NAME and PATH_INFO for you. it handles the admin so you don't have to 💅
--ignore-script-name — just straight up ignores SCRIPT_NAME. not your business, moving on 🙈
--catch-exceptions — reports the exception as http output. and listen: the manpage says this is discouraged, use only for testing. so like, testing only fr fr 🧪
--reload-on-exception — an exception gets raised → the worker reloads. clean slate energy ✨
--reload-on-exception-type — reloads a worker when a specific exception type is raised. ✨
--reload-on-exception-value — reloads a worker when a specific exception value is raised. ✨
--reload-on-exception-repr — reloads a worker when a specific exception type+value (language-specific) is raised. the combo meal 🔥
--exception-handler — add an exception handler. you're the handler now 🫶
--enable-metrics — turns on the metrics subsystem. numbers, we love numbers 📈
--metric — add a custom metric. make it personal 💜
--metric-threshold — add a metric threshold/alarm.
--metric-alarm — add a metric threshold/alarm. same vibe, different spelling 🎀
--alarm-metric — add a metric threshold/alarm. the third twin 🌈
--metrics-dir — export metrics as text files into the directory you give it. 🗂️
--metrics-dir-restore — restore the last value taken from the metrics dir. memory queen 🧠
--metric-dir — export metrics as text files to the specified directory. (singular spelling, same job) 🗂️
--metric-dir-restore — restore the last value taken from the metrics dir. 🧠
--metrics-no-cores — disables generation of the cores-related metrics. no core metrics for you 🚫
--udp — run the udp server on the specified address.
--stats — enables the stats server on the address you give it. 📊
--stats-server — enables the stats server on the specified address. same girl, longer name 💅
--stats-http — prefixes the stats server json output with http headers. fancy it up ✨
--stats-minified — minifies the statistics json output. small and cute 🎀
--stats-min — minifies statistics json output. short name, same tiny energy 🎀
--stats-push — push the stats json straight to the destination you specify. yeet 📤
--stats-pusher-default-freq — set the default frequency of stats pushers. ⏰
--stats-pushers-default-freq — set the default frequency of stats pushers. plural version, same deal ⏰
--stats-no-cores — disable generation of cores-related stats. 🚫
--stats-no-metrics — don't include metrics in the stats output. keep it lean 💅
--multicast — subscribe to the multicast group you specify. 📡
--multicast-ttl — set the multicast ttl.
--multicast-loop — set the multicast loop (default 1).
--master-fifo — enables the master fifo. 🎛️
--notify-socket — enables the notification socket. 🔔
--subscription-notify-socket — sets the notification socket used for subscriptions. 🔔
--legion — become a member of a legion. yes like a whole squad 🤝
--legion-mcast — become a member of a legion (it's a 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. be patient bestie 🫶
--legion-death-on-lord-error — if one of the lord hooks fails, it declares itself a dead node for the number of seconds you specify. dramatic but valid 💀
--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). 💀
--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 the 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 — when using unix sockets credentials, skip the signature check for the uid you specify. 🚪
--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 subscription server you specify. 📬
--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. the glow-up version ✨
--subscribe-freq — send the subscription announce at the interval you specify. 📣
--subscription-tolerance — set the tolerance for subscription servers. 🫶
--unsubscribe-on-graceful-reload — forces the unsubscribe request even during a graceful reload. no lurking subs 💅
--start-unsubscribed — configure your subscriptions but don't actually send them (super useful with master fifo). 🎀
--subscribe-with-modifier1 — forces 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 it all 🔊
--ssl-verify-depth — set the maximum certificate verification depth. 🪜
--sni — add an SNI-governed SSL context. 🧚
--sni-dir — checks for a cert/key/client_ca file in the directory you specify, and creates a sni/ssl context on demand. iconic on-demand behaviour 👑
--sni-dir-ciphers — set the ssl ciphers for the sni-dir option. 🔐
--ssl-enable3 — enable SSLv3, which is insecure. girlypop, be careful 💀
--ssl-enable-sslv3 — enable SSLv3 (insecure). same warning, different flag name ⚠️
--ssl-enable-tlsv1 — enable TLSv1 (insecure). yeah. also insecure. we said what we said ⚠️
--ssl-option — set a raw ssl option (numeric value). 🔢
--sni-regexp — add an SNI-governed SSL context, except the key is a regexp. regex girlies rise 🌸
--ssl-tmp-dir — store the ssl-related temp files in the directory you specify. 🗃️
--check-interval — set the interval (in seconds) of master checks. ⏰
--forkbomb-delay — when a forkbomb is detected, sleep for the number of seconds you specify. nap time 😴
--binary-path — force the binary path. 📍
--privileged-binary-patch — patch the uwsgi binary with a new command (before the privileges drop). 🔧
--unprivileged-binary-patch — patch the uwsgi binary with a new command (after the 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. heads up: requires root privileges 👑
--logto — set the logfile/udp address. 📝
--logto2 — log to the file or udp address you specify, but after the privileges drop. 📝
--log-format — set an advanced format for request logging. 🎨
--logformat — set advanced format for request logging. same thing, one less dash 🎨
--logformat-strftime — apply strftime to the logformat output. time stuff, cute 🕰️
--log-format-strftime — apply strftime to logformat output. 🕰️
--logfile-chown — chown the logfiles. 👑
--logfile-chmod — chmod the 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. 🗒️
--logger — set/append a logger. 🗒️
--logger-list — list the enabled loggers. 📋
--loggers-list — list enabled loggers. 📋
--threaded-logger — offloads the log writing to a thread. multitasking queen 💅
--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 do not show) log lines that match the regexp you specify. bye 👋
--log-filter — show only the log lines matching the regexp you specify. picky and valid 🎀
--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 — calls abort() on segfault/fpe, which could be useful for generating a core dump. ⚠️
--alarm — create a new alarm. syntax: <alarm> <plugin:args>. ⏰

okay bestie, still in OPTIONS, still slaying 💅 this next batch is the alarm-core / logging / routing-industrial-complex era of the config file. hydrate. 🍓

🔔 alarm core 🎀

--alarm-cheap — use the main alarm thread instead of creating dedicated threads for the curl-based alarms. yes queen, reuse the thread, be economical ✨
--alarm-freq — tune the anti-loop alarm system. the default is 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 — raise the specified alarm when the segmentation fault handler is executed 💀
--segfault-alarm — raise the specified alarm when the segmentation fault handler is executed. (same energy, different spelling, we don't judge 🫶)
--alarm-backlog — raise the specified alarm when the socket backlog queue is full.
--backlog-alarm — raise the specified alarm when the socket backlog queue is full.
--lq-alarm — raise the specified alarm when the socket backlog queue is full.
--alarm-lq — raise the specified alarm when the socket backlog queue is full.
--alarm-listen-queue — raise the specified alarm when the socket backlog queue is full.
--listen-queue-alarm — raise the specified alarm when the socket backlog queue is full. (six names, one behaviour, that's just how the backlog queue do 😭)
--log-alarm — raise the specified alarm when a log line matches the specified regexp. syntax: <alarm>[,alarm...] <regexp>
--alarm-log — raise the specified alarm when a log line matches the specified regexp. syntax: <alarm>[,alarm...] <regexp>
--not-log-alarm — skip the specified alarm when a log line matches the specified regexp. syntax: <alarm>[,alarm...] <regexp>
--not-alarm-log — skip the specified alarm when a log line matches the specified regexp. syntax: <alarm>[,alarm...] <regexp>
--alarm-list — list enabled alarms 👑
--alarms-list — list enabled alarms
--alarm-msg-size — set the max size of an alarm message. default is 8192.

📝 logging era 🌸

--log-master — delegate logging to the master process.
--log-master-bufsize — set the buffer size for the master logger. bigger log messages will be truncated, so watch that.
--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. the glow-up after the chop ✨
--logdate — prefix logs with date or a strftime string.
--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. precision girlie 💅
--log-x-forwarded-for — use the ip from X-Forwarded-For header instead of REMOTE_ADDR.

🧚 master, privileges, working dir 🌈

--master-as-root — leave master process running as root. (yes it says what you think it says 🫣)
--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 / cheap / cheaper girlies 💤

--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 — 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 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 + threads ⭐

--mount — load application under mountpoint.
--worker-mount — load application under mountpoint in the specified worker or after workers spawn.
--threads — run each worker in prethreaded mode with the specified number of threads.
--thread-stacksize — set threads stacksize.
--threads-stacksize — set threads stacksize.
--thread-stack-size — set threads stacksize.
--threads-stack-size — set threads stacksize. (four spellings, one stack, iconic 😌)

💜 vhost 🌐

--vhost — enable virtualhosting mode (based on SERVER_NAME variable).
--vhost-host — enable virtualhosting mode (based on HTTP_HOST variable).

🦋 ROUTING — main character section, pay attention 🫶

this is where uWSGI stops being a server and starts being a matchmaker. every --route* needs a route 💖

--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 routes 🚪

these run last, periodt.

--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 routes 💀

for when things go sideways and we still want to be elegant about it.

--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 routes 🌸

--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 — list enabled routers ✨
--routers-list — list enabled routers

🎀 error pages, websockets, chunked input 🎀

--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 — 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 websockets ping/pong subsystem.
--websocket-pong-tolerance — set the tolerance (in seconds) of 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 default timeout for chunked input.

⏰ clocks 🕰️

--clock — set a clock source.
--clock-list — list enabled clocks. 🕐🕑🕒
--clocks-list — bestie, this just lists all the enabled clocks ✨ like a lil roster of every clock that's switched on rn.
--add-header — sprinkles HTTP headers onto the response for you, automatically 💅 no manual labour.
--rem-header — yeets the specified HTTP header out of the response, automatic mode 🫶 that header is gone.
--del-header — literally the same vibe as --rem-header: it automatically removes the specified HTTP header from the response.
--collect-header — stashes the specified response header into a request var 🎀 syntax goes like header var.
--response-header-collect — same energy bestie: stores the specified response header in a request var (syntax: header var).
--pull-header — stores the specified response header in a request var and rips it out of the response, like it never happened 🙈 syntax: header var.
--check-static — goes looking for static files in the directory you point at 👀.
--check-static-docroot — checks for static files inside the requested DOCUMENT_ROOT 🌸.
--static-check — yep, checking for static files in the specified directory, iconic behaviour.
--static-map — maps a mountpoint onto a static directory (or a file) 🗺️✨.
--static-map2 — like --static-map but it completely appends the requested resource to the docroot, no half measures 🔥.
--static-skip-ext — tells staticfile checks to skip the specified extension, bye bye 💀.
--static-index — if someone requests a directory, this hunts down the specified file instead 🦋.
--static-safe — if the file lives under the specified path, it skips the security checks 🙈.
--static-cache-paths — drops resolved paths into the uWSGI cache for however many seconds you say ⏱️.
--static-cache-paths-name — uses the cache you specify for static paths, main character choice 👑.
--mimefile — sets the mime types file path (default /etc/mime.types) 📄.
--mime-file — identical twin fr fr: sets the mime types file path (default /etc/mime.types).
--static-expires-type — sets the Expires header based on content type ✨.
--static-expires-type-mtime — sets the Expires header based on content type and file mtime 🕰️.
--static-expires — sets the Expires header based on 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 your supplied regexp matches the static file translation, it goes hunting for a gzip version 🗜️✨.
--static-gzip-all — checks for a gzip version of, like, all the requested static files, no skips.
--static-gzip-dir — checks for a gzip version of all requested static files in the specified dir/prefix 📁.
--static-gzip-prefix — same deal bestie: checks for a gzip version of all requested static files in the specified dir/prefix.
--static-gzip-ext — checks for a gzip version of all requested static files with the specified ext/suffix 🎀.
--static-gzip-suffix — yep, checks for a gzip version of all requested static files with the specified ext/suffix.
--honour-range — switches on support for the HTTP Range header 💅 respect the range.
--offload-threads — sets how many offload threads to spawn (per-worker, default 0) 🧵.
--offload-thread — same thing, singular swag: sets the 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, twin energy.
--disable-sendfile — turns off sendfile() and makes it rely on boring old read()/write() 😴.
--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).
--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 ⚡ no waiting around.
--unenv — unsets an environment variable, poof gone 💨.
--vacuum — tries to remove all of the generated file/sockets 🧹 spring cleaning.
--file-write — writes the specified content to the specified file (syntax: file=value) before privileges drop 🔐.
--cgroup — puts the processes into 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 inside your namespace 📌.
--ns — runs in a new namespace under the specified rootfs (same as --namespace, cute short nickname).
--namespace-net — adds a network namespace 🌐.
--ns-net — adds a network namespace, the short-name twin.
--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 — enables the TCP_FASTOPEN flag on TCP sockets with the specified qlen value.
--tcp-fast-open-client — uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if it's supported 🚀.
--tcp-fastopen-client — same: uses sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported.
--zerg — attaches to a zerg server 👾.
--zerg-fallback — falls back to normal sockets if the zerg server isn't available 🛟.
--zerg-server — enables the zerg server on the specified UNIX socket 🔌.
--cron — adds a cron task ⏰.
--cron2 — adds a cron task, key=val syntax flavour 🗝️.
--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 ⏳.
--legion-cron — adds a cron task that only runs when the instance is a lord of the specified legion 👑.
--cron-legion — adds a cron task runnable only when the instance is a lord of the specified legion.
--unique-legion-cron — adds a unique cron task runnable only when the instance is a lord of the specified legion 💜.
--unique-cron-legion — adds a unique cron task runnable only when the instance is a lord of the specified legion.
--loop — selects the uWSGI loop engine 🔄.
--loop-list — lists the enabled loop engines 📋.
--loops-list — lists the enabled loop engines (same vibe, plural).
--worker-exec — runs the specified command 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 💀 ride or die.
--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 a legion lord node 👑.
--legion-smart-attach-daemon — same as --smart-attach-daemon but the daemon runs only on a legion lord node.
--legion-smart-attach-daemon2 — same as --smart-attach-daemon2 but the daemon runs only on a legion lord node.
--daemons-honour-stdin — do 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 edition).
--need-plugins — loads uWSGI plugins and exits on error 🚨.
--need-plugin — loads uWSGI plugins, exit on error, singular.
--plugins-dir — adds a directory to the uWSGI plugin search path 🗂️.
--plugin-dir — adds a directory to the uWSGI plugin search path, twin.
--plugins-list — lists the enabled plugins 📜.
--plugin-list — lists the enabled plugins, same.
--autoload — tries to automatically load plugins when it finds unknown options 🪄.
--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, 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 page, bestie 😭💖 this was uwsgi_sqlite3, version 2.0.31-debian, dated July 2026 — and yes that's the UWSGI_SQLITE3(1) manual you just devoured top to bottom. Go forth and configure, you absolute queen 👑✨

📦 where this page comes from

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