stargazer(1)

🦋 NAME 🦋

okay so welcome to the stargazer(1) manual, bestie 💖. stargazer is a gemini server. that’s the whole vibe: literally a gemini server. slay.

✨ SYNOPSIS ✨

stargazer [-d] [-D] path

🎀 ARGS 🎀

• path — specifies an alternate path to read the config file from. periodt.

💅 OPTIONS 💅

• -D, --debug — turns on debug logging. this logs a lot more information about the server’s operation, which is super useful for debugging problems. it’s more verbose than you’d likely want for normal operation, ngl.
• -d, --dev — starts the server in dev mode. server will serve files from the current directory over localhost:1965. this overrides the config file and the -C option.
• --check-config — checks for config errors and exits.
• -V, --version — prints the program version and exits.
• -h, --help — prints command line argument help.

🌈 LOGGING 🌈

okay so logging is a whole thing. server errors and other debugging info get printed to stderr in an unspecified format. client request logging gets printed to stdout, with each of these fields in order, separated by a tab character:

• Service time in RFC 3339 format
• Client IP
• Request hostname
• Request path
• Response body size in bytes
• Response status
• Response meta

🫶 SEE ALSO 🫶

stargazer.ini(5) for configuration instructions. iykyk ✨

👑 AUTHORS 👑

maintained by Sashanoraa <sasha@noraa.gay> 💜. up-to-date sources can be found at https://sr.ht/~zethra/stargazer/ and bugs/patches can be submitted by email to ~zethra/public-inbox@lists.sr.ht with the prefix stargazer.

---

mwah 💋 this is stargazer(1) from the General Commands Manual, dated 2025-11-02 — go be iconic with your gemini server, bestie 🌟💅