LAMINARD(8)

πŸ’… laminard β€” the Laminar CI server, bestie

okay so you found the man page for laminard, aka the whole Laminar CI server situation. this is section 8, she's a system/admin girly. sit down, grab a strawberry πŸ“, we're doing this.


✨ SYNOPSIS ✨

laminard [-v]

that's it. that's the whole vibe. one optional flag. iconic behaviour honestly.


🌸 DESCRIPTION 🌸

So. You run laminard and it starts the Laminar CI server in the foreground β€” like, it stays right there in your terminal, main character energy, no backgrounding, no daemon vanishing act. πŸ‘‘

If you pass -v, you get verbose logging turned on, which means it will tell you everything, no cap. it's giving "she's oversharing and we love that". πŸ’–

And literally everything else about how it behaves? Not flags. Not options. It's all environment variables, babe. Scroll down, we have a whole list. πŸ¦‹


πŸŽ€ ENVIRONMENT πŸŽ€

these are the knobs you turn. all of them. every single one.

  • LAMINAR_HOME β€” the root location where all the laminar stuff lives: configuration, the database, build workspaces and the archive. basically her whole bedroom. 🌈
    • Default: /var/lib/laminar
  • LAMINAR_BIND_HTTP β€” the interface laminard binds to so it can serve up the Web UI. it can take the form IP:PORT, unix:PATH/TO/SOCKET or unix-abstract:NAME. pick your fighter πŸ’…
    • Default: *:8080
  • LAMINAR_BIND_HRPC β€” the interface laminard binds to so it can accept RPC from laminarc. same shapes as above: IP:PORT, unix:PATH/TO/SOCKET or unix-abstract:NAME. 🫢
    • Default: unix-abstract:laminar
  • LAMINAR_TITLE β€” the page title that shows up in the web frontend. name your baby. ✨
  • LAMINAR_KEEP_RUNDIRS β€” set this and laminar stops immediately deleting job rundirs like $LAMINAR_HOME/run/$JOB/$RUN. the value should be an integer representing the number of rundirs to keep. she's a hoarder now, respectfully. πŸ—‚οΈ
    • Default: 0
  • LAMINAR_ARCHIVE_URL β€” the base url used to request artifacts. real talk: Laminar can serve build artifacts, and it absolutely will if you leave this unset β€” but the method it uses is very naive and inefficient. 😭 bestie, let a real webserver handle serving those requests. do yourself a favour. πŸ™ˆ

🧚 FILES 🧚

  • /etc/laminar.conf β€” variable assignments in this file get exported by systemd or whatever other init system you're running, before it launches the system-wide installation of Laminar. so this is where you set the vibes globally. 🌸

πŸ‘‘ AUTHORS πŸ‘‘

  • Oliver Giles created Laminar CI. the founder. the blueprint. 🫑
  • Dmitry Bogatov created this manual page for the Debian project β€” but it can be used by others too, she's generous like that. πŸ’œ

fr fr, that's the whole page. nothing skipped, nothing invented. go build something, bestie. πŸ”₯

this cutie was written down as Apr 03, 2019, and it's filed under LAMINARD(1) in the sources β€” yeah we know, section 8 header but a (1) footer, she contains multitudes. anyway. mwah. πŸ’…

πŸ“¦ where this page comes from