GUNICORNC(1)

📦
version 25.3.0 · 2 versions
, in ubuntu stonking

✨ GUNICORNC(1) ✨

okay so bestie, welcome to the gunicornc manual page — that's the gunicorn control client, section 1 (User Commands), and honestly? she's giving main character energy and we're about to learn her whole lore 💅

🦋 NAME 🦋

gunicornc — literally just the gunicorn control client, no cap

🌸 DESCRIPTION 🌸

here's the vibe check, the whole usage in one little line:

usage: gunicornc [-h] [-s SOCKET] [-c COMMAND] [-j] [-v]

periodt. that's the shape of it. and what IS it? it's the Gunicorn control interface. that's the whole pitch 🫶

🎀 options: 🎀

these are the little flags you can sprinkle on top, and bestie there are five of them, so let's go one by one:

  • -h, --help — shows this help message and then dips out. iconic behaviour, truly.
  • -s, --socket SOCKET — the control socket path. default? it's auto-detected, based on XDG_RUNTIME_DIR or ~/.gunicorn/. so if you don't say anything she figures it out herself, queen of independence 💖
  • -c, --command COMMAND — run ONE single command and then exit. one and done. no interactive hangout, just business.
  • -j, --json — spit out raw JSON. this one's for the scripting girlies, the automation girlies, the "i'm piping this into something else" girlies 🌈
  • -v, --version — show the version and exit. short, sweet, informative ✨

💜 EXAMPLES 💜

okay this is the part where it gets FUN, because seeing it in action is everything. here's every single one, exactly as written:

gunicornc

Interactive mode (default socket)

gunicornc -s /tmp/myapp.ctl

Interactive mode with custom socket

gunicornc -c "show workers"

Single command mode

gunicornc -c "worker add 2"

Add 2 workers

gunicornc -c "show stats" -j

Output stats as JSON

see how clean that is?? interactive when you want to hang out, single-command when you're in a rush, JSON when you're being a little automation gremlin 🧚 obsessed, frankly.

🦋 SEE ALSO 🦋

bestie, important heads up: the FULL documentation for gunicornc lives in a Texinfo manual. so if the info and gunicornc programs are properly installed at your site, running this:
info gunicornc

should give you access to the complete manual. that's where the deep lore is, iykyk 💀✨

and that's the whole page, babe 🌸 this was gunicornc from gunicorn 25.3.0, dated June 2026 👑 go forth and control your workers, you absolute legend 💅💖

📦 where this page comes from