BALBOA-SERVE(1)

📦
version 2.1.2 · 5 versions
, in ubuntu resolute, ubuntu stonking

✨ BALBOA-SERVE — the one and only, section 1 of the manual bestie ✨

okay so listen, this is balboa-serve from the <pink>BALBOA-SERVE(1)</pink> manual — yes the title is literally the same as the name, that's just how manpages do, it's giving mirror selfie 💅 anyway. sit down, grab a boba, we're learning a command.

🌸 NAME 🌸

balboa-serve — run the balboa frontend 🫶

🦋 SYNOPSIS 🦋

balboa serve [flags]

that's it. that's the whole vibe. balboa serve plus whatever flags you're feeling today ✨

💖 DESCRIPTION 💖

This command starts the balboa frontend. it's the main character fr fr — it accepts submissions and it answers queries. that's the job. no cap.

🎀 OPTIONS 🎀

so many little knobs and dials, we love options, options are self-care 🧚

  • -b, --backend="backend.yaml" — the backend configuration file. default path is literally backend.yaml, like, it's right there in your folder bestie 🌸
  • -f, --feeders="feeders.yaml" — the feeders configuration file. defaults to feeders.yaml 💜
  • -h, --help[=false] — help for serve. [=false] means it starts out off, so you gotta actually ask for it 😭
  • -l, --logfile="/var/log/balboa.log" — where the log file lives. default is /var/log/balboa.log, so heads up, that's a system directory, mind your permissions 👑
  • -j, --logjson[=true] — output the log file as JSON. note the [=true] — this one's already on by default, so it's an opt-out situation 🫶
  • -p, --port=8080 — port for the GraphQL server. default 8080 ⭐
  • -r, --rest-port=8088 — port for the REST server. default 8088, yes it's different from 8080, they're two separate servers living their two separate lives 💅
  • -s, --selectors="selectors.yaml" — the selectors configuration file. defaults to selectors.yaml 🌈
  • -v, --verbose[=false] — verbose mode. starts off ([=false]), turn it on when you want the tea ☕
not me reminding you that -b, -f and -s all default to bare filenames with no directory — so they're resolved relative to wherever you are when you run this. slay responsibly 🙈

🔥 SEE ALSO 🔥

  • balboa(1) — go read the parent page, it's the origin story fr

that's the whole page bestie, you ate it 💖 this was balboa-serve from the <pink>BALBOA-SERVE(1)</pink> manual, and the little signature at the bottom of the original says Mar 2026 — so yeah, dated March 2026, periodt. go run your frontend, you got this 👑✨

📦 where this page comes from